Record estensione annunci promozione - Bulk
Definisce un'estensione dell'annuncio promozionale che può essere scaricata e caricata in un file bulk.
Nota
Le estensioni per la promozione sono disponibili per i clienti in AU, CA, DE, FR, US e Regno Unito.
Puoi associare un'estensione dell'annuncio promozionale 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 promozionali. Usa l'estensione dell'annuncio per la promozione dell'account, l'estensione dell'annuncio di promozione del gruppo di annunci pubblicitari e i record dell'estensione per gli annunci di promozione della campagna per gestire le associazioni di estensione degli annunci promozionali.
È possibile scaricare tutti i record dell'estensione annunci di promozione nell'account includendo il valore DownloadEntity di PromotionAdExtensions 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 promozionali alla libreria condivisa dell'account.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Language,Start Date,End Date,Name,Version,Ad Schedule,Use Searcher Time Zone,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Promotion Target,Discount Modifier,Percent Off,Money Amount Off,Promotion Code,Orders Over Amount,Occasion,Promotion Start,Promotion End,Currency Code
Format Version,,,,,,,,,,,6,,,,,,,,,,,,,,,,,
Promotion Ad Extension,Active,-25,0,,,ClientIdGoesHere,,English,,12/31/2021,,,(Monday[09:00-21:00]),FALSE,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,shoes,None,20000000,,SAVE20,,WomensDay,,12/31/2021,USD
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkPromotionAdExtension , 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 BulkPromotionAdExtension
var bulkPromotionAdExtension = new BulkPromotionAdExtension
{
// '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
// PromotionAdExtension object of the Campaign Management service.
PromotionAdExtension = new PromotionAdExtension
{
// 'Id' column header in the Bulk file
Id = promotionAdExtensionIdKey,
// 'Currency Code' column header in the Bulk file
CurrencyCode = "USD",
// 'Discount Modifier' column header in the Bulk file
DiscountModifier = PromotionDiscountModifier.None,
// 'Language' column header in the Bulk file
Language = "English",
// 'Money Amount Off' column header in the Bulk file
MoneyAmountOff = null,
// 'Orders Over Amount' column header in the Bulk file
OrdersOverAmount = null,
// 'Percent Off' column header in the Bulk file
PercentOff = 20000000,
// 'Promotion Code' column header in the Bulk file
PromotionCode = "SAVE20",
// 'Promotion Target' column header in the Bulk file
PromotionItem = "shoes",
// 'Occasion' column header in the Bulk file
PromotionOccasion = PromotionOccasion.WomensDay,
// 'Promotion End' column header in the Bulk file
PromotionEndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Promotion Start' column header in the Bulk file
PromotionStartDate = null,
// '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/womenshoesale"
},
// '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/womenshoesale"
},
// '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(bulkPromotionAdExtension);
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 promotion ad extension , i campi dell'attributo seguenti sono disponibili nello schema file bulk.
- Pianificazione annunci
- Client Id
- Codice valuta
- Parametro personalizzato
- Modificatore discount
- Posizione editoriale
- Codice motivo editoriale
- Stato editoriale
- Termine editoriale
- Data di fine
- URL finale
- Suffisso URL finale
- Id
- Lingua
- URL finale per dispositivi mobili
- Ora modifica
- Importo in denaro disattivato
- Occasione
- Ordini su importo
- Parent Id
- Paesi di pubblicazione
- Codice promozione
- Fine promozione
- Inizio promozione
- Obiettivo promozione
- 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
Codice di valuta per il prezzo o lo sconto della promozione.
Questo campo è applicabile solo se si imposta Money Amount Off o Orders Over Amount.This field is applicable only if you set Money Amount Off or Orders Over Amount.
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.
Aggiungere: Obbligatorio se l'importo in denaro è disattivato o se sono impostati ordini su importo .
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta Percentuale di off o Codice promozione, questa impostazione non è più applicabile e verrà eliminata.
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, questa impostazione non viene modificata. Per rimuovere tutti i parametri personalizzati, impostare questo campo su delete_value. La parola chiave delete_value rimuove l'impostazione precedente. Per rimuovere un subset di parametri personalizzati, specificare i parametri personalizzati che si desidera mantenere e omettere eventuali parametri che non si desidera mantenere. Il nuovo set di parametri personalizzati sostituirà qualsiasi set di parametri personalizzato precedente.
Elimina: Sola lettura
Modificatore discount
Modificatore sconto promozione.
I valori possibili per questo campo sono Nessuno e UpTo.
- Nessuno: lo sconto per la promozione non viene modificato.
- UpTo: lo sconto per la promozione viene modificato con il prefisso stringa "Up to". Ad esempio, se lo sconto promozionale non modificato è "$20 off shoes", la promozione modificata è "Fino a $20 off shoes".
Aggiungere: Opzionale. Se non si specifica questo campo o lo si lascia vuoto, verrà impostato il valore predefinito Nessuno .
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
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
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
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, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura
Id
Identificatore generato dal sistema dell'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 per gli annunci di promozione del gruppo di annunci pubblicitari e l'estensione dell'annuncio di promozione 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 in cui verrà servita l'estensione dell'annuncio.
L'estensione verrà sempre fornita in questa lingua, indipendentemente dalle impostazioni della lingua della campagna o del gruppo di annunci.
Le stringhe di lingua supportate sono: danese, olandese, inglese, finlandese, francese, tedesco, italiano, norvegese, portoghese, spagnolo, svedese e tradizionaleChinese.
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
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
Importo in denaro disattivato
Il denaro fuori valore di promozione.
Ad esempio, per alzare di livello "$20 off shoes - On orders over $100", impostare La destinazione promozione su "shoes", impostare Currency Code su "USD", impostare Money Amount Off su 20 e impostare Orders Over Amount su 100.
Aggiungere: Obbligatorio. È necessario impostare Money Amount Off o Percent Off, ma non è possibile impostare entrambi.
Aggiornamento: Opzionale. È possibile impostare Money Amount Off o Percent Off, ma non è possibile impostare entrambi.
Elimina: Sola lettura
Occasione
L'occasione di promozione.
Sia i campi promozione Occasione e Pianificazione (Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher ) determinano quando la promozione è idonea per essere visualizzata negli annunci.
L'occasione di promozione determina il periodo di tempo o la stagionalità, ad esempio WomensDay dal 15 febbraio al 31 marzo di ogni anno. La promozione verrà eseguita solo entro le date corrispondenti all'occasione impostata. Per informazioni dettagliate sull'intervallo di date definito per ogni occasione, vedere la tabella seguente.
La pianificazione può limitare la promozione a un intervallo di tempo più breve entro l'intervallo di date dell'occasione, ad esempio limitare la promozione dal 20 febbraio all'8 marzo. La pianificazione può essere usata anche per eseguire la stessa promozione per più anni, ad esempio, eseguire la promozione WomensDay ogni anno dal 15 febbraio al 31 marzo.
Aggiungere: Opzionale. Se non si specifica questo campo o lo si lascia vuoto, verrà impostato il valore predefinito Nessuno .
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo, è necessario impostare anche Inizio promozione e Fine promozione per mantenere o aggiornare le impostazioni precedenti.
Elimina: Sola lettura
Ordini su importo
Ordini rispetto al valore dell'importo accodati alla destinazione di promozione.
Ad esempio, per alzare di livello "$20 off shoes - On orders over $100", impostare La destinazione promozione su "shoes", impostare Currency Code su "USD", impostare Money Amount Off su 20 e impostare Orders Over Amount su 100.
Aggiungere: Opzionale. Non è possibile impostare sia Ordini per importo che Codice promozione.
Aggiornamento: Opzionale. Non è possibile impostare sia Ordini per importo che Codice promozione. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo su '0' (zero), l'impostazione precedente verrà eliminata.
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
Percentuale disattivata
Percentuale di off promotion value come valore double.
Ad esempio, 10,0 rappresenta uno sconto del 10%.
Aggiungere: Obbligatorio. È necessario impostare Money Amount Off o Percent Off, ma non è possibile impostare entrambi.
Aggiornamento: Opzionale. È possibile impostare Money Amount Off o Percent Off, ma non è possibile impostare entrambi. Se si imposta questo campo, l'impostazione Codice valuta non è più applicabile e verrà eliminata se è stata impostata in precedenza.
Elimina: Sola lettura
Codice promozione
Codice di promozione aggiunto alla destinazione di promozione.
Ad esempio, per alzare di livello "$20 off shoes - Promocode SAVE20", impostare la destinazione di promozione su "shoes", impostare Currency Code su "USD", impostare Money Amount Off su 20 e impostare Promotion Code su "SAVE20".
La stringa può contenere un massimo di 15 caratteri.
Aggiungere: Opzionale. Non è possibile impostare sia Ordini per importo che Codice promozione.
Aggiornamento: Opzionale. Non è possibile impostare sia Ordini per importo che Codice promozione. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo su sulla stringa delete_value , l'impostazione precedente verrà eliminata. Se si imposta questo campo, l'impostazione Codice valuta non è più applicabile e verrà eliminata se è stata impostata in precedenza.
Elimina: Sola lettura
Fine promozione
La data di fine consente di informare la data di promozione o le date che verranno visualizzate nell'annuncio.
Ad esempio, se le date di inizio e fine promozione sono entrambe impostate sul 14 febbraio, il testo "Valido 14 febbraio" potrebbe essere incluso nella promozione visualizzata.
La data di inizio promozione deve essere precedente o uguale alla data di fine della promozione .
Questa proprietà non sostituisce l'intervallo di recapito intrinseco per una promozione. Sia l'occasione di promozione che la pianificazione (Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher) determinano quando la promozione è idonea per essere visualizzata negli annunci.
Se la data di fine è già passata per l'anno corrente, è necessario impostare ogni data di inizio e fine per le date dell'anno successivo.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per eliminare la data di fine corrente e impostare in modo efficace nessuna data di fine, impostare questo campo sulla stringa delete_value . Quando recuperi l'estensione dell'annuncio promozionale la prossima volta, questo campo non verrà impostato.
Elimina: Sola lettura
Inizio promozione
La data di inizio consente di informare la data di promozione o le date che verranno visualizzate nell'annuncio.
Ad esempio, se le date di inizio e fine promozione sono entrambe impostate sul 14 febbraio, il testo "Valido 14 febbraio" potrebbe essere incluso nella promozione visualizzata.
La data di inizio promozione deve essere precedente o uguale alla data di fine della promozione .
Questa proprietà non sostituisce l'intervallo di recapito intrinseco per una promozione. Sia l'occasione di promozione che la pianificazione (Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher) determinano quando la promozione è idonea per essere visualizzata negli annunci.
Se la data di fine è già passata per l'anno corrente, è necessario impostare ogni data di inizio e fine per le date dell'anno successivo.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per eliminare la data di fine corrente e impostare in modo efficace nessuna data di fine, impostare questo campo sulla stringa delete_value . Quando recuperi l'estensione dell'annuncio promozionale la prossima volta, questo campo non verrà impostato.
Elimina: Sola lettura
Obiettivo promozione
Destinazione o elemento di promozione.
Ad esempio, è possibile eseguire una promozione per "scarpe" con uno sconto di $20 o 20%. Per eseguire una promozione per "Fino a $20 off shoes", impostare l'obiettivo di promozione su "shoes", impostare il modificatore discount su "UpTo", impostare Currency Code su "USD" e impostare Money Amount Off su 20.
La stringa può contenere un massimo di 20 caratteri.
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
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 di promozione.
Le regole di convalida seguenti si applicano ai modelli di rilevamento. Per altre informazioni sui modelli e i parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?
I modelli di rilevamento definiti per le entità di livello inferiore, ad esempio gli annunci, sostituiscono quelli impostati per entità di livello superiore, ad esempio la campagna. Per altre informazioni, vedere Limiti delle entità.
La lunghezza del modello di rilevamento è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.
Il modello di rilevamento deve essere un URL ben formato che inizia con uno dei seguenti: http://, https://, {lpurl} o {unescapedlpurl}.
Microsoft Advertising non convalida l'esistenza di parametri personalizzati. Se si usano parametri personalizzati nel modello di rilevamento e non esistono, l'URL della pagina di destinazione includerà i segnaposto chiave e valore dei parametri personalizzati senza sostituzione. Ad esempio, se il modello di rilevamento è
https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}e non vengono definiti {_season} o {_promocode} a livello di campagna, gruppo di annunci, criterio, parola chiave o annuncio, l'URL della pagina di destinazione sarà lo stesso.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura
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