Condividi tramite

Record estensione annunci app - Bulk

  • Articolo

Definisce un'estensione dell'annuncio dell'app che può essere caricata e scaricata in un file bulk.

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. Usa l'estensione dell'annuncio dell'app account, l'estensione dell'annuncio dell'app gruppo di annunci pubblicitari e i record dell'estensione dell'app campagna per gestire le associazioni di estensioni degli annunci dell'app.

È possibile scaricare tutti i record dell'estensione Ad app nell'account includendo il valore DownloadEntity di AppAdExtensions 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.

L'esempio csv bulk seguente aggiungerebbe una nuova estensione per gli annunci dell'app alla libreria condivisa dell'account.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Text,Destination Url,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,App Platform,App Id,Final Url Suffix
Format Version,,,,,,,,,,,,,6.0,,,,,
App Ad Extension,Active,-11,0,,,ClientIdGoesHere,,,12/31/2020,Contoso,DestinationUrlGoesHere,,,(Monday[09:00-21:00]),FALSE,Windows,AppStoreIdGoesHere,

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAppAdExtension , 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 BulkAppAdExtension
var bulkAppAdExtension = new BulkAppAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // AppAdExtension object of the Campaign Management service.
    AppAdExtension = new AppAdExtension
    {
        // 'App Platform' column header in the Bulk file
        AppPlatform = "Windows",
        // 'App Id' column header in the Bulk file
        AppStoreId = "AppStoreIdGoesHere",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = "DestinationUrlGoesHere",
        // 'Device Preference' column header in the Bulk file
        DevicePreference = null,
        // 'Text' column header in the Bulk file
        DisplayText = "Contoso",
        // 'Id' column header in the Bulk file
        Id = appAdExtensionIdKey,
        // 'Ad Schedule' column header in the Bulk file
        Scheduling = new Schedule
        {
            // Each day and time range is delimited by a semicolon (;) in the Bulk file
            DayTimeRanges = new[]
            {
                // Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
                new DayTime
                {
                    Day = Day.Monday,
                    StartHour = 9,
                    StartMinute = Minute.Zero,
                    EndHour = 21,
                    EndMinute = Minute.Zero,
                },
            },
            // 'End Date' column header in the Bulk file
            EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
            {
                Month = 12,
                Day = 31,
                Year = DateTime.UtcNow.Year + 1
            },
            // 'Start Date' column header in the Bulk file
            StartDate = null,
            // 'Use Searcher Time Zone' column header in the Bulk file
            UseSearcherTimeZone = false,
        },

        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkAppAdExtension);

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 di estensione annunci app , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

Pianificazione annunci

Elenco degli intervalli di giorno e di ora in cui vuoi che l'estensione dell'annuncio venga visualizzata con i tuoi annunci. Ogni giorno e intervallo di tempo include il giorno pianificato della settimana, l'ora di inizio/fine e il minuto di inizio/fine. Ogni intervallo di giorno e ora è racchiuso tra parentesi sinistra e destra e separato da altri intervalli di giorno e ora con un punto e virgola (;) delimitatore. All'interno di ogni giorno e intervallo di tempo il formato è Day[StartHour:StartMinue-EndHour:EndMinute].

I valori possibili di StartHour sono compresi tra 00 e 23, dove 00 equivale alle 12:00 e 12 alle 12:00.

I valori possibili di EndHour sono compresi tra 00 e 24, dove 00 equivale alle 12:00 e 12 :00.

I valori possibili di StartMinute e EndMinute sono compresi tra 00 e 60.

L'esempio seguente illustra gli intervalli di giorno e di ora durante i giorni feriali dalle 9:00 alle 21:00: (lunedì[09:00-21:00]);( martedì[09:00-21:00]); (Mercoledì[09:00-21:00]); (Giovedì[09:00-21:00]); (Venerdì[09:00-21:00])

Aggiungere: Opzionale. Se non imposti questo campo, l'estensione dell'annuncio sarà idonea per la pianificazione in qualsiasi momento durante le date di inizio e fine del calendario.
Aggiornamento: Opzionale. I singoli intervalli di giorno e ora non possono essere aggiornati. È possibile aggiornare in modo efficace gli intervalli di giorno e di ora inviando un nuovo set che deve sostituire il set precedente. I campi Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher dipendono l'uno dall'altro e vengono aggiornati insieme. Se si lascia tutti questi campi vuoti durante l'aggiornamento, nessuno di essi viene aggiornato. Se si includono valori per uno di questi campi, i valori precedenti per tutti questi campi vengono rimossi o sostituiti. Per rimuovere tutte le impostazioni di pianificazione precedenti, impostare ognuno di questi campi su delete_value.
Elimina: Sola lettura

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, Android e Windows.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
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

URL di destinazione

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. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Preferenza dispositivo

Questo campo determina se la preferenza è che l'estensione dell'annuncio venga visualizzata nei dispositivi mobili o in tutti i dispositivi.

I valori possibili sono Tutti e Dispositivi mobili, 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

Posizione editoriale

Componente o proprietà dell'estensione 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

Stato editoriale dell'estensione dell'annuncio.

I valori possibili sono descritti nella tabella seguente.

Valore Descrizione
Attivazione L'estensione dell'annuncio ha superato la revisione editoriale.
ActiveLimited L'estensione pubblicitaria ha superato la revisione editoriale in uno o più mercati e uno o più elementi dell'estensione dell'annuncio sono in fase di revisione editoriale in un altro mercato. Ad esempio, l'estensione dell'annuncio ha superato la revisione editoriale per il Canada ed è ancora in sospeso nella Stati Uniti.
Approvato L'estensione dell'annuncio non è riuscita nella revisione editoriale.
Inattivo Uno o più elementi dell'estensione dell'annuncio sono in fase di revisione editoriale.

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

Data di fine

Stringa della data di fine pianificata dell'estensione dell'annuncio formattata come MM/DD/AAAAA.

La data di fine è inclusiva. Ad esempio, se imposti questo campo sul 31/12/2020, le estensioni dell'annuncio smetteranno di essere visualizzate alle 23:59 del 31/12/2020.

Aggiungere: Opzionale. Se non specifichi una data di fine, l'estensione dell'annuncio continuerà a essere recapitata a meno che non sospendi le campagne, i gruppi di annunci o gli annunci associati.
Aggiornamento: Opzionale. La data di fine può essere abbreviata o estesa, purché la data di inizio sia Null o si verifichi prima della nuova data di fine. Se si imposta questo campo sulla stringa delete_value , la data di fine verrà effettivamente rimossa. I campi Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher dipendono l'uno dall'altro e vengono aggiornati insieme. Se si lascia tutti questi campi vuoti durante l'aggiornamento, nessuno di essi viene aggiornato. Se si includono valori per uno di questi campi, i valori precedenti per tutti questi campi vengono rimossi o sostituiti. Per rimuovere tutte le impostazioni di pianificazione precedenti, impostare ognuno di questi campi su delete_value.
Elimina: Sola lettura

Id

Identificatore generato dal sistema dell'estensione 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'estensione dell'annuncio nel campo ID dei tipi di record dipendenti, ad esempio l'estensione annunci per le app del gruppo di annunci pubblicitari e l'estensione dell'annuncio dell'app campagna. Questa operazione è consigliata se si aggiungono nuove estensioni pubblicitarie 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 dell'account che contiene l'estensione dell'annuncio.

Questo campo bulk esegue il mapping al campo ID del record account .

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura

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

Data inizio

Stringa della data di inizio pianificata dell'estensione dell'annuncio formattata come MM/DD/AAAAA.

La data di inizio è inclusiva. Ad esempio, se imposti StartDate sul 5/5/2020, le estensioni dell'annuncio inizieranno a essere visualizzate alle 12:00 del 5/5/2020.

Aggiungere: Opzionale. Se non specifichi una data di inizio, l'estensione dell'annuncio è immediatamente idonea per essere pianificata.
Aggiornamento: Opzionale. La data di inizio può essere abbreviata o estesa, purché la data di fine sia Null o si verifichi dopo la nuova data di inizio. Se imposti questo campo sulla stringa delete_value , stai effettivamente rimuovendo la data di inizio e l'estensione dell'annuncio è immediatamente idonea per essere pianificata. I campi Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher dipendono l'uno dall'altro e vengono aggiornati insieme. Se si lascia tutti questi campi vuoti durante l'aggiornamento, nessuno di essi viene aggiornato. Se si includono valori per uno di questi campi, i valori precedenti per tutti questi campi vengono rimossi o sostituiti. Per rimuovere tutte le impostazioni di pianificazione precedenti, impostare ognuno di questi campi su delete_value.
Elimina: Sola lettura

Stato

Stato dell'estensione dell'annuncio.

I valori possibili sono Attivo 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

Testo visualizzato nell'estensione dell'annuncio dell'app.

Il testo può contenere un massimo di 35 caratteri.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Usare il fuso orario del searcher

Determina se usare il fuso orario dell'account o il fuso orario dell'utente di ricerca in cui potrebbero essere recapitati gli annunci.

Impostare questa proprietà su TRUE se vuoi che le estensioni dell'annuncio vengano visualizzate nel fuso orario dell'utente di ricerca e in caso contrario impostarla su FALSE.

Aggiungere: Opzionale. Se non si specifica questo campo o lo si lascia vuoto, verrà impostato il valore predefinito FALSE e verrà usato il fuso orario dell'account.
Aggiornamento: Opzionale. Se si imposta questo campo sulla stringa delete_value , si reimposta in modo efficace il valore predefinito FALSE. I campi Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher dipendono l'uno dall'altro e vengono aggiornati insieme. Se si lascia tutti questi campi vuoti durante l'aggiornamento, nessuno di essi viene aggiornato. Se si includono valori per uno di questi campi, i valori precedenti per tutti questi campi vengono rimossi o sostituiti. Per rimuovere tutte le impostazioni di pianificazione precedenti, impostare ognuno di questi campi su delete_value.
Elimina: Sola lettura

Versione

Numero di volte in cui il contenuto dell'estensione dell'annuncio è stato aggiornato. La versione è impostata su 1 quando si aggiunge l'estensione e viene incrementata ogni volta che viene rivista.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura