Condividi tramite


Oggetto dati AppInstallAd - Gestione campagna

Definisce un annuncio di installazione dell'app.

Gli annunci di installazione dell'app sono simili agli annunci di testo, ma forniscono collegamenti diretti alle tue app con un pulsante, inviando i clienti direttamente allo store applicabile per scaricare l'applicazione. Questa è una soluzione ideale per gli inserzionisti che vogliono gestire e guidare i download delle loro app, piuttosto che il traffico del sito Web.

App Install Ads rileva automaticamente il dispositivo mobile e il sistema operativo del cliente, inviandoli al App Store Apple o a Google Play corrispondente. Puoi anche tenere traccia delle conversioni con gli stessi partner di rilevamento delle conversioni delle estensioni app: AppsFlyer, Kochava, Tune, Singular, Adjust e Branch.

Nota

Gli annunci di installazione dell'app sono disponibili solo in Australia, Brasile, Canada, Francia, Germania, India, Regno Unito e Stati Uniti solo in iOS e Android. Sono attualmente supportate solo le app disponibili nel Stati Uniti in Apple App Store e Google Play Store. Non è disponibile alcun supporto per Windows.

Non tutti hanno ancora questa funzionalità. Se non lo fai, non preoccuparti. Sarà presto disponibile.

Nota

Gli annunci di installazione dell'app possono essere creati solo nelle campagne di ricerca in cui AdGroupType è impostato su "SearchStandard". Se AdGroupType è impostato su "SearchDynamic", il gruppo di annunci non supporta gli annunci di installazione dell'app.

La combinazione degli elementi AppPlatform, AppStoreId, Text e Title rende univoca l'installazione dell'app.

Sintassi

<xs:complexType name="AppInstallAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <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="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementi

L'oggetto AppInstallAd include gli elementi seguenti: AppPlatform, AppStoreId, Text, Title.

Elemento Descrizione Tipo di dati
AppPlatform Piattaforma dell'applicazione.

I valori possibili includono iOS e Android.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale
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: Opzionale
Stringa
Testo Copia dell'annuncio. La copia deve contenere almeno una parola. La copia e il titolo dell'annuncio combinati devono contenere almeno tre parole.

La copia dell'annuncio non può contenere stringhe di testo dinamico, ad esempio {parola chiave}.

La lunghezza massima di input della copia è di 71 caratteri. Si noti che per i gruppi di annunci che usano il cinese tradizionale, il testo è limitato a 38 caratteri.

La copia dell'annuncio non può contenere il carattere di nuova riga (\n).

Aggiungere: Obbligatorio
Aggiornamento: Opzionale
Stringa
Titolo Titolo dell'annuncio. Il titolo deve contenere almeno una parola. La copia e il titolo dell'annuncio combinati devono contenere almeno tre parole.

Il titolo non può contenere stringhe di testo dinamico, ad esempio {keyword}.

La lunghezza massima di input del titolo è di 25 caratteri. Si noti che per i gruppi di annunci che usano il cinese tradizionale, il titolo è limitato a 15 caratteri.

Il titolo non può contenere il carattere di nuova riga (\n).

Aggiungere: Obbligatorio
Aggiornamento: Opzionale
Stringa

L'oggetto AppInstallAd include elementi ereditati.

Elementi ereditati

Elementi ereditati da Ad

L'oggetto AppInstallAd deriva dall'oggetto Ad ed eredita gli elementi seguenti: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Le descrizioni seguenti sono specifiche di AppInstallAd e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto Ad .

Elemento Descrizione Tipo di dati
AdFormatPreference Non supportato per questo tipo di annuncio. Stringa
DevicePreference Questo elemento determina se la preferenza è per gli annunci di installazione dell'app da visualizzare nei dispositivi mobili e tablet o solo nei dispositivi mobili. Gli annunci di installazione delle app non sono attualmente supportati nei computer desktop.

Per specificare una preferenza solo per i dispositivi mobili (ad esempio, esclusi i tablet), impostare questo elemento su 30001.

Per specificare una preferenza per i dispositivi mobili e tablet, impostare questo elemento su 0 (zero) o lasciare l'elemento nil. Per impostazione predefinita, questo elemento sarà nil.

Aggiungere: Opzionale
Aggiornamento: Opzionale
long
EditorialStatus Lo stato di revisione editoriale dell'annuncio, che indica se l'annuncio è in sospeso, è stato approvato o non è stato approvato.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
AdEditorialStatus
FinalAppUrls Non supportato per gli annunci di installazione dell'app. Matrice AppUrl
FinalMobileUrls Non supportato per gli annunci di installazione dell'app. matrice di stringhe
FinalUrls URL in cui un utente di ricerca accede e può scegliere di installare un'app.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale
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.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.
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.

Attualmente non sono presenti coppie chiave e valore ForwardCompatibilityMap applicabili per questo oggetto.
Matrice KeyValuePairOfstringstring
Id Identificatore univoco di Microsoft Advertising per l'annuncio.

Aggiungere: Sola lettura
Aggiornamento: Obbligatorio e di sola lettura
long
Stato Stato dell'annuncio.

Puoi impostare lo stato dell'annuncio su Attivo o In pausa.

Aggiungere: Opzionale
Aggiornamento: Opzionale
Adstatus
TrackingUrlTemplate Modello di rilevamento da usare come impostazione predefinita per l'URL specificato con FinalUrls.

Le regole di convalida seguenti si applicano ai modelli di rilevamento. Per altre informazioni sui modelli e i parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?
- Modelli di rilevamento definiti per entità di livello inferiore, ad esempio gli annunci sostituiscono quelli impostati per le entità di livello superiore, ad esempio la campagna. Per altre informazioni, vedere Limiti delle entità.
- La lunghezza del modello di rilevamento è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.
- Il modello di rilevamento deve essere un URL ben formato che inizia con uno dei seguenti: http://, https://, {lpurl} o {unescapedlpurl}.
- Microsoft Advertising non convalida l'esistenza di parametri personalizzati. Se si usano parametri personalizzati nel modello di rilevamento e non esistono, l'URL della pagina di destinazione includerà i segnaposto chiave e valore dei parametri personalizzati senza sostituzione. Ad esempio, se il modello di rilevamento non è https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} e {_season} o {_promocode} non sono definiti a livello di campagna, gruppo di annunci, criterio, parola chiave o annuncio, l'URL della pagina di destinazione sarà lo stesso.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.
Stringa
Tipo Tipo di annuncio. Questo valore è AppInstall quando si recupera un annuncio di installazione dell'app. Per altre informazioni sui tipi di annunci, vedi Le osservazioni sull'oggetto ad data.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
AdType
UrlCustomParameters Raccolta personalizzata di parametri chiave e valore per il rilevamento url.

Microsoft Advertising accetterà i primi 8 oggetti CustomParameter inclusi nell'oggetto CustomParameters e, se si includono più di 8 parametri personalizzati, verrà restituito un errore. Ogni CustomParameter include elementi Key e Value .

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Impostare l'elemento UrlCustomParameters su null o vuoto per mantenere eventuali parametri personalizzati esistenti. Per rimuovere tutti i parametri personalizzati, impostare l'elemento Parameters dell'oggetto CustomParameters su null o vuoto. Per rimuovere un subset di parametri personalizzati, specificare i parametri personalizzati che si desidera mantenere nell'elemento Parameters dell'oggetto CustomParameters .
CustomParameters

Requisiti

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