App Install Ad Record - Bulk
Definisce un annuncio di installazione dell'app che può essere scaricato e caricato in un file bulk.
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 il tipo di gruppo di annunci è impostato su "SearchStandard". Se il tipo di gruppo di annunci è impostato su "SearchDynamic", il gruppo di annunci non supporta gli annunci di installazione dell'app.
È possibile scaricare tutti i record di App Install Ad nell'account includendo il valore DownloadEntity di AppInstallAds nella richiesta di servizio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Inoltre, la richiesta di download deve includere l'ambito EntityData . Per altre informazioni sul servizio bulk, incluse le procedure consigliate, vedere Download e caricamento in blocco.
Nell'esempio csv bulk seguente viene aggiunto un nuovo annuncio di installazione dell'app se viene fornito un valore di ID padre valido.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,,,,,6.0,,,,,,,
App Install Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,,,,All,,Android,AppStoreIdGoesHere,FinalUrlGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAppInstallAd , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAppInstallAd
var bulkAppInstallAd = new BulkAppInstallAd
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
// 'Ad Group' column header in the Bulk file
AdGroupName = "AdGroupNameGoesHere",
// 'Campaign' column header in the Bulk file
CampaignName = "ParentCampaignNameGoesHere",
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// AppInstallAd object of the Campaign Management service.
AppInstallAd = new AppInstallAd
{
// 'App Platform' column header in the Bulk file
AppPlatform = "Android",
// 'App Id' column header in the Bulk file
AppStoreId = "AppStoreIdGoesHere",
// 'Device Preference' column header in the Bulk file
DevicePreference = 0,
// 'Final Url' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"FinalUrlGoesHere"
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
// 'Text' column header in the Bulk file
Text = "Find New Customers & Increase Sales!",
// 'Title' column header in the Bulk file
Title = "Contoso Quick Setup",
// 'Tracking Template' column header in the Bulk file
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file
UrlCustomParameters = new CustomParameters
{
// Each custom parameter is delimited by a semicolon (;) in the Bulk file
Parameters = new[] {
new CustomParameter(){
Key = "promoCode",
Value = "PROMO1"
},
new CustomParameter(){
Key = "season",
Value = "summer"
},
}
},
},
};
uploadEntities.Add(bulkAppInstallAd);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Per un record dell'annuncio di installazione dell'app , i campi dell'attributo seguenti sono disponibili nello schema file bulk. La combinazione dei campi Id app, Piattaforma app, Testo e Titolo rende univoco l'annuncio di installazione dell'app.
- Gruppo di annunci
- App Id
- Piattaforma app
- Campagna
- Client Id
- Parametro personalizzato
- Preferenza dispositivo
- Stato di appello editoriale
- Posizione editoriale
- Codice motivo editoriale
- Stato editoriale
- Termine editoriale
- URL finale
- Suffisso URL finale
- Id
- Ora modifica
- Parent Id
- Paesi di pubblicazione
- Stato
- Testo
- Titolo
- Modello di rilevamento
Gruppo di annunci
Nome del gruppo di annunci che contiene l'annuncio.
Aggiungere: Sola lettura e Obbligatorio
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio
Nota
Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Gruppo di annunci .
App Id
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. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
Piattaforma app
Piattaforma dell'applicazione.
I valori possibili includono iOS e Android.
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
Campagna
Nome della campagna che contiene il gruppo di annunci e l'annuncio.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
ID Client
Usato per associare i record nel file di caricamento bulk ai record nel file dei risultati. Il valore di questo campo non viene utilizzato o archiviato dal server; viene semplicemente copiato dal record caricato nel record di risultati corrispondente. Può essere qualsiasi stringa valida fino a 100 di lunghezza.
Aggiungere: Opzionale
Aggiornamento: Opzionale
Elimina: Sola lettura
Parametro personalizzato
Raccolta personalizzata di parametri chiave e valore per il rilevamento url.
In un file bulk l'elenco dei parametri personalizzati viene formattato come segue.
Formattare ogni coppia di parametri personalizzata come Key=Value, ad esempio {_promoCode}=PROMO1.
Microsoft Advertising accetterà le prime 8 coppie chiave parametro e valore personalizzate incluse e, se si includono più di 8 parametri personalizzati, verrà restituito un errore. Ogni coppia chiave/valore è delimitata da un punto e virgola e da uno spazio ("; "), ad esempio {_promoCode}=PROMO1; {_season}=summer.
Una chiave non può contenere un punto e virgola. Se un valore contiene un punto e virgola, deve essere preceduto da caratteri di escape come '\;'. Inoltre, se il valore contiene una barra rovesciata, deve anche essere preceduto da escape come '\'.
La chiave non può superare i 16 byte UTF-8 e il valore non può superare i 250 byte UTF-8. La chiave è obbligatoria e il valore è facoltativo. Le dimensioni massime della chiave non includono le parentesi graffe e il carattere di sottolineatura, ad esempio '{', '_' e '}'.
Nota
Con il servizio bulk la chiave deve essere formattata con parentesi graffe circostanti e un carattere di sottolineatura iniziale, ad esempio se la chiave è promoCode, deve essere formattata come {_promoCode}. Con il servizio Campaign Management non è possibile specificare le parentesi graffe e il carattere di sottolineatura circostanti.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per rimuovere tutti i parametri personalizzati, impostare questo campo su delete_value. La parola chiave delete_value rimuove l'impostazione precedente. Per rimuovere un subset di parametri personalizzati, specificare i parametri personalizzati che si desidera mantenere e omettere eventuali parametri che non si desidera mantenere. Il nuovo set di parametri personalizzati sostituirà qualsiasi set di parametri personalizzato precedente.
Elimina: Sola lettura
Preferenza dispositivo
Questo campo determina se la preferenza è per gli annunci di installazione di app da visualizzare su dispositivi mobili e tablet o solo su dispositivi mobili. Gli annunci di installazione delle app non sono attualmente supportati nei computer desktop.
I valori possibili sono Tutti (dispositivi mobili e tablet) e Dispositivi mobili (ad esempio esclusi i tablet), che differiscono dai valori usati nel servizio di gestione della campagna.
Il valore predefinito è All.
Nel file dei risultati di download e caricamento bulk questo campo non sarà mai vuoto. Se non è stata specificata una preferenza per il dispositivo, verrà restituito il valore predefinito All.If you did not specify a device preference, the default value of All will be returned.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa. Se si imposta questo campo su delete_value, verrà ripristinato il valore predefinito Di tutto.
Elimina: Sola lettura
Stato di appello editoriale
Determina se è possibile fare ricorso ai problemi rilevati dalla recensione editoriale.
I valori possibili sono descritti nella tabella seguente.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Posizione editoriale
Componente o proprietà dell'annuncio che ha avuto esito negativo nella revisione editoriale.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Codice motivo editoriale
Codice che identifica il motivo dell'errore. Per un elenco dei possibili codici motivo, vedere Codici motivo editoriali.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Stato editoriale
Lo stato editoriale dell'annuncio.
I valori possibili sono descritti nella tabella seguente.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Termine editoriale
Il termine che ha fallito revisione editoriale.
Questo campo non verrà impostato se una combinazione di termini ha causato l'errore o se l'errore è stato basato su una violazione dei criteri.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
URL finale
URL in cui un utente di ricerca accede e può scegliere di installare un'app.
Le regole di convalida seguenti si applicano all'URL finale per gli annunci di installazione dell'app.
- La lunghezza dell'URL è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.
- È possibile specificare un solo URL in questo campo.
- L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio "{lpurl}".
- Ogni URL deve essere un URL ben formato a partire da http:// o https://.
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
Suffisso URL finale
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 campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura
Id
Identificatore generato dal sistema dell'annuncio.
Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. È quindi possibile fare riferimento a un identificatore negativo impostato per l'annuncio nel campo Id padre dei tipi di record dipendenti, ad esempio App Install Ad Label. Questa operazione è consigliata se si aggiungono nuovi annunci e nuovi record dipendenti nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio
Ora modifica
Data e ora dell'ultimo aggiornamento dell'entità. Il valore è espresso nell'ora UTC (Coordinated Universal Time).
Nota
Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Parent Id
Identificatore generato dal sistema del gruppo di annunci che contiene l'annuncio.
Questo campo bulk viene mappato al campo Id del record gruppo di annunci .
Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore del gruppo di annunci esistente o un identificatore negativo uguale al campo Id del record gruppo di annunci padre. Questo è consigliato se si aggiungono nuovi annunci a un nuovo gruppo di annunci nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura
Elimina: Sola lettura
Nota
Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Gruppo di annunci .
Paesi di pubblicazione
Elenco di paesi o aree di pubblicazione le cui linee guida editoriali non consentono il termine specificato.
In un file bulk l'elenco di paesi o aree di pubblicazione è delimitato da un punto e virgola (;).
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Stato
Stato dell'annuncio.
I valori possibili sono Attivo, Sospeso o Eliminato.
Aggiungere: Opzionale. Il valore predefinito è Attivo.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.
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. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
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. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
Modello di rilevamento
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?
I modelli di rilevamento definiti per le entità di livello inferiore, ad esempio gli annunci, sostituiscono quelli impostati per 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 è
https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}e non vengono definiti {_season} o {_promocode} 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 campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per