Objeto de Dados AdExtension – Gestão de Campanhas

Artigo
11/13/2024

Define o objeto base de uma extensão de anúncio.

Não tente instanciar um AdExtension. Pode criar um ou mais dos seguintes objetos que derivam do mesmo.

Sintaxe

<xs:complexType name="AdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element xmlns:q43="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q43:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Scheduling" nillable="true" type="tns:Schedule" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdExtensionStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Version" nillable="true" type="xs:int" />
  </xs:sequence>
</xs:complexType>

Elementos

O objeto AdExtension tem os seguintes elementos: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version.

Elemento	Descrição	Tipo de Dados
DevicePreference	Este elemento determina se a preferência é que a extensão de anúncios seja apresentada em dispositivos móveis ou em todos os dispositivos. Para especificar uma preferência para dispositivos móveis, defina este elemento como 30001. Para especificar todos os dispositivos, defina este elemento como 0 (zero) ou deixe o elemento nulo. Por predefinição, este elemento será nulo. Este elemento só é aplicável aos tipos AppAdExtension e SitelinkAdExtension .	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. As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para este objeto.	Matriz KeyValuePairOfstringstring
ID	O identificador exclusivo do Microsoft Advertising da extensão de anúncios.	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.	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.	AdExtensionStatus
Tipo	O tipo de extensão de anúncio. Para obter mais informações, veja Observações.	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.	int

Observações

Se gerar o SOAP manualmente, utilize o atributo type do <AdExtension> nó, conforme mostrado no exemplo seguinte, para especificar o tipo de extensão de anúncio.

<AdExtension i:type="ReviewAdExtension" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id i:nil="true" />
    <Status i:nil="true" />
      . . .
</AdExtension>

Requisitos

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

Utilizado Por

AddAdExtensions
AdExtensionAssociation
GetAdExtensionsByIds
UpdateAdExtensions

Partilhar via