Record del criterio Campaign DayTime - Bulk

Articolo
12/21/2023

Definisce un criterio di giorno e ora della campagna che può essere caricato e scaricato in un file bulk.

Man mano che la campagna progredisce, potresti scoprire che il tasso di clic e il tasso di conversione sono più alti durante determinati periodi, ad esempio nei giorni feriali. Questa potrebbe essere un'opportunità perfetta per usare gli aggiustamenti delle offerte per migliorare le possibilità di visualizzare l'annuncio dal lunedì al venerdì dalle 18:00 alle 23:00. Quando si usa la destinazione in base all'ora, si sta puntando al fuso orario locale del searcher. Ad esempio, se aumenti l'offerta del 10% per le 18:00 alle 23:00, la rettifica dell'offerta sarà valida dalle 18:00 alle 23:00 ora orientale per i cercatori a New York, quindi sarà valida dalle 18:00 alle 23:00 ora del Pacifico per gli utenti di Seattle. Ora stai mostrando i tuoi annunci quando i tuoi potenziali clienti sono online!

Ogni criterio di giorno e ora definisce il giorno, dall'ora, dal minuto all'ora e ai requisiti dei minuti per la rettifica dell'offerta del criterio associato.

Nota

Non è possibile modificare i valori Target, From Hour, From Minute, To Hour o To Minute per un criterio esistente. Per modificare gli intervalli di giorno e di ora, è necessario eliminare il criterio e aggiungere un nuovo criterio.

Il numero massimo di criteri di giorno e ora che puoi specificare per campagna o gruppo di annunci è 49. Non è possibile specificare intervalli di giorno e ora sovrapposti, ad esempio lunedì dalle 3:00 alle 5:00 e lunedì dalle 4:00 alle 6:00 non sono consentiti per la stessa campagna o gruppo di annunci. Anche per una determinata campagna o gruppo di annunci, il numero massimo di criteri di giorno e ora per giorno che puoi specificare è sette. Ad esempio, è possibile specificare fino a 7 criteri di giorno e ora in cui il giorno è impostato su Lunedì.

Se vengono specificati criteri di giorno e ora a livello di gruppo di annunci, i criteri relativi al giorno e all'ora a livello di campagna vengono ignorati per tale gruppo di annunci. In altre parole, i criteri relativi al giorno e all'ora del gruppo di annunci sostituiscono i criteri relativi al giorno e all'ora della campagna e non vengono applicati come unione.

Consiglio

Per una panoramica su come usare i criteri di destinazione, vedi Mostra annunci al pubblico di destinazione.

È possibile scaricare tutti i record del criterio Campaign DayTime nell'account includendo il valore DownloadEntity di CampaignTargetCriterions 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 aggiunto un nuovo criterio relativo al giorno e all'ora della campagna se viene specificato un valore id padre valido.

Type,Status,Id,Parent Id,Sub Type,Campaign,Client Id,Modified Time,Target,Bid Adjustment,Name,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,6.0,,,,,,,,
Campaign DayTime Criterion,Active,,-111,,,ClientIdGoesHere,,Monday,20,,,,0,0,4,0,,

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkCampaignDayTimeCriterion , 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 BulkCampaignDayTimeCriterion
var bulkCampaignDayTimeCriterion = new BulkCampaignDayTimeCriterion
{
    // 'Campaign' column header in the Bulk file is read-only
    CampaignName = null,

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // 'Modified Time' column header in the Bulk file is read-only
    //  LastModifiedTime cannot be set in the Bulk entity

    // Map properties in the Bulk file to the 
    // BiddableCampaignCriterion object of the Campaign Management service.

    CampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,

        Criterion = new DayTimeCriterion
        {
            // 'Target' column header in the Bulk file
            Day = Day.Monday,

            // 'From Hour' column header in the Bulk file
            FromHour = 0,

            // 'To Hour' column header in the Bulk file
            ToHour = 4,

            // 'From Minute' column header in the Bulk file
            FromMinute = Minute.Zero,

            // 'To Minute' column header in the Bulk file
            ToMinute = Minute.Zero
        },

        CriterionBid = new BidMultiplier
        {
            // 'Bid Adjustment' column header in the Bulk file
            Multiplier = 20,
        },

        // 'Id' column header in the Bulk file
        Id = null,

        // 'Status' column header in the Bulk file
        Status = CampaignCriterionStatus.Active,
    }
};

uploadEntities.Add(bulkCampaignDayTimeCriterion);

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 Campaign DayTime Criterion , i campi dell'attributo seguenti sono disponibili nello schema del file bulk.

Rettifica dell'offerta
Campagna
Client Id
Da ora
Da minuto
Id
Ora modifica
Parent Id
Stato
Destinazione
A ora
Al minuto

Rettifica dell'offerta

Importo percentuale che si vuole modificare l'offerta per la destinazione, l'ora,il minuto, l'ora e il minuto corrispondenti.

I valori supportati sono negativi da novanta (-90) a 900 positivi (900).

Aggiungere: Opzionale. La rettifica dell'offerta verrà impostata sul valore predefinito 0 se non inclusa.
Aggiornamento: Obbligatorio
Elimina: Sola lettura

Campagna

Nome della campagna in cui questo criterio viene applicato o rimosso.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
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: Opzionale

Da ora

Ora di inizio da impostare come destinazione.

I valori supportati sono compresi tra 0 e 23.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio. Non è possibile modificare i valori Target, From Hour, From Minute, To Hour o To Minute per un criterio esistente. Per modificare gli intervalli di giorno e di ora, è necessario eliminare il criterio e aggiungere un nuovo criterio.
Elimina: Sola lettura

Da minuto

Minuto iniziale da impostare come destinazione.

I valori supportati sono 0, 15, 30 e 45.

Id

Identificatore univoco di Microsoft Advertising del criterio.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

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 della campagna in cui questo criterio viene applicato o rimosso.

Questo campo bulk viene mappato al campo Id del record Campagna .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore campagna esistente o un identificatore negativo uguale al campo Id del record campagna padre. Questa opzione è consigliata se si aggiungono nuovi criteri a una nuova campagna 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

Stato

Rappresenta lo stato di associazione tra la campagna e il criterio. Se il criterio viene applicato alla campagna, il valore di questo campo è Attivo. Per eliminare il criterio, impostare lo stato su Eliminato.

Aggiungere: Sola lettura. Lo stato verrà sempre impostato su Attivo quando si aggiungono criteri. Se si carica un altro valore, ad esempio, Foo il file di risultati conterrà lo stesso valore anche se il criterio è attivo.
Aggiornamento: Opzionale
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato. Per eliminare un'offerta specifica per criteri di giorno e ora, è necessario caricare lo stato, l'ID e l'ID padre.

Destinazione

Giorno di destinazione con la rettifica dell'offerta corrispondente.

I valori supportati sono Domenica, Lunedì, Martedì, Mercoledì, Giovedì, Venerdì e Sabato.

A ora

Ora finale da impostare come destinazione.

I valori supportati sono compresi tra 0 e 24. Se To Hour è impostato su 24, to minute deve essere zero.

Al minuto

Minuto finale da impostare come destinazione.