Registo de Etiqueta de Anúncios Reativo - Em Massa

Artigo
12/21/2023

Define um registo de associação entre um Anúncio Reativo e uma Etiqueta que pode ser carregada e transferida num ficheiro em massa. Para carregar ou transferir o anúncio ou etiqueta reativo, utilize o registo Ad reativo ou Etiqueta .

Pode transferir todos os registos de Etiqueta de Anúncios Reativos na conta ao incluir o valor DownloadEntity de ResponsiveAdLabels 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 aplicaria uma etiqueta a um anúncio reativo se fossem fornecidos valores de ID e ID Principal válidos.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Responsive Ad Label,,-22,-11112,,,ClientIdGoesHere,,,,,

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 BulkResponsiveAdLabel , 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 BulkResponsiveAdLabel
var bulkResponsiveAdLabel = new BulkResponsiveAdLabel
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // LabelAssociation object of the Campaign Management service.
    LabelAssociation = new LabelAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = responsiveAdIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

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

uploadEntities.Add(bulkResponsiveAdLabel);

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 Etiqueta de Anúncios Reativa , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

ID de Cliente
ID
Hora da Modificação
ID principal
Estado

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
Eliminar: Só de leitura

ID

O identificador da etiqueta que é aplicada ou removida do anúncio reativo.

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

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de etiqueta existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Etiqueta principal. Isto é recomendado se estiver a aplicar novas etiquetas a anúncios reativos no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
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
Eliminar: Só de leitura

ID principal

O identificador do anúncio reativo onde esta etiqueta é aplicada ou removida.

Este campo em massa mapeia para o campo ID do registo do AD Reativo .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de anúncio reativo existente ou especificar um identificador negativo que seja igual ao campo ID do registo do AD Reativo principal. Isto é recomendado se estiver a aplicar etiquetas a um novo anúncio reativo no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Eliminar: Só de leitura e Obrigatório

Estado

Representa o estado aplicado entre o anúncio reativo e a etiqueta.

Os valores possíveis são Ativo e Eliminado. Se a etiqueta for aplicada ao anúncio reativo, o valor deste campo é Ativo.

Adicionar: Só de leitura
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

Partilhar via