Oggetto dati AppAdExtension - Campaign Management

Definisce un'estensione dell'annuncio dell'app che può essere inclusa in un annuncio.

Puoi associare un'estensione dell'annuncio dell'app all'account o alle campagne e ai gruppi di annunci nell'account. Ogni entità (account, campagna o gruppo di annunci) può essere associata a tutte le estensioni di annunci dell'app che decidi tu, fino al numero totale di estensioni pubblicitarie dell'app nel tuo account.

Sintassi

<xs:complexType name="AppAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="AppPlatform" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="AppStoreId" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q47="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q47:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q48="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q48:ArrayOfstring" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementi

L'oggetto AppAdExtension include gli elementi seguenti: AppPlatform, AppStoreId, DestinationUrl, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Elemento	Descrizione	Tipo di dati
AppPlatform	Piattaforma dell'applicazione. I valori possibili includono iOS, Android e Windows. Aggiungere: Obbligatorio Aggiornamento: Obbligatorio	Stringa
AppStoreId	Identificatore dell'applicazione fornito dall'App Store. Se l'applicazione è nuova, aspettati di attendere 4-7 giorni prima che l'annuncio sia idoneo per la distribuzione. Aggiungere: Obbligatorio Aggiornamento: Obbligatorio	Stringa
DestinationUrl	URL della pagina Web di download dell'App Store a cui gli utenti vengono assegnati quando fanno clic sul collegamento all'estensione dell'app. L'URL può contenere stringhe di testo dinamico, ad esempio {parola chiave}. Per un elenco dei parametri supportati, vedere la sezione Parametri disponibili nell'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?. L'URL può contenere un massimo di 1.024 caratteri. Se l'URL non specifica un protocollo, il sistema usa il protocollo HTTP quando un utente fa clic sull'annuncio. Se l'URL specifica il protocollo HTTP quando si aggiunge un annuncio, il servizio rimuoverà la stringa del protocollo http:// (la stringa del protocollo HTTP non viene conteggiata rispetto al limite di 1.024 caratteri); tuttavia, il servizio non rimuoverà una stringa di protocollo HTTPS (https://) dall'URL. Aggiungere: Obbligatorio Aggiornamento: Opzionale	Stringa
Displaytext	Testo visualizzato nell'estensione dell'annuncio dell'app. Il testo può contenere un massimo di 35 caratteri. Aggiungere: Obbligatorio Aggiornamento: Opzionale	Stringa
FinalAppUrls	Parametro riservato per utilizzi futuri.	Matrice AppUrl
FinalMobileUrls	Parametro riservato per utilizzi futuri.	matrice di stringhe
FinalUrls	Parametro riservato per utilizzi futuri.	matrice di stringhe
FinalUrlSuffix	Parametro riservato per utilizzi futuri.	Stringa
TrackingUrlTemplate	Parametro riservato per utilizzi futuri.	Stringa
UrlCustomParameters	Parametro riservato per utilizzi futuri.	CustomParameters

L'oggetto AppAdExtension include elementi ereditati.

Elementi ereditati

Elementi ereditati da AdExtension

L'oggetto AppAdExtension deriva dall'oggetto AdExtension ed eredita gli elementi seguenti: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Le descrizioni seguenti sono specifiche di AppAdExtension e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto AdExtension .

Elemento	Descrizione	Tipo di dati
DevicePreference	Questo elemento determina se la preferenza è che l'estensione dell'annuncio venga visualizzata nei dispositivi mobili o in tutti i dispositivi. Per specificare una preferenza per i dispositivi mobili, impostare questo elemento su 30001. Per specificare tutti i dispositivi, impostare questo elemento su 0 (zero) o lasciare l'elemento nil. Per impostazione predefinita, questo elemento sarà nil. Aggiungere: Opzionale Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.	long
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. Attualmente non sono presenti modifiche di compatibilità per l'oggetto AdExtension . Aggiungere: Sola lettura Aggiornamento: Sola lettura	Matrice KeyValuePairOfstringstring
Id	Identificatore univoco di Microsoft Advertising dell'estensione dell'annuncio. Aggiungere: Sola lettura Aggiornamento: Sola lettura e Obbligatorio	long
Pianificazione	Determina il giorno e gli intervalli di tempo del calendario quando l'estensione dell'annuncio è idonea per essere visualizzata negli annunci. Aggiungere: Opzionale Aggiornamento: Opzionale. Se imposti questo elemento null, qualsiasi set di pianificazione esistente per l'estensione dell'annuncio rimarrà invariato. Se imposti questo valore su qualsiasi oggetto Schedule non Null, sostituisci in modo efficace le impostazioni di pianificazione esistenti per l'estensione dell'annuncio. Per rimuovere tutta la pianificazione, impostare questo elemento su un oggetto Schedule vuoto.	Schedule
Stato	Stato dell'estensione dell'annuncio. Il valore sarà sempre attivo perché il servizio Campaign Management non restituisce le estensioni pubblicitarie eliminate. Aggiungere: Sola lettura Aggiornamento: Sola lettura	AdExtensionStatus
Tipo	Tipo di estensione dell'annuncio. Questo valore è AppAdExtension quando recuperi un'estensione dell'annuncio dell'app. Aggiungere: Sola lettura Aggiornamento: Sola lettura Per altre informazioni sui tipi di estensione degli annunci, vedi le osservazioni sull'oggetto dati dell'estensione per gli annunci.	Stringa
Versione	Tiene traccia del numero di volte in cui l'estensione dell'annuncio è stata aggiornata. La versione è impostata su 1 quando viene creata l'estensione dell'annuncio e viene incrementato di uno dopo ogni aggiornamento. Aggiungere: Non consentito Aggiornamento: Non consentito	int

Requisiti

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