Condividi tramite

Record di estensione annunci prezzo - Bulk

  • Articolo

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

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.

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

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

Termine editoriale

Il termine che ha fallito revisione editoriale.

Questo campo non verrà impostato se una combinazione di termini ha causato l'errore o se l'errore è stato basato su una violazione dei criteri.

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

Data di fine

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

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

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

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 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