Objeto de Dados CalloutAdExtension – Gestão de Campanhas

Artigo
11/13/2024

Define um objeto que especifica texto adicional sobre a sua empresa, produtos ou serviços a incluir num anúncio de texto.

Pode associar uma extensão de anúncio de aplicação à conta ou a campanhas e grupos de anúncios na conta. Tem de associar entre 2 e 20 extensões de aviso por entidade (conta, campanha ou grupo de anúncios). Se associar uma ou menos extensões de nota de aviso à sua conta, campanha ou grupo de anúncios, nenhum texto de nota de aviso será fornecido com o seu anúncio. Um anúncio pode incluir entre 2 a 4 notas de aviso por impressão.

As extensões de anúncios associadas ao nível do grupo de anúncios substituirão as extensões de anúncios do mesmo tipo que estão associadas ao nível da campanha. Por exemplo, se tiver 2 extensões de nota de aviso definidas para a Campanha A, zero extensões de nota de aviso associadas ao Grupo AD AA e uma extensão de nota de aviso associada ao Ad Group AB, apenas o AA do Grupo de Anúncios é elegível para ter os anúncios de texto decorados com notas de aviso.

<xs:complexType name="CalloutAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "DevicePreference": "LongValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Scheduling": {
    "DayTimeRanges": [
      {
        "Day": "ValueHere",
        "EndHour": IntValueHere,
        "EndMinute": "ValueHere",
        "StartHour": IntValueHere,
        "StartMinute": "ValueHere"
      }
    ],
    "EndDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "StartDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "UseSearcherTimeZone": "ValueHere"
  },
  "Status": "ValueHere",
  "Type": "CalloutAdExtension",
  "Version": IntValueHere,
  "Text": "ValueHere"
}

Elementos

O objeto CalloutAdExtension tem os seguintes elementos: Texto.

Elemento	Descrição	Tipo de Dados
Text	Texto de nota de aviso adicional sobre a sua empresa, produtos ou serviços a incluir num anúncio de texto. O texto da extensão de nota de aviso tem de ser diferente do texto do seu anúncio. O comprimento desta cadeia tem de ter entre 1 e 25 carateres. Tenha em atenção que, para os carateres chineses tradicionais, o comprimento desta cadeia tem de ter entre 1 e 12 carateres. Adicionar: Necessário Atualização: Necessário	cadeia

O objeto CalloutAdExtension tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do AdExtension

O objeto CalloutAdExtension 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 CalloutAdExtension 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.	Longo
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	Longo
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 é CalloutAdExtension quando obtém uma extensão de anúncio de nota de aviso. 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