Condividi tramite


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