Record estensione annunci posizione - Bulk
Definisce un'estensione dell'annuncio di posizione che può essere scaricata e caricata in un file bulk.
Puoi associare un'estensione dell'annuncio della posizione all'account o alle campagne nell'account. Ogni entità (account o campagna) può essere associata a tutte le estensioni degli annunci di posizione che decidi tu, fino al numero totale di estensioni pubblicitarie per la posizione nel tuo account. Usa i record Account Location Ad Extension e Campaign Location Ad Extension per gestire le associazioni di estensione degli annunci di posizione.
È possibile scaricare tutti i record dell'estensione Location Ad nell'account includendo il valore DownloadEntity di LocationAdExtensions 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 di posizione alla libreria condivisa dell'account.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Business Name,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Address Line 1,Address Line 2,Postal Code,City,State Or Province Code,Province Name,Latitude,Longitude,Country Code
Format Version,,,,,,,,,,,,,6.0,,,,,,,,,,,
Location Ad Extension,Active,-15,0,,,ClientIdGoesHere,,,12/31/2020,Contoso Shoes,206-555-0100,,,(Monday[09:00-21:00]),FALSE,1234 Washington Place,Suite 1210,98608,Woodinville,,WA,0,0,US
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkLocationAdExtension , 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 BulkLocationAdExtension
var bulkLocationAdExtension = new BulkLocationAdExtension
{
// '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
// LocationAdExtension object of the Campaign Management service.
LocationAdExtension = new LocationAdExtension
{
Address = new Address
{
// 'City' column header in the Bulk file
CityName = "Woodinville",
// 'Country Code' column header in the Bulk file
CountryCode = "US",
// 'Postal Code' column header in the Bulk file
PostalCode = "98608",
// 'State Or Province Code' column header in the Bulk file
ProvinceCode = null,
// 'Province Name' column header in the Bulk file
ProvinceName = "WA",
// 'Address Line 1' column header in the Bulk file
StreetAddress = "1234 Washington Place",
// 'Address Line 2' column header in the Bulk file
StreetAddress2 = "Suite 1210",
},
// 'Business Name' column header in the Bulk file
CompanyName = "Contoso Shoes",
// 'Geo Code Status' column header in the Bulk file
GeoCodeStatus = null,
GeoPoint = new GeoPoint
{
// 'Latitude' column header in the Bulk file
LatitudeInMicroDegrees = 0,
// 'Longitude' column header in the Bulk file
LongitudeInMicroDegrees = 0,
},
// 'Id' column header in the Bulk file
Id = locationAdExtensionIdKey,
// 'Phone Number' column header in the Bulk file
PhoneNumber = "206-555-0100",
// '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(bulkLocationAdExtension);
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 di annunci di posizione , i campi dell'attributo seguenti sono disponibili nello schema file bulk.
- Pianificazione annunci
- Riga indirizzo 1
- Riga indirizzo 2
- Nome dell'azienda
- Città
- Client Id
- Codice paese
- Posizione editoriale
- Codice motivo editoriale
- Stato editoriale
- Termine editoriale
- Data di fine
- Stato del codice geografico
- Id
- Latitudine
- Longitudine
- Ora modifica
- Parent Id
- Numero di telefono
- CAP
- Nome provincia
- Paesi di pubblicazione
- Data inizio
- Codice di stato o provincia
- Stato
- 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, 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
Riga indirizzo 1
Prima riga dell'indirizzo.
La prima riga può contenere un massimo di 80 caratteri.
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura
Riga indirizzo 2
Seconda riga dell'indirizzo.
La seconda riga può contenere un massimo di 80 caratteri.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.
Elimina: Sola lettura
Nome dell'azienda
Nome dell'azienda.
Il nome può contenere un massimo di 80 caratteri.
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura
Città
Nome della città in cui si trova l'indirizzo della strada.
Il nome può contenere un massimo di 80 caratteri.
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
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
Country Code
Paese o area geografica in cui si trova l'indirizzo stradale.
Il codice paese deve contenere un codice paese di 2 caratteri. I valori di codice paese supportati includono AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE e VN.
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
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.
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
Stato del codice geografico
Valore di stato che indica se sono state determinate le coordinate di latitudine e longitudine dell'azienda.
Se si specificano le coordinate, lo stato verrà impostato su Completa. in caso contrario, lo stato indicherà lo stato di determinazione delle coordinate dell'indirizzo aziendale specificato.
I valori possibili sono descritti nella tabella seguente.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
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 dell'annuncio della posizione della 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
Latitudine
La latitudine specificata in gradi. La latitudine deve essere maggiore o uguale a -85 e minore o uguale a +85.
Nota
Il servizio Campaign Management usa micro gradi, ad esempio da -850000000 a 850000000. Quando si usa BulkLocationAdExtension tramite gli SDK, è necessario usare i micro gradi, perché l'implementazione bulkLocationAdExtension converte da micro gradi e scrive il valore come gradi nel file bulk.
Le coordinate di latitudine e longitudine vengono usate per contrassegnare la posizione dell'azienda in Bing Mappe quando l'utente fa clic sull'indirizzo nell'annuncio. Se le coordinate specificate non rientrano nell'intervallo di valori validi, il servizio determina le coordinate in base all'indirizzo.
Se si specificano le coordinate note, il servizio non verifica se le coordinate specificate corrispondono all'indirizzo aziendale specificato. Se non si specificano le coordinate, il servizio Bulk usa l'indirizzo delle aziende per determinare le coordinate.
Nota
Quando si aggiungono più di 10 estensioni degli annunci di posizione, il servizio risolve le coordinate offline e in caso contrario risolve le coordinate in anticipo durante l'esecuzione dell'operazione del servizio. La posizione non verrà usata in un annuncio fino a quando non vengono determinate le coordinate, che possono richiedere da secondi a minuti a seconda del numero di estensioni degli annunci di posizione aggiunte e della domanda corrente.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
Longitudine
Longitudine specificata in gradi. La longitudine deve essere maggiore o uguale a -180 e minore o uguale a +180.
Nota
Il servizio Campaign Management usa micro gradi, ad esempio da -1800000000 a 1800000000. Quando si usa BulkLocationAdExtension tramite gli SDK, è necessario usare i micro gradi, perché l'implementazione bulkLocationAdExtension converte da micro gradi e scrive il valore come gradi nel file bulk.
Le coordinate di latitudine e longitudine vengono usate per contrassegnare la posizione dell'azienda in Bing Mappe quando l'utente fa clic sull'indirizzo nell'annuncio. Se le coordinate specificate non rientrano nell'intervallo di valori validi, il servizio determina le coordinate in base all'indirizzo.
Se si specificano le coordinate note, il servizio non verifica se le coordinate specificate corrispondono all'indirizzo aziendale specificato. Se non si specificano le coordinate, il servizio Bulk usa l'indirizzo delle aziende per determinare le coordinate.
Nota
Quando si aggiungono più di 10 estensioni degli annunci di posizione, il servizio risolve le coordinate offline e in caso contrario risolve le coordinate in anticipo durante l'esecuzione dell'operazione del servizio. La posizione non verrà usata in un annuncio fino a quando non vengono determinate le coordinate, che possono richiedere da secondi a minuti a seconda del numero di estensioni degli annunci di posizione aggiunte e della domanda corrente.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
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
Numero di telefono
Numero di telefono cliccabile dell'azienda da includere nell'annuncio.
Il numero di telefono può contenere un massimo di 35 caratteri e deve essere valido per il paese o l'area geografica specificati.
Se la campagna include anche un'estensione di chiamata, il numero di telefono nell'estensione della chiamata sostituirà il numero di telefono dell'estensione dell'annuncio della posizione.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
CAP
Codice postale o cap.
Il codice postale può contenere un massimo di 80 caratteri.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.
Elimina: Sola lettura
Nome provincia
Nome dello stato o della provincia in cui si trova l'indirizzo della strada, ad esempio Washington.
Il nome può contenere un massimo di 50 caratteri.
È necessario specificare Nome provincia o Stato o Codice provincia.
Nota
Il codice di stato o provincia e il nome della provincia non sono obbligatori se il campo Country Code è impostato su FR, IE o SG.
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
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
Codice di stato o provincia
Codice che identifica lo stato o la provincia in cui si trova l'indirizzo stradale, ad esempio WA.
Il codice può contenere un massimo di 50 caratteri.
È necessario specificare Nome provincia o Stato o Codice provincia.
Nota
Il codice di stato o provincia e il nome della provincia non sono obbligatori se il campo Country Code è impostato su FR, IE o SG.
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
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.
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
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