Condividi tramite

Record di regolazione della stagionalità - Bulk

  • Articolo

Definisce i campi Regolazione stagionalità che possono essere caricati e scaricati in un file bulk.

È possibile scaricare tutti i record di regolazione della stagionalità nell'account includendo il valore DownloadEntity di SeasonalityAdjustments 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 regolazione della stagionalità.

Type,AccountId,Id,Campaign Type,Start Date,End Date,Name,Description,Adjustment Value,Seasonality Adjustment,Device Type,Campaign Associations
Format Version,,,,,,6.0,,,,,
Seasonality Adjustment,,,Search,3/15/2024 3:00,3/16/2024 3:00,,Description,100,TestSA,Tablets,

Se si usano gli SDK Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAdGroupSeasonalityAdjustment , 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 BulkSeasonalityAdjustment
var bulkSeasonalityAdjustment = new BulkSeasonalityAdjustment
{
    // Map properties in the Bulk file to the 
    // SeasonalityAdjustment object of the Campaign Management service.
    SeasonalityAdjustment = new SeasonalityAdjustment
    {
        // 'Adjustment Value' column header in the Bulk file
        AdjustmentPercentage = 100,
        // 'Campaign Associations' column header in the Bulk file
        CampaignAssociations = new List<CampaignAssociation>(),
        // 'Campaign Type' column header in the Bulk file
        CampaignTypeFilter = CampaignType.Search,
        // 'Description' column header in the Bulk file
        Description = "Description",
        // 'Device Type' column header in the Bulk file
        DeviceTypeFilter = DeviceType.Computers,
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Start Date' column header in the Bulk file
        StartDate = DateTime.UtcNow,
        // 'End Date' column header in the Bulk file
        EndDate = DateTime.UtcNow.AddDays(7),
        // 'Seasonality Adjustment' column header in the Bulk file
        Name = "Seasonality Adjustment",
    },
};

uploadEntities.Add(bulkSeasonalityAdjustment);

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 regolazione della stagionalità , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

Valore di regolazione

Percentuale dell'adeguamento del tasso di conversione.

Aggiungere: Obbligatorio
Aggiornare: Opzionale
Cancellare: Sola lettura

Associazioni della campagna

Apportare l'adattamento della stagionalità a queste campagne.

Aggiungere: Opzionale
Aggiornare: Opzionale
Cancellare: Opzionale. È possibile specificare solo una delle "Associazioni campagna" e "Tipo di campagna". Se si imposta "Tipo campagna", questo valore sarà Null.

Tipo di campagna

Apportare l'adattamento della stagionalità a questi tipi di campagna.

Aggiungere: Opzionale
Aggiornare: Opzionale
Cancellare: Opzionale. È possibile specificare solo una delle "Associazioni campagna" e "Tipo di campagna". Se si imposta "Associazioni campagna", questo valore sarà Null.

Descrizione

Descrizione dell'adattamento della stagionalità.

Aggiungere: Obbligatorio
Aggiornare: Opzionale
Cancellare: Sola lettura

Tipo di dispositivo

Apportare la regolazione della stagionalità a questi tipi di dispositivo.

Aggiungere: Obbligatorio
Aggiornare: Opzionale
Cancellare: Sola lettura

Data di fine

Data di fine.

Importante: il valore deve essere nel fuso orario dell'account. Ciò differisce dalle opzioni del fuso orario quando si caricano conversioni offline nell'applicazione Web Microsoft Advertising. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Obbligatorio
Aggiornare: Opzionale
Cancellare: Sola lettura

Id

Identificatore generato dal sistema per la regolazione della stagionalità.

Aggiungere: Nessuno
Aggiornare: Obbligatorio
Cancellare: Sola lettura

Adeguamento stagionalità

Nome dell'adattamento della stagionalità.

Aggiungere: Obbligatorio
Aggiornare: Opzionale
Cancellare: Sola lettura

Data inizio

Data di inizio.

Importante: il valore deve essere nel fuso orario dell'account. Ciò differisce dalle opzioni del fuso orario quando si caricano conversioni offline nell'applicazione Web Microsoft Advertising. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Obbligatorio
Aggiornare: Opzionale
Cancellare: Sola lettura