Partilhar via


Ad Group Negative In Market Audience Association Record - Bulk

Define um Grupo de Anúncios Negativo na Associação de Audiências de Mercado que pode ser carregado e transferido num ficheiro em massa.

Nota

Esta funcionalidade está disponível na Austrália, Canadá, França, Alemanha, Reino Unido e Estados Unidos.

Os destinos de audiência não podem ser definidos ao nível da campanha e do grupo de anúncios. Se definir critérios de audiência ao nível da campanha, não pode definir critérios de audiência ao nível do grupo de anúncios bidíveis. As exclusões de audiência podem ser definidas ao nível da campanha e do grupo de anúncios. O Microsoft Advertising aplica uma união de exclusões ao nível da campanha e do grupo de anúncios.

Sugestão

Para obter uma descrição geral e mais informações sobre audiências, veja o Guia técnico das APIs de Audiência .

Pode transferir todos os registos do Ad Group Negative In Market Audience Association na conta ao incluir o valor DownloadEntity de AdGroupNegativeInMarketAudienceAssociations 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 Grupo de Anúncios Negativo na Associação de Audiência de Mercado se fosse fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Ad Group Negative In Market Audience Association,Paused,,-1111,,,ClientIdGoesHere,,,,InMarketAudienceIdHere,My In Market Audience

Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo com o BulkServiceManager para carregar e transferir o objeto BulkAdGroupNegativeInMarketAudienceAssociation , 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 BulkAdGroupNegativeInMarketAudienceAssociation
var bulkAdGroupNegativeInMarketAudienceAssociation = new BulkAdGroupNegativeInMarketAudienceAssociation
{
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,

    // Map properties in the Bulk file to the 
    // NegativeAdGroupCriterion object of the Campaign Management service.
    NegativeAdGroupCriterion = new NegativeAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = inMarketAudienceIdKey,
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Audience' column header in the Bulk file
    AudienceName = null,
};

uploadEntities.Add(bulkAdGroupNegativeInMarketAudienceAssociation);

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 Ad Group Negative In Market Audience Association , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Grupo de Anúncios

O nome do grupo de anúncios associado à audiência no mercado.

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

Audiência

O nome da audiência no mercado.

Este campo em massa mapeia para o campo Audiência do registo Audiência no Mercado .

A transferência da API em massa devolve todas as associações de audiência no mercado, quer a audiência no mercado esteja ativa ou eliminada. Se a associação for para uma audiência eliminada no mercado, este campo será definido para o mesmo valor que o campo ID da Audiência .

Adicionar: Só de leitura e Obrigatório para alguns casos de utilização. Tem de especificar o campo ID da Audiência ou da Audiência . Se estiver a adicionar novos Grupos de Anúncios Negativos em Associações de Audiência de Mercado com novas audiências no mercado no mesmo ficheiro em massa e, se não definir o campo ID de Audiência , este campo Audiência tem de ser definido como uma chave lógica para o mesmo valor que o campo Audiência do registo Audiência no Mercado . Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura
Eliminar: Só de leitura

ID da Audiência

O identificador do Microsoft Advertising da audiência no mercado associada ao grupo de anúncios.

Este campo em massa mapeia para o campo ID do registo Audiência no Mercado .

Adicionar: Só de leitura e Obrigatório para alguns casos de utilização. Tem de especificar o campo ID da Audiência ou da Audiência . Se definir o campo ID da Audiência , tem de especificar um identificador de audiência existente no mercado ou especificar um identificador negativo que seja igual ao campo ID do registo principal em Audiência de Mercado . Se o campo ID da Audiência não estiver definido, tem de definir o campo Audiência como uma chave lógica para o mesmo valor que o campo Audiência do registo Audiência no Mercado . Qualquer uma destas opções é recomendada se estiver a adicionar novas Associações de Audiências Negativas no Mercado do Grupo de Anúncios com novas audiências no mercado 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
Eliminar: Só de leitura

Campanha

O nome da campanha que contém o grupo de anúncios.

Adicionar: Só de leitura
Atualização: Só de leitura
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 para a associação entre um grupo de anúncios e a audiência no mercado.

Adicionar: Só de leitura
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 do grupo de anúncios que está associado à audiência no mercado.

Este campo em massa mapeia para o campo ID do registo do Grupo de Anúncios .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de grupo de anúncios existente ou especificar um identificador negativo que seja igual ao campo ID do registo do Grupo de Anúncios principal. Isto é recomendado se estiver a associar audiências no mercado a um novo grupo de anúncios 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

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

Estado

O estado da associação.

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

Adicionar: Opcional. O valor de estado predefinido é Ativo.
Atualização: Opcional
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.