Objeto de Dados do Ad - Gestão de Campanhas
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.
- AppInstallAd
- DynamicSearchAd
- ExpandedTextAd
- HotelAd
- TextAd
- ProductAd
- ResponsiveAd
- ResponsiveSearchAd
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