Objeto de Dados LocationAdExtension - Gestão de Campanhas

Artigo
07/19/2024

Define uma extensão de anúncio que especifica um endereço de negócio e número de telefone a incluir num anúncio de texto.

Pode associar uma extensão de anúncio de localização à conta ou a campanhas na conta. Cada entidade (conta ou campanha) pode ser associada ao número de extensões de anúncios de localização que decidir, até ao número total de extensões de anúncios de localização na sua conta.

Sintaxe

<xs:complexType name="LocationAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Address" nillable="true" type="tns:Address" />
        <xs:element minOccurs="0" name="CompanyName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="GeoCodeStatus" nillable="true" type="tns:BusinessGeoCodeStatus" />
        <xs:element minOccurs="0" name="GeoPoint" nillable="true" type="tns:GeoPoint" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto LocationAdExtension tem os seguintes elementos: Address, CompanyName, GeoCodeStatus, GeoPoint, PhoneNumber.

Elemento	Descrição	Tipo de Dados
Endereço	O endereço da empresa. Os valores de código de país/região suportados incluem AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE e VN. Adicionar: Necessário Atualização: Necessário	Address
NomedaEmpresa	O nome da empresa. O nome pode conter um máximo de 80 carateres. Adicionar: Necessário Atualização: Necessário	cadeia
GeoCodeStatus	Um valor de estado que indica se as coordenadas de latitude e longitude da empresa foram determinadas. Se fornecer as coordenadas, o estado será definido como Concluído; caso contrário, o estado indicará o progresso da determinação das coordenadas do endereço empresarial especificado. Adicionar: Não permitido Atualização: Não permitido	BusinessGeoCodeStatus
GeoPoint	As coordenadas de latitude e longitude do elemento Address especificado. As coordenadas são utilizadas para marcar a localização empresarial no Mapas Bing quando o utilizador clica no endereço no anúncio. Se as coordenadas especificadas não estiverem dentro do intervalo de valores válidos, o serviço determina as coordenadas com base no endereço. Se especificar as coordenadas conhecidas, o serviço não confirma se as coordenadas especificadas correspondem ao endereço empresarial especificado. Se não fornecer as coordenadas, a operação AddAdExtensions utiliza o endereço empresarial para determinar as coordenadas. Ao adicionar mais de 10 extensões de anúncios de localização, o serviço resolve coordenadas offline e resolve coordenadas antecipadamente durante a execução da operação de serviço. A localização não será utilizada num anúncio até que as coordenadas sejam determinadas, o que pode demorar de segundos a minutos, consoante o número de extensões de anúncios de localização que estão a ser adicionadas e a procura atual. Para determinar se as coordenadas foram resolvidas, chame a operação GetAdExtensionsByIds e aceda ao elemento GeoCodeStatus . Para obter uma lista dos valores de estado possíveis, veja BusinessGeoCodeStatus. Adicionar: Opcional Atualização: Opcional	GeoPoint
Número de Telefone	O número de telefone da empresa a incluir no anúncio. O número de telefone é clicável em dispositivos móveis hi-fi. O número de telefone pode conter um máximo de 35 carateres e tem de ser válido para o país ou região especificado. Se a campanha também incluir uma extensão de chamada, o número de telefone na extensão da chamada substituirá este número de telefone. Adicionar: Opcional Atualização: Opcional. Se definir este elemento como nulo, a definição anterior será eliminada.	cadeia

O objeto LocationAdExtension tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do AdExtension

O objeto LocationAdExtension deriva do objeto AdExtension e herda os seguintes elementos: DevicePreference, ForwardCompatibilityMap, ID, Scheduling, Status, Type, Version. As descrições abaixo são específicas de LocationAdExtension e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto AdExtension .

Elemento	Descrição	Tipo de Dados
DevicePreference	Não é suportado para este tipo de extensão de anúncio.	long
ForwardCompatibilityMap	A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API. Atualmente, não existem alterações de compatibilidade para o objeto AdExtension . Adicionar: Só de leitura Atualização: Só de leitura	Matriz KeyValuePairOfstringstring
ID	O identificador exclusivo do Microsoft Advertising da extensão de anúncios. Adicionar: Só de leitura Atualização: Só de leitura e Obrigatório	long
Agendamento	Determina os intervalos de dia e hora do calendário quando a extensão de anúncios é elegível para ser apresentada em anúncios. Adicionar: Opcional Atualização: Opcional. Se definir este elemento como nulo, qualquer conjunto de agendamento existente para a extensão de anúncio permanecerá inalterado. Se definir esta opção para qualquer objeto Schedule não nulo, está efetivamente a substituir as definições de agendamento existentes para a extensão de anúncios. Para remover todo o agendamento, defina este elemento para um objeto Schedule vazio.	Agenda
Estado	O estado da extensão de anúncios. O valor será sempre Ativo porque o serviço Gestão de Campanhas não devolve extensões de anúncios eliminadas. Adicionar: Só de leitura Atualização: Só de leitura	AdExtensionStatus
Tipo	O tipo da extensão de anúncios. Este valor é LocationAdExtension quando obtém uma extensão de anúncio de localização. Adicionar: Só de leitura Atualização: Só de leitura Para obter mais informações sobre os tipos de extensão de anúncios, veja Comentários sobre Objetos de Dados da Extensão do Ad.	cadeia
Versão	Monitoriza o número de vezes que a extensão de anúncios foi atualizada. A versão é definida como 1 quando a extensão de anúncio é criada e incrementa um após cada atualização. Adicionar: Não permitido Atualização: Não permitido	int

Requisitos

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13

Compartilhar via