Condividi tramite


Budget Record - Bulk

Definisce un budget che può essere caricato e scaricato in un file bulk.

È possibile impostare un singolo budget giornaliero che può essere usato da qualsiasi campagna all'interno dello stesso account. In questo modo potrai distribuire in modo efficiente un singolo budget giornaliero in tutte le campagne o in un gruppo definito di campagne all'interno del tuo account Microsoft Advertising.

Supponiamo di avere un budget di $ 20 da usare in modo uniforme tra due campagne ogni giorno. In un determinato giorno campagna A spende solo $ 8 (del suo budget $ 10) perché ha ottenuto una quantità minore di impressioni e clic del solito. Usando un budget condiviso, se la campagna B sta funzionando bene, Microsoft Advertising prenderà automaticamente i restanti $2 e lo allocherà alla campagna B. In questo modo si aumentano le probabilità che il budget rimanente venga usato per inviare più traffico.

È possibile scaricare tutti i record budget nell'account includendo il valore DownloadEntity di Budget 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 budget.

Type,Status,Id,Parent Id,Client Id,Modified Time,Budget Id,Budget Name,Budget,Budget Type,Name
Format Version,,,,,,,,,,6.0
Budget,Active,-20,0,ClientIdGoesHere,,,My Shared Budget,50,DailyBudgetStandard,

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkBudget , 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 BulkBudget
var bulkBudget = new BulkBudget
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
                
    // Map properties in the Bulk file to the 
    // Budget object of the Campaign Management service.
    Budget = new Budget
    {
        // 'Budget' column header in the Bulk file
        Amount = 50,
        // 'Budget Type' column header in the Bulk file
        BudgetType = BudgetLimitType.DailyBudgetStandard,
        // 'Budget Name' column header in the Bulk file
        Name = "My Shared Budget",
        // 'Id' column header in the Bulk file
        Id = budgetIdKey,
    },

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkBudget);

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 budget , i campi di attributo seguenti sono disponibili nello schema file bulk.

Bilancio

Importo da spendere ogni giorno in tutte le campagne che condividono il budget.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Nome budget

Nome del budget. Il nome deve essere univoco tra tutti i budget all'interno dell'account. Il nome può contenere un massimo di 255 caratteri.

Il servizio esegue un confronto senza distinzione tra maiuscole e minuscole quando confronta il nome con i nomi di budget esistenti.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Tipo di budget

Il tipo di budget determina il ritmo con cui il budget viene speso per tutto il giorno.

L'unico tipo di budget valido che è possibile impostare è DailyBudgetStandard.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
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

Id

Identificatore del budget generato dal sistema.

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

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 il budget.

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

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

Stato

Stato del budget.

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.