Oggetto Ad Data - Campaign Management

Articolo
12/21/2023

Definisce l'oggetto di base di un annuncio.

Non provare a creare un'istanza di un annuncio. È possibile creare uno o più degli oggetti seguenti che ne derivano.

Sintassi

<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>

Elementi

L'oggetto Ad include gli elementi seguenti: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters.

Elemento	Descrizione	Tipo di dati
AdFormatPreference	La preferenza per il formato degli annunci viene usata per indicare se preferisci o meno che la copia dell'annuncio venga visualizzata agli utenti come annuncio di ricerca o di pubblico. Gli annunci di ricerca tendono a essere scritti come un invito all'azione, mentre gli annunci del pubblico devono essere scritti in uno stile più informativo. Anche se hai la possibilità di usare gli annunci di ricerca come annunci per il pubblico, la designazione di un annuncio come formato preferito per gli annunci audience ti consente di ottimizzare la messaggistica per la distribuzione nativa. I valori possibili sono AudienceAd e All. Se impostato su Tutto, l'annuncio sarà idoneo per i formati di annunci sia di ricerca che di pubblico. Se impostato su AudienceAd, l'annuncio sarà idoneo solo per il formato degli annunci del pubblico. Preferenza formato annuncio è supportata solo per gli oggetti ExpandedTextAd e TextAd .	Stringa
DevicePreference	Determina la preferenza del dispositivo per la visualizzazione dell'annuncio. La preferenza del dispositivo è supportata solo per gli oggetti AppInstallAd e TextAd .	long
EditorialStatus	Lo stato di revisione editoriale dell'annuncio, che indica se l'annuncio è in sospeso, è stato approvato o non è stato approvato.	AdEditorialStatus
FinalAppUrls	Parametro riservato per utilizzi futuri.	Matrice AppUrl
FinalMobileUrls	URL della pagina di destinazione per dispositivi mobili. Questo elemento è supportato solo per gli oggetti ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd e TextAd . Non è supportato con gli oggetti AppInstallAd, DynamicSearchAd e ProductAd .	matrice di stringhe
FinalUrls	Ultimo URL finale in cui viene infine usato un utente, indipendentemente dal fatto che il percorso dell'URL finale del clic includa o meno eventuali reindirizzamenti. Questo elemento è supportato solo per gli oggetti AppInstallAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd e TextAd . Non è supportato con gli oggetti DynamicSearchAd e ProductAd .	matrice di stringhe
FinalUrlSuffix	Il suffisso URL finale può includere parametri di rilevamento che verranno aggiunti alla fine dell'URL della pagina di destinazione. È consigliabile inserire parametri di rilevamento richiesti dalla pagina di destinazione in un suffisso URL finale in modo che i clienti vengano sempre inviati alla pagina di destinazione. Per altri dettagli e regole di convalida, vedere Suffisso URL finale nelle guide tecniche. Questo elemento è supportato solo per gli oggetti AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd e ResponsiveSearchAd . Non è supportato con gli oggetti ProductAd e TextAd .	Stringa
ForwardCompatibilityMap	Elenco di stringhe di chiave e valore per la compatibilità con l'inoltro per evitare modifiche che altrimenti causano un'interruzione quando vengono aggiunti nuovi elementi nella versione corrente dell'API. Le modifiche di compatibilità forward verranno annotate qui nelle versioni future. Attualmente non sono presenti modifiche di compatibilità per questo oggetto.	Matrice KeyValuePairOfstringstring
Id	Identificatore univoco di Microsoft Advertising per l'annuncio.	long
Stato	Stato dell'annuncio. Puoi impostare lo stato dell'annuncio su Attivo o In pausa.	Adstatus
TrackingUrlTemplate	Modello di rilevamento da usare come impostazione predefinita per tutti gli URL della pagina di destinazione. Questo elemento è supportato solo per gli oggetti AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd e TextAd . Non è supportato con l'oggetto ProductAd .	Stringa
Digitare	Tipo di annuncio. Per altre informazioni sui tipi di annunci, vedi osservazioni.	AdType
UrlCustomParameters	Raccolta personalizzata di parametri chiave e valore per il rilevamento url. Questo elemento è supportato solo per gli oggetti AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd e TextAd . Non è supportato con l'oggetto ProductAd .	CustomParameters

Osservazioni

Per Java e i linguaggi .NET, non impostare l'elemento Type perché il valore è determinato dal fatto che si crea un'istanza di un annuncio di testo espanso o di un altro tipo di annuncio.

Se generi il SOAP manualmente, usa l'attributo type del <Ad> nodo (come illustrato nell'esempio seguente) per specificare il tipo di annuncio.

<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>

Requisiti

Servizio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Usato da

AddAds
GetAdsByAdGroupId
GetAdsByEditorialStatus
GetAdsByIds
UpdateAds

Condividi tramite