Partilhar via

Registo de Etiqueta de Anúncios de Texto Expandido - Em Massa

  • Artigo

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

Nota

  • Atualize os anúncios de texto expandidos para anúncios de pesquisa reativos até 1 de fevereiro de 2023. Após esta data, deixará de poder criar anúncios de texto expandido novos ou editar existentes. Para obter mais informações, consulte Acerca dos anúncios de pesquisa reativos.
  • Os anúncios de texto expandido existentes continuarão a servir e poderá ver relatórios sobre o desempenho dos mesmos.
  • Continuará a poder colocar em pausa, ativar ou remover os anúncios de texto expandidos. Caso contrário, as tentativas de adicionar ou atualizar anúncios de texto expandido resultarão num CampaignServiceAdTypeInvalid erro.
  • Saiba mais sobre esta alteração.

Pode transferir todos os registos de Etiqueta de Anúncios de Texto Expandidos na conta ao incluir o valor DownloadEntity de ExpandedTextAdLabels 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 texto expandido 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,,,
Expanded Text 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 BulkExpandedTextAdLabel , 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 BulkExpandedTextAdLabel
var bulkExpandedTextAdLabel = new BulkExpandedTextAdLabel
{
    // '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 = expandedTextAdIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

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

uploadEntities.Add(bulkExpandedTextAdLabel);

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 Texto Expandido , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

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 texto expandido.

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 texto expandidos 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 texto expandido onde esta etiqueta é aplicada ou removida.

Este campo em massa mapeia para o campo ID do registo de Anúncio de Texto Expandido .

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

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

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