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