Condividi tramite

Record di dichiarazione di non responsabilità - Bulk

  • Articolo

Definisce una dichiarazione di non responsabilità che può essere scaricata e caricata in un file bulk.

È possibile associare una dichiarazione di non responsabilità a una campagna nell'account. Usare i record di dichiarazione di non responsabilità della campagna per gestire le associazioni di dichiarazione di non responsabilità.

È possibile scaricare tutti i record Disclaimer Ad Extension nell'account includendo il valore DownloadEntity di DisclaimerAdExtensions 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 dichiarazione di non responsabilità alla libreria condivisa dell'account.

Type,Status,Id,Parent Id,Campaign,Client Id,Modified Time,Start Date,End Date,Ad Schedule,Use Searcher Time Zone,Disclaimer Layout,Name,Popup Text,Title,Final Url,Mobile Final Url
Format Version,,,,,,,,,,,6.0,,,,,,
Disclaimer Ad Extension,Active,-18,0,,,ClientIdGoesHere,,,12/31/2020,English,,(Monday[09:00-21:00]),FALSE,Amenities,ValueOne;ValueTwo;ValueThree,https://www.contoso.com/one; https://www.contoso.com/two; https://www.contoso.com/three,https://mobile.contoso.com/one; https://mobile.contoso.com/two; https://mobile.contoso.com/three

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkDisclaimerAdExtension , 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 BulkDisclaimerAdExtension
var bulkDisclaimerAdExtension = new BulkDisclaimerAdExtension
{
    // '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 
    // DisclaimerAdExtension object of the Campaign Management service.
    DisclaimerAdExtension = new DisclaimerAdExtension
    {
        // 'DisclaimerLayout' column header in the Bulk file
        DisclaimerLayout = "additionalLine",
        // 'Id' column header in the Bulk file
        Id = disclaimerAdExtensionIdKey,
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/one",
            "https://www.contoso.com/two",
            "https://www.contoso.com/three"
        },
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/one",
            "https://mobile.contoso.com/two",
            "https://mobile.contoso.com/three"
        },
        // 'Name' column header in the Bulk file
        Name = "DisclaimerName",
        // 'PopupText' column header in the Bulk file
        PopupText = "DisclaimerPopupText",
        // 'Title' column header in the Bulk file
        Title = "Disclaimer info",
        // '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(bulkDisclaimerAdExtension);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Per un record di dichiarazione di non responsabilità , i campi dell'attributo seguenti sono disponibili nello schema del file bulk.

Pianificazione annunci

Elenco degli intervalli di giorno e di ora in cui vuoi che il record venga visualizzato 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 si imposta questo campo, il record sarà idoneo 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

Layout della dichiarazione di non responsabilità

Layout della dichiarazione di non responsabilità. Può essere additionalLine o popup.

Posizione editoriale

Componente o proprietà del record 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

Lo stato editoriale del record.

I valori possibili sono descritti nella tabella seguente.

Valore Descrizione
Attivazione Il record ha superato la revisione editoriale.
ActiveLimited Il record ha superato la revisione editoriale in uno o più mercati, e uno o più elementi del record sono in fase di revisione editoriale in un altro mercato. Ad esempio, il record ha superato la revisione editoriale per il Canada ed è ancora in attesa di revisione nel Stati Uniti.
Approvato La recensione editoriale non è riuscita.
Inattivo Uno o più elementi del disco 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 del record formattata come MM/DD/AAAAA.

La data di fine è inclusiva. Ad esempio, se si imposta questo campo su 31/12/2020, i record smetteranno di essere visualizzati alle 23:59 del 31/12/2020.

Aggiungere: Opzionale. Se non specifichi una data di fine, il record continuerà a essere recapitato a meno che tu 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

Id

Identificatore generato dal sistema del record.

Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. È quindi possibile fare riferimento a un identificatore negativo impostato per il record nel campo ID dei tipi di record dipendenti, ad esempio e Dichiarazione di non responsabilità della campagna. Questa operazione è consigliata se si aggiungono nuovi record 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

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

Nome

Nome della dichiarazione di non responsabilità. Viene usato solo per la creazione di report per identificare il record.

Max. lunghezza: 35 caratteri.

Parent Id

Identificatore generato dal sistema dell'account che contiene il record.

Questo campo bulk esegue il mapping al campo ID del record account .

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

Testo popup

Testo obbligatorio se la dichiarazione di non responsabilità è nel layout popup .

Max. lunghezza: 500 caratteri.

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 del record formattata come MM/DD/AAAA.

La data di inizio è inclusiva. Ad esempio, se si imposta StartDate su 5/5/2020, i record inizieranno a essere visualizzati alle 12:00 del 5/5/2020.

Aggiungere: Opzionale. Se non si specifica una data di inizio, il record è immediatamente idoneo per essere pianificato.
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 si imposta questo campo sulla stringa delete_value , si rimuove effettivamente la data di inizio e il record è immediatamente idoneo per la pianificazione. 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 del record.

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.

Titolo

Titolo del popup nel layout popup.

Max. lunghezza: 75 caratteri.

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 si desidera visualizzare i record nel fuso orario dell'utente di ricerca e impostarla in caso contrario 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 del record è stato aggiornato. La versione è impostata su 1 quando si aggiunge il record e viene incrementata ogni volta che viene rivista.

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