Record estensione annunci Flyer - Bulk
Definisce un'estensione dell'annuncio flyer che può essere scaricata e caricata in un file bulk.
Le estensioni Flyer consentono agli inserzionisti di distribuire cataloghi di prodotti o negozi (volantini) ai potenziali clienti.
Possono visualizzare in primo piano su query generali come "offerte settimanali" o "vendite settimanali" e quindi incoraggiare gli acquirenti a fare clic sul tuo annuncio invece di quello della concorrenza. Per loro natura aiutano a informare meglio gli utenti e, di conseguenza, a incrementare il coinvolgimento degli utenti, ad esempio la frequenza di clic.
Nota
Le estensioni Flyer sono disponibili per i clienti nel progetto pilota di funzionalità (GetCustomerPilotFeatures restituisce 802).
Puoi associare un'estensione dell'annuncio flyer all'account o alle campagne e ai gruppi di annunci nell'account. Ogni entità (account, campagna o gruppo di annunci) può essere associata a un massimo di 3 estensioni pubblicitarie flyer. Usa l'estensione dell'annuncio Volantino account, l'estensione per annunci flyer del gruppo di annunci e i record dell'estensione annunci Campaign Flyer per gestire le associazioni di estensione degli annunci volantini.
È possibile scaricare tutti i record dell'estensione Flyer Ad nell'account includendo il valore DownloadEntity di FlyerAdExtensions 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 aggiunta una nuova estensione per annunci Flyer alla libreria condivisa dell'account.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Store Id,Name,Ad Schedule,Use Searcher Time Zone,Flyer Name,Description,Final Url,Mobile Final Url,Media Ids,Media Urls
Format Version,,,,,,,,,,,6.0,,,,,,
Flyer Ad Extension,Active,-18,0,,,ClientIdGoesHere,,,12/31/2020,,,(Monday[09:00-21:00]),FALSE,Flyer name goes here, Flyer description goes here,https://www.contoso.com/one; https://www.contoso.com/two; https://www.contoso.com/three,https://mobile.contoso.com/one; https://mobile.contoso.com/two; https://mobile.contoso.com/three,12345678,
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkFlyerAdExtension , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.
// Map properties in the Bulk file to the BulkFlyerAdExtension
var bulkFlyerAdExtension = new BulkFlyerAdExtension
{
// '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
// FlyerAdExtension object of the Campaign Management service.
FlyerAdExtension = new FlyerAdExtension
{
// 'Description' column header in the Bulk file
Description = "Flyer description",
// 'Id' column header in the Bulk file
Id = flyerAdExtensionIdKey,
// 'Final Url' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://www.contoso.com/one",
"https://www.contoso.com/two",
"https://www.contoso.com/three"
},
// 'Mobile Final Url' column header in the Bulk file
FinalMobileUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://mobile.contoso.com/one",
"https://mobile.contoso.com/two",
"https://mobile.contoso.com/three"
},
// 'Flyer Name' column header in the Bulk file
FlyerName = "Flyer name",
// 'Media Ids' column header in the Bulk file
ImageMediaIds = new[] {
(long)12345678,
},
// 'Media Urls' column header in the Bulk file
ImageMediaUrls = null,
// 'Store Id' column header in the Bulk file
StoreId = 12345678,
// '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"
},
}
},
// '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(bulkFlyerAdExtension);
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 flyer ad extension , i campi dell'attributo seguenti sono disponibili nello schema file bulk.
- Pianificazione annunci
- Client Id
- Descrizione
- Posizione editoriale
- Codice motivo editoriale
- Stato editoriale
- Termine editoriale
- Data di fine
- URL finale
- Nome volantino
- Id
- ID multimediali
- URL multimediali
- URL finale per dispositivi mobili
- Ora modifica
- Parent Id
- Paesi di pubblicazione
- Data inizio
- Stato
- ID archivio
- Usare il fuso orario del searcher
- Versione
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 e Usa fuso orario searcher dipendono l'uno dall'altro e vengono aggiornati insieme. Se si lascia entrambi i campi vuoti durante l'aggiornamento, nessuno dei due viene aggiornato. Se si includono valori per uno di questi campi, i valori precedenti per ognuno di questi campi vengono rimossi o sostituiti.
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
Descrizione
Descrizione che può essere usata dall'inserzionista, dall'agenzia o dall'account manager per tenere traccia, etichettare o gestire le estensioni dei volantini.
Questa descrizione non viene visualizzata con l'annuncio o l'immagine.
La lunghezza massima per questo elemento è di 1.024 caratteri.
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
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.
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.
La data di fine deve essere entro 30 giorni dalla data di inizio.
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. La data di fine può essere abbreviata o estesa, purché la data di inizio non sia impostata o si verifichi fino a 30 giorni prima della nuova data di fine.
Elimina: Sola lettura
URL finale
URL della pagina di destinazione.
Le regole di convalida seguenti si applicano agli URL finali e agli URL finali per dispositivi mobili.
- 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 fino a 10 voci di elenco sia per l'URL finale che per l'URL finale per dispositivi mobili. tuttavia, per il recapito viene usato solo il primo elemento di ogni elenco. Il servizio consente fino a 10 elementi di elenco per una potenziale compatibilità con il forward.
- Ogni URL è delimitato da un punto e virgola e da uno spazio ("; ").
- L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio {lpurl}.
- Gli URL finali devono essere ognuno un URL ben formato a partire da http:// o https://.
- Se si specifica l'URL finale per dispositivi mobili, è necessario specificare anche l'URL finale.
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
Nome volantino
Nome del volantino.
La lunghezza massima per questo elemento è di 150 caratteri.
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
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 ad ad flyer del gruppo di annunci el'estensione per annunci Campaign Flyer. 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
ID multimediali
Identificatore dell'immagine da includere nell'annuncio.
È possibile impostare un solo ID multimediale.
Ogni ID multimediale corrisponde a un'immagine del sottotipo "GenericImage".
L'immagine deve avere una larghezza e un'altezza minime di 220 px e una dimensione massima del file di 3,9 MB.
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
URL multimediali
URL del supporto già aggiunto.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
URL finale per dispositivi mobili
URL della pagina di destinazione per i dispositivi mobili.
Le regole di convalida seguenti si applicano agli URL finali e agli URL finali per dispositivi mobili.
- 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 fino a 10 voci di elenco sia per l'URL finale che per l'URL finale per dispositivi mobili. tuttavia, per il recapito viene usato solo il primo elemento di ogni elenco. Il servizio consente fino a 10 elementi di elenco per una potenziale compatibilità con il forward.
- Ogni URL è delimitato da un punto e virgola e da uno spazio ("; ").
- L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio {lpurl}.
- Gli URL finali devono essere ognuno un URL ben formato a partire da http:// o https://.
- Se si specifica l'URL finale per dispositivi mobili, è necessario specificare anche l'URL finale.
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
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.
La data di fine deve essere entro 30 giorni dalla data di inizio.
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. La data di inizio può essere abbreviata o estesa, purché la data di fine non sia impostata o si verifichi fino a 30 giorni dopo la nuova data di inizio.
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.
ID archivio
Identificatore univoco di un archivio Microsoft Merchant Center usato per gli annunci di prodotto.
Aggiungere: Opzionale
Aggiornamento: Sola lettura. Non è possibile aggiornare l'ID archivio dopo che è stato impostato.
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 e Usa fuso orario searcher dipendono l'uno dall'altro e vengono aggiornati insieme. Se si lascia entrambi i campi vuoti durante l'aggiornamento, nessuno dei due viene aggiornato. Se si includono valori per uno di questi campi, i valori precedenti per ognuno di questi campi vengono rimossi o sostituiti.
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
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