Partilhar via


Registo orçamental - Em massa

Define um orçamento que pode ser carregado e transferido num ficheiro em massa.

Pode definir um único orçamento diário que pode ser utilizado por qualquer campanha na mesma conta. Isto irá permitir-lhe distribuir de forma eficiente um único orçamento diário em todas as campanhas ou num grupo definido de campanhas na sua conta microsoft Advertising.

Digamos que tem um orçamento de 20 dólares para ser usado uniformemente entre duas campanhas todos os dias. Num determinado dia, a Campanha A gasta apenas 8 dólares (do seu orçamento de 10 dólares) porque obteve uma quantidade menor de impressões e cliques do que o habitual. Utilizando um Orçamento Partilhado, se a Campanha B estiver a ter um bom desempenho, o Microsoft Advertising irá automaticamente pegar nos restantes $2 e alocar ao Campaign B. Isto aumentará as hipóteses de o orçamento restante ser utilizado para lhe enviar mais tráfego.

Pode transferir todos os registos do Orçamento na conta ao incluir o valor DownloadEntity de Orçamentos no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.

O seguinte exemplo de CSV em Massa adicionaria um novo orçamento.

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 estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para carregar e transferir o objeto BulkBudget , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.

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();

Para um registo de Orçamento , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Orçamento

O montante a gastar diariamente em todas as campanhas que partilham o orçamento.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Nome do Orçamento

O nome do orçamento. O nome tem de ser exclusivo entre todos os orçamentos na conta. O nome pode conter um máximo de 255 carateres.

O serviço efetua uma comparação não sensível a maiúsculas e minúsculas quando compara o nome com os nomes de orçamento existentes.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Tipo de Orçamento

O tipo de orçamento determina o ritmo a que o orçamento é gasto ao longo do dia.

O único tipo de orçamento válido que pode definir é DailyBudgetStandard.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

ID de Cliente

Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.

Adicionar: Opcional
Atualização: Opcional
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema do orçamento.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para o orçamento pode ser referenciado no campo ID do Orçamento de tipos de registo dependentes, como Campanha. Isto é recomendado se estiver a adicionar novos orçamentos e novos registos dependentes no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Hora da Modificação

A data e hora em que a entidade foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC).

Nota

O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

ID principal

O identificador gerado pelo sistema da conta que contém o orçamento.

Este campo em massa mapeia para o campo ID do registo conta .

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Estado

O estado do orçamento.

Os valores possíveis são Ativos ou Eliminados.

Adicionar: Opcional. O valor predefinido é Ativo.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.