Registo de Etiqueta de Anúncios de Pesquisa Reativa - Em Massa

Artigo
12/21/2023

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

Pode transferir todos os registos do Responsive Search Ad Label na conta ao incluir o valor DownloadEntity de ResponsiveSearchAdLabels 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 de pesquisa reativa 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 Search 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 BulkResponsiveSearchAdLabel , 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 BulkResponsiveSearchAdLabel
var bulkResponsiveSearchAdLabel = new BulkResponsiveSearchAdLabel
{
    // '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 = responsiveSearchAdIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

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

uploadEntities.Add(bulkResponsiveSearchAdLabel);

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 de Pesquisa 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 de pesquisa reativa.

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 de pesquisa 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 de pesquisa reativa onde esta etiqueta é aplicada ou removida.

Este campo em massa mapeia para o campo ID do registo do AD de Pesquisa Reativa .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de anúncio de pesquisa reativo existente ou especificar um identificador negativo que seja igual ao campo ID do registo do AD de Pesquisa Reativa principal. Isto é recomendado se estiver a aplicar etiquetas a um novo anúncio de pesquisa reativa 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 de pesquisa reativa e a etiqueta.

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

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

Partilhar via