Objeto de Dados do Ad - Gestão de Campanhas

Artigo
12/21/2023

Define o objeto base de um anúncio.

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

Sintaxe

<xs:complexType name="Ad" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdFormatPreference" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q1:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q2="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q2:ArrayOfstring" />
    <xs:element xmlns:q3="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q3:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdStatus" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:AdType" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
  </xs:sequence>
</xs:complexType>

Elementos

O objeto Ad tem os seguintes elementos: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters.

Elemento	Descrição	Tipo de Dados
AdFormatPreference	A Preferência de Formato de Anúncio é utilizada para indicar se prefere ou não que a cópia de anúncio seja apresentada aos utilizadores como um anúncio de pesquisa ou audiência. Os anúncios de pesquisa tendem a ser escritos como uma chamada à ação, enquanto os anúncios de audiência devem ser escritos num estilo mais informativo. Embora tenha a opção de utilizar anúncios de pesquisa como anúncios de audiência, designar um anúncio como formato preferencial de anúncios de Audiência permite-lhe otimizar as mensagens para entrega nativa. Os valores possíveis são AudienceAd e All. Se estiver definido como Tudo, o anúncio será elegível para os formatos de anúncio de pesquisa e audiência. Se estiver definido como AudienceAd, o anúncio só será elegível para o formato de anúncio da audiência. A Preferência de Formato de Anúncio só é suportada para objetos ExpandedTextAd e TextAd .	cadeia
DevicePreference	Determina a preferência do dispositivo para mostrar o anúncio. A preferência do dispositivo só é suportada para objetos AppInstallAd e TextAd .	long
EditorialStatus	O estado de revisão editorial do anúncio, que indica se o anúncio está pendente de revisão, foi aprovado ou foi desaprovado.	AdEditorialStatus
FinalAppUrls	Reservado para utilização futura.	Matriz appUrl
FinalMobileUrls	O URL da página de destino móvel. Este elemento só é suportado para objetos ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd e TextAd . Não é suportado com os objetos AppInstallAd, DynamicSearchAd e ProductAd .	matriz de cadeia
FinalUrls	O último ou último URL em que um utilizador é colocado, quer o caminho clique ou não para o URL final tenha incluído redirecionamentos. Este elemento só é suportado para objetos AppInstallAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd e TextAd . Não é suportado com os objetos DynamicSearchAd e ProductAd .	matriz de cadeia
FinalUrlSuffix	O sufixo de URL final pode incluir parâmetros de controlo que serão anexados ao final do URL da página de destino. Recomendamos que coloque os parâmetros de controlo de que a página de destino necessita num sufixo de URL final para que os seus clientes sejam sempre enviados para a sua página de destino. Para obter mais detalhes e regras de validação, veja Sufixo de URL Final nos guias técnicos. Este elemento só é suportado para objetos AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd e ResponsiveSearchAd . Não é suportado com os objetos ProductAd e TextAd .	cadeia
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 para o anúncio.	long
Estado	O estado do anúncio. Pode definir o estado do anúncio como Ativo ou Em Pausa.	AdStatus
TrackingUrlTemplate	O modelo de controlo a utilizar como predefinição para todos os URLs de página de destino. Este elemento só é suportado para objetos AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd e TextAd . Não é suportado com o objeto ProductAd .	cadeia
Tipo	O tipo do anúncio. Para obter mais informações sobre tipos de anúncios, consulte as Observações.	AdType
UrlCustomParameters	A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs. Este elemento só é suportado para objetos AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd e TextAd . Não é suportado com o objeto ProductAd .	CustomParameters

Observações

Para linguagens Java e .NET, não defina o elemento Tipo porque o valor é determinado por instanciar um anúncio de texto expandido ou outro tipo de anúncio.

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

<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Ad i:type="ExpandedTextAd">
    <DevicePreference i:nil="true" />
    <EditorialStatus i:nil="true" />
    <ForwardCompatibilityMap i:nil="true" />
    <Id i:nil="true" />
    <Status i:nil="true" />
    <FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <a:string>https://www.contoso.com/womenshoesale</a:string>
    </FinalUrls>
    <Path1>seattle</Path1>
    <Path2>shoe sale</Path2>
    <Text>Find New Customers & Increase Sales!</Text>
    <TextPart2>Start Advertising on Contoso Today.</TextPart2>
    <TitlePart1>Contoso</TitlePart1>
    <TitlePart2>Fast & Easy Setup</TitlePart2>
    <TitlePart3>Top Rated</TitlePart3>
  </Ad>
</Ads>

Requisitos

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

Utilizado Por

AddAds
GetAdsByAdGroupId
GetAdsByEditorialStatus
GetAdsByIds
UpdateAds

Compartilhar via