Record di estensione annunci prezzo - Bulk
Definisce un'estensione dell'annuncio che include tra 3 e 8 righe della tabella prezzi.
Puoi associare un'estensione per gli annunci di prezzo 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 20 estensioni pubblicitarie di prezzo. Usa l'estensione dell'annuncio prezzo dell'account, l'estensione per gli annunci con prezzo del gruppo di annunci e i record dell'estensione per gli annunci del prezzo della campagna per gestire le associazioni di estensione degli annunci di prezzo.
È possibile scaricare tutti i record dell'estensione Price Ad nell'account includendo il valore DownloadEntity di PriceAdExtensions 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 prezzo alla libreria condivisa dell'account.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Tracking Template,Final Url Suffix,Custom Parameter,Price Extension Type,Currency Code 1,Currency Code 2,Currency Code 3,Currency Code 4,Currency Code 5,Currency Code 6,Currency Code 7,Currency Code 8,Price Description 1,Price Description 2,Price Description 3,Price Description 4,Price Description 5,Price Description 6,Price Description 7,Price Description 8,Header 1,Header 2,Header 3,Header 4,Header 5,Header 6,Header 7,Header 8,Final Mobile Url 1,Final Mobile Url 2,Final Mobile Url 3,Final Mobile Url 4,Final Mobile Url 5,Final Mobile Url 6,Final Mobile Url 7,Final Mobile Url 8,Final Url 1,Final Url 2,Final Url 3,Final Url 4,Final Url 5,Final Url 6,Final Url 7,Final Url 8,Price 1,Price 2,Price 3,Price 4,Price 5,Price 6,Price 7,Price 8,Price Qualifier 1,Price Qualifier 2,Price Qualifier 3,Price Qualifier 4,Price Qualifier 5,Price Qualifier 6,Price Qualifier 7,Price Qualifier 8,Price Unit 1,Price Unit 2,Price Unit 3,Price Unit 4,Price Unit 5,Price Unit 6,Price Unit 7,Price Unit 8
Format Version,,,,,,,,,,,6.0,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
Price Ad Extension,,-24,,,,ClientIdGoesHere,,,,,,(Monday[09:00-21:00]),FALSE,,,{_promoCode}=PROMO1; {_season}=summer,Events,USD,USD,USD,,,,,,Come to the event,Come to the next event,Come to the final event,,,,,,New Event,Next Event,Final Event,,,,,,,,,,,,,,https://contoso.com,https://contoso.com,https://contoso.com,,,,,,9.99,9.99,9.99,,,,,,From,From,From,,,,,,PerDay,PerDay,PerDay,,,,,
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkPriceAdExtension , 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 BulkPriceAdExtension
var bulkPriceAdExtension = new BulkPriceAdExtension
{
// '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
// PriceAdExtension object of the Campaign Management service.
PriceAdExtension = new PriceAdExtension
{
// 'Language' column header in the Bulk file
Language = "English",
// 'Id' column header in the Bulk file
Id = priceAdExtensionIdKey,
// 'Price Extension Type' column header in the Bulk file
PriceExtensionType = PriceExtensionType.Events,
// '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,
// TableRows must include between 3 and 8 PriceTableRow
TableRows = new PriceTableRow[]
{
// Each PriceTableRow is mapped to columns with suffix 1..8.
// This example shows 3 price table rows i.e., with column suffix from 1..3
new PriceTableRow
{
// 'Currency Code 1' column header in the Bulk file
CurrencyCode = "USD",
// 'Price Description 1' column header in the Bulk file
Description = "Come to the new event",
// 'Final Url 1' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://www.contoso.com/womenshoesale"
},
// 'Final Mobile Url 1' column header in the Bulk file
FinalMobileUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://mobile.contoso.com/womenshoesale"
},
// 'Header 1' column header in the Bulk file
Header = "New Event",
// 'Price 1' column header in the Bulk file
Price = 9.99,
// 'Price Qualifier 1' column header in the Bulk file
PriceQualifier = PriceQualifier.From,
// 'Price Unit 1' column header in the Bulk file
PriceUnit = PriceUnit.PerDay,
},
new PriceTableRow
{
// 'Currency Code 2' column header in the Bulk file
CurrencyCode = "USD",
// 'Price Description 2' column header in the Bulk file
Description = "Come to the next event",
// 'Final Url 2' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://www.contoso.com/womenshoesale"
},
// 'Final Mobile Url 2' column header in the Bulk file
FinalMobileUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://mobile.contoso.com/womenshoesale"
},
// 'Header 2' column header in the Bulk file
Header = "Next Event",
// 'Price 2' column header in the Bulk file
Price = 9.99,
// 'Price Qualifier 2' column header in the Bulk file
PriceQualifier = PriceQualifier.From,
// 'Price Unit 2' column header in the Bulk file
PriceUnit = PriceUnit.PerDay,
},
new PriceTableRow
{
// 'Currency Code 3' column header in the Bulk file
CurrencyCode = "USD",
// 'Price Description 3' column header in the Bulk file
Description = "Come to the final event",
// 'Final Url 3' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://www.contoso.com/womenshoesale"
},
// 'Final Mobile Url 3' column header in the Bulk file
FinalMobileUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://mobile.contoso.com/womenshoesale"
},
// 'Header 3' column header in the Bulk file
Header = "Final Event",
// 'Price 3' column header in the Bulk file
Price = 9.99,
// 'Price Qualifier 3' column header in the Bulk file
PriceQualifier = PriceQualifier.From,
// 'Price Unit 3' column header in the Bulk file
PriceUnit = PriceUnit.PerDay,
},
},
// '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(bulkPriceAdExtension);
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 price ad extension , i campi dell'attributo seguenti sono disponibili nello schema file bulk.
- Pianificazione annunci
- Client Id
- Codice valuta (1-8)
- Parametro personalizzato
- Posizione editoriale
- Codice motivo editoriale
- Stato editoriale
- Termine editoriale
- Data di fine
- URL finale per dispositivi mobili (1-8)
- URL finale (1-8)
- Intestazione (1-8)
- Suffisso URL finale
- Id
- Lingua
- Ora modifica
- Parent Id
- Prezzo (1-8)
- Descrizione prezzo (1-8)
- Tipo di estensione prezzo
- Qualificatore di prezzo (1-8)
- Price Unit (1-8)
- Paesi di pubblicazione
- Data inizio
- Stato
- Modello di rilevamento
- 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
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
Codice valuta (1-8)
Il file bulk include fino a 8 colonne di codice di valuta, ad esempio una per ogni elemento della tabella prezzi nell'estensione dell'annuncio. Le intestazioni di colonna del file bulk sono Currency Code 1, Currency Code 2, Currency Code 3, Currency Code 4, Currency Code 5, Currency Code 6, Currency Code 7 e Currency Code 8.
I codici di valuta supportati sono ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, GBP, HKD, INR, MXN, NZD, PEN, PHP, PLN, SEK, SGD, USD, TWD e VEF.
Devi avere tra 3 e 8 elementi della tabella dei prezzi per l'estensione dell'annuncio di prezzo. L'ordine in cui li crei è l'ordine previsto nell'annuncio, ma l'ordine non è garantito. Tutti gli elementi della tabella prezzi per un'estensione pubblicitaria di prezzo devono trovarsi nello stesso record di file bulk. Ogni elemento della tabella prezzi viene mappato allo stesso indice delle colonne Currency Code, Final Mobile URL, Final Url, Header, Price, Price Description, Price Unit e Price Qualifier . Ad esempio, il primo elemento della tabella prezzi viene mappato alle colonne Currency Code 1, Final Mobile Url 1, Final Url 1, Header 1, Price 1, Price Description 1, Price Unit 1 e Price Qualifier 1 .
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
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 3 coppie di chiavi e valori dei parametri personalizzati incluse e tutti i parametri personalizzati aggiuntivi verranno ignorati. Per i clienti del progetto pilota Custom Parameters Limit Increase Phase 3 (GetCustomerPilotFeatures restituisce 635), Microsoft Advertising accetterà le prime 8 coppie di parametri personalizzati e valore 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 200 byte UTF-8. Per i clienti del progetto pilota Custom Parameters Limit Increase Phase 3 (GetCustomerPilotFeatures restituisce 635), il limite valore aumenta a 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, 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.
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
URL finale per dispositivi mobili (1-8)
Il file bulk include fino a 8 colonne url per dispositivi mobili finali, ad esempio una per ogni elemento della tabella dei prezzi nell'estensione dell'annuncio. Le intestazioni di colonna del file bulk sono Final Mobile Url 1, Final Mobile Url 2, Final Mobile Url 3, Final Mobile Url 4, Final Mobile Url 5, Final Mobile Url 6, Final Mobile Url 7 e Final Mobile Url 8.
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 elementi sia per gli URL finali che per gli URL finali per dispositivi mobili. tuttavia, per il recapito viene usato solo il primo elemento di ogni elenco. Il servizio consente fino a 10 per una potenziale compatibilità in avanti.
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}".
Ogni URL deve essere un URL ben formato a partire da http:// o https://.
Se si specificano gli URL finali per dispositivi mobili, è necessario specificare anche l'URL finale.
Devi avere tra 3 e 8 elementi della tabella dei prezzi per l'estensione dell'annuncio di prezzo. L'ordine in cui li crei è l'ordine previsto nell'annuncio, ma l'ordine non è garantito. Tutti gli elementi della tabella prezzi per un'estensione pubblicitaria di prezzo devono trovarsi nello stesso record di file bulk. Ogni elemento della tabella prezzi viene mappato allo stesso indice delle colonne Currency Code, Final Mobile URL, Final Url, Header, Price, Price Description, Price Unit e Price Qualifier . Ad esempio, il primo elemento della tabella prezzi viene mappato alle colonne Currency Code 1, Final Mobile Url 1, Final Url 1, Header 1, Price 1, Price Description 1, Price Unit 1 e Price Qualifier 1 .
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.
Elimina: Sola lettura
URL finale (1-8)
Il file bulk include fino a 8 colonne url finali, ad esempio una per ogni elemento della tabella dei prezzi nell'estensione dell'annuncio. Le intestazioni di colonna del file bulk sono Url finale 1, Url finale 2, Url finale 3, Url finale 4, Url finale 5, Url finale 6, Url finale 7 e Url finale 8.
URL della pagina di destinazione da usare con il modello di rilevamento facoltativo e i parametri personalizzati.
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 elementi sia per gli URL finali che per gli URL finali per dispositivi mobili. tuttavia, per il recapito viene usato solo il primo elemento di ogni elenco. Il servizio consente fino a 10 per una potenziale compatibilità in avanti.
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}".
Ogni URL deve essere un URL ben formato a partire da http:// o https://.
Se si specificano gli URL finali per dispositivi mobili, è necessario specificare anche l'URL finale.
Si noti inoltre che se i campi Modello di rilevamento o Parametro personalizzato sono impostati, l'URL finale è necessario per ogni voce della tabella prezzi.
Devi avere tra 3 e 8 elementi della tabella dei prezzi per l'estensione dell'annuncio di prezzo. L'ordine in cui li crei è l'ordine previsto nell'annuncio, ma l'ordine non è garantito. Tutti gli elementi della tabella prezzi per un'estensione pubblicitaria di prezzo devono trovarsi nello stesso record di file bulk. Ogni elemento della tabella prezzi viene mappato allo stesso indice delle colonne Currency Code, Final Mobile URL, Final Url, Header, Price, Price Description, Price Unit e Price Qualifier . Ad esempio, il primo elemento della tabella prezzi viene mappato alle colonne Currency Code 1, Final Mobile Url 1, Final Url 1, Header 1, Price 1, Price Description 1, Price Unit 1 e Price Qualifier 1 .
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura
Intestazione (1-8)
Intestazione che precede i dati sui prezzi nell'estensione dell'annuncio del prezzo. Ogni intestazione può contenere un massimo di 25 caratteri. Ogni intestazione deve collegarsi direttamente al campo Tipo di estensione prezzo per l'estensione dell'annuncio prezzo.
Il file bulk include fino a 8 colonne di intestazione, ad esempio una per ogni elemento della tabella prezzi nell'estensione dell'annuncio. Le intestazioni di colonna del file bulk sono Header 1, Header 2, Header 3, Header 4, Header 5, Header 6, Header 7 e Header 8.
Devi avere tra 3 e 8 elementi della tabella dei prezzi per l'estensione dell'annuncio di prezzo. L'ordine in cui li crei è l'ordine previsto nell'annuncio, ma l'ordine non è garantito. Tutti gli elementi della tabella prezzi per un'estensione pubblicitaria di prezzo devono trovarsi nello stesso record di file bulk. Ogni elemento della tabella prezzi viene mappato allo stesso indice delle colonne Currency Code, Final Mobile URL, Final Url, Header, Price, Price Description, Price Unit e Price Qualifier . Ad esempio, il primo elemento della tabella prezzi viene mappato alle colonne Currency Code 1, Final Mobile Url 1, Final Url 1, Header 1, Price 1, Price Description 1, Price Unit 1 e Price Qualifier 1 .
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
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.
Nota
Questa funzionalità è disponibile solo per i clienti nel progetto pilota Final URL Suffix Phase 3 (GetCustomerPilotFeatures restituisce 636). Se non si è nel progetto pilota, questa proprietà verrà ignorata e non verrà restituito alcun errore.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.
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 per il prezzo del gruppo di annunci e l'estensione dell'annuncio del prezzo 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
Lingua
Lingua per la copia pubblicitaria dell'estensione dell'annuncio del prezzo.
Per i valori possibili, vedi Lingue degli annunci.
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
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
Prezzo (1-8)
Il prezzo che stai facendo pubblicità.
Il file bulk include fino a 8 colonne di prezzo, ad esempio una per ogni elemento della tabella dei prezzi nell'estensione dell'annuncio. Le intestazioni di colonna del file bulk sono Price 1, Price 2, Price 3, Price 4, Price 5, Price 6, Price 7 e Price 8.
Devi avere tra 3 e 8 elementi della tabella dei prezzi per l'estensione dell'annuncio di prezzo. L'ordine in cui li crei è l'ordine previsto nell'annuncio, ma l'ordine non è garantito. Tutti gli elementi della tabella prezzi per un'estensione pubblicitaria di prezzo devono trovarsi nello stesso record di file bulk. Ogni elemento della tabella prezzi viene mappato allo stesso indice delle colonne Currency Code, Final Mobile URL, Final Url, Header, Price, Price Description, Price Unit e Price Qualifier . Ad esempio, il primo elemento della tabella prezzi viene mappato alle colonne Currency Code 1, Final Mobile Url 1, Final Url 1, Header 1, Price 1, Price Description 1, Price Unit 1 e Price Qualifier 1 .
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura
Descrizione prezzo (1-8)
La descrizione deve fornire ulteriori informazioni sull'intestazione definita anche in questo oggetto. Ogni descrizione può contenere un massimo di 25 caratteri.
Il file bulk include fino a 8 colonne di descrizione del prezzo, ad esempio una per ogni elemento della tabella prezzi nell'estensione dell'annuncio. Le intestazioni di colonna del file bulk sono Price Description 1, Price Description 2, Price Description 3, Price Description 4, Price Description 5, Price Description 6, Price Description 7 e Price Description 8.
Devi avere tra 3 e 8 elementi della tabella dei prezzi per l'estensione dell'annuncio di prezzo. L'ordine in cui li crei è l'ordine previsto nell'annuncio, ma l'ordine non è garantito. Tutti gli elementi della tabella prezzi per un'estensione pubblicitaria di prezzo devono trovarsi nello stesso record di file bulk. Ogni elemento della tabella prezzi viene mappato allo stesso indice delle colonne Currency Code, Final Mobile URL, Final Url, Header, Price, Price Description, Price Unit e Price Qualifier . Ad esempio, il primo elemento della tabella prezzi viene mappato alle colonne Currency Code 1, Final Mobile Url 1, Final Url 1, Header 1, Price 1, Price Description 1, Price Unit 1 e Price Qualifier 1 .
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura
Tipo di estensione prezzo
Tipo di estensione dell'annuncio del prezzo.
I valori possibili includono: Marchi, Eventi, Località, Quartieri, ProductCategories, ProductTiers, ServiceCategories, Servizi, ServiceTiers e Sconosciuto. Unknown è riservato per uso futuro e non può essere impostato.
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura
Qualificatore di prezzo (1-8)
Qualificatore di prezzo per un determinato prodotto o servizio, ad esempio, a partire da un prezzo specifico e fino a un prezzo massimo.
I valori possibili includono: Average, From, UpTo, None e Unknown. Unknown è riservato per uso futuro e non può essere impostato.
Il file bulk include fino a 8 colonne di qualificatore di prezzo, ad esempio una per ogni elemento della tabella dei prezzi nell'estensione dell'annuncio. Le intestazioni di colonna del file bulk sono Price Qualifier 1, Price Qualifier 2, Price Qualifier 3, Price Qualifier 4, Price Qualifier 5, Price Qualifier 6, Price Qualifier 7 e Price Qualifier 8.
Devi avere tra 3 e 8 elementi della tabella dei prezzi per l'estensione dell'annuncio di prezzo. L'ordine in cui li crei è l'ordine previsto nell'annuncio, ma l'ordine non è garantito. Tutti gli elementi della tabella prezzi per un'estensione pubblicitaria di prezzo devono trovarsi nello stesso record di file bulk. Ogni elemento della tabella prezzi viene mappato allo stesso indice delle colonne Currency Code, Final Mobile URL, Final Url, Header, Price, Price Description, Price Unit e Price Qualifier . Ad esempio, il primo elemento della tabella prezzi viene mappato alle colonne Currency Code 1, Final Mobile Url 1, Final Url 1, Header 1, Price 1, Price Description 1, Price Unit 1 e Price Qualifier 1 .
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura
Price Unit (1-8)
L'unità di prezzo consente di specificare il costo in termini di ora, giorno, settimana e così via.
I valori possibili includono: PerDay, PerHour, PerMonth, PerNight, PerWeek, PerYear, None e Unknown. Unknown è riservato per uso futuro e non può essere impostato.
Il file bulk include fino a 8 colonne di unità di prezzo, ad esempio una per ogni elemento della tabella dei prezzi nell'estensione dell'annuncio. Le intestazioni di colonna del file bulk sono Price Unit 1, Price Unit 2, Price Unit 3, Price Unit 4, Price Unit 5, Price Unit 6, Price Unit 7 e Price Unit 8.
Devi avere tra 3 e 8 elementi della tabella dei prezzi per l'estensione dell'annuncio di prezzo. L'ordine in cui li crei è l'ordine previsto nell'annuncio, ma l'ordine non è garantito. Tutti gli elementi della tabella prezzi per un'estensione pubblicitaria di prezzo devono trovarsi nello stesso record di file bulk. Ogni elemento della tabella prezzi viene mappato allo stesso indice delle colonne Currency Code, Final Mobile URL, Final Url, Header, Price, Price Description, Price Unit e Price Qualifier . Ad esempio, il primo elemento della tabella prezzi viene mappato alle colonne Currency Code 1, Final Mobile Url 1, Final Url 1, Header 1, Price 1, Price Description 1, Price Unit 1 e Price Qualifier 1 .
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
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.
Modello di rilevamento
Modello di rilevamento da usare per gli URL dell'elemento della tabella prezzi.
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, l'impostazione precedente viene rimossa.
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
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