Objeto de Dados CallAdExtension – Gestão de Campanhas

Artigo
12/21/2023

Define um objeto que especifica um número de telefone de clique para chamada a incluir num anúncio de texto.

Pode associar uma extensão de anúncio de chamada a campanhas na conta. Cada entidade (campanha) pode ser associada a uma extensão de anúncio de chamada.

Sintaxe

<xs:complexType name="CallAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="CountryCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="IsCallOnly" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="IsCallTrackingEnabled" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="RequireTollFreeTrackingNumber" nillable="true" type="xs:boolean" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto CallAdExtension tem os seguintes elementos: CountryCode, IsCallOnly, IsCallTrackingEnabled, PhoneNumber, RequireTollFreeTrackingNumber.

Elemento	Descrição	Tipo de Dados
CountryCode	O indicativo do país/região onde o número de telefone está registado. O código de país tem de conter um código de país de 2 carateres. 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	cadeia
IsCallOnly	A opção para mostrar o seu número de telefone e site, ou apenas o seu número de telefone, às pessoas que veem os seus anúncios num smartphone. Poderá querer mostrar apenas o seu número de telefone se a sua empresa exigir que fale com cada cliente. Defina esta propriedade como verdadeira se pretender que a extensão de anúncio mostre apenas o número de telefone sem uma ligação para o seu site e, caso contrário, se quiser que a extensão de anúncio inclua uma ligação para o seu site, além do número de telefone defini-lo como falso. Adicionar: Opcional. Se não especificar este elemento ou o deixar vazio, o valor predefinido de falso será definido e a extensão de anúncio incluirá uma ligação para o seu site, além do número de telefone. Atualização: Opcional	booleano
IsCallTrackingEnabled	Determina se o controlo de chamadas está ativado para a extensão de anúncio de chamada. O controlo de chamadas só é suportado no Estados Unidos e no Reino Unido. Defina esta propriedade como true para ativar o controlo de chamadas e, caso contrário, defina-a como falsa. Adicionar: Opcional. Se não especificar este elemento ou o deixar vazio, o valor predefinido de falso será definido. Atualização: Opcional	booleano
Número de Telefone	O número de telefone clicável a incluir no anúncio. 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 incluir extensões de anúncios de chamada e localização, este número de telefone substituirá o número de telefone especificado nas extensões de anúncios de localização. Tenha em atenção que o número de telefone pode ser reformatado. Por exemplo, se definir o número de telefone para 4255551212, este será reformatado para (425) 555-1212. Adicionar: Necessário Atualização: Necessário	cadeia
RequireTollFreeTrackingNumber	Pode utilizar o seu próprio número de telefone ou utilizar um número de telefone de reencaminhamento do Microsoft Advertising. Um número de telefone de reencaminhamento do Microsoft Advertising é um número de telefone exclusivo que é encaminhado para o seu número de telefone da empresa. Com um número de reencaminhamento do Microsoft Advertising, pode controlar todas as chamadas do seu anúncio para que possa analisar o desempenho do anúncio. Este elemento determina se deve ser criado um número de telefone de reencaminhamento gratuito do Microsoft Advertising para controlo de chamadas. Este elemento só pode ser definido se IsCallTrackingEnabled também for verdadeiro. Antes de agosto de 2017, os clientes podiam definir esta propriedade como verdadeira se um número de telefone de reencaminhamento do Microsoft Advertising fosse criado para controlo de chamadas. Desde agosto de 2017 que os clientes já não podem criar um novo número de telefone de reencaminhamento gratuito do Microsoft Advertising. Se definir este valor como verdadeiro , a operação será bem-sucedida; no entanto, não será criado um número gratuito e, quando obter a extensão de anúncio de chamada, esta propriedade será definida como falsa. Se um número de reencaminhamento gratuito tiver sido aprovisionado antes de agosto de 2017, esta propriedade será verdadeira se o número ainda estiver ativo quando recuperar a extensão de anúncio de chamada. Adicionar: Opcional. Se não especificar este elemento ou o deixar vazio, o valor predefinido de falso será definido. Atualização: Opcional	booleano

O objeto CallAdExtension tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do AdExtension

O objeto CallAdExtension 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 CallAdExtension 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 é CallAdExtension quando obtém uma extensão de anúncio de chamada. 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

Partilhar via