Registo de Associação de Lista de Remarketing Semelhante Negativo da Campanha - Em Massa
Define uma Associação de Lista de Remarketing Semelhante Negativa de Campanha que pode ser carregada e transferida num ficheiro em massa.
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 da Associação de Listas de Remarketing Negativos Negativos da Campanha na conta ao incluir o valor DownloadEntity de CampaignNegativeSimilarRemarketingListAssociations 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 uma nova Associação de Lista de Remarketing Semelhante Negativo da Campanha se for 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,,
Campaign Negative Similar Remarketing List Association,Paused,,-1111,,,ClientIdGoesHere,,,,SimilarRemarketingListIdHere,My Similar Remarketing List
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 BulkCampaignNegativeSimilarRemarketingListAssociation , 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 BulkCampaignNegativeSimilarRemarketingListAssociation
var bulkCampaignNegativeSimilarRemarketingListAssociation = new BulkCampaignNegativeSimilarRemarketingListAssociation
{
// 'Campaign' column header in the Bulk file
CampaignName = null,
// Map properties in the Bulk file to the
// NegativeCampaignCriterion object of the Campaign Management service.
NegativeCampaignCriterion = new NegativeCampaignCriterion
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
Criterion = new AudienceCriterion
{
// 'Audience Id' column header in the Bulk file
AudienceId = similarRemarketingListIdKey,
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = CampaignCriterionStatus.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(bulkCampaignNegativeSimilarRemarketingListAssociation);
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 Associação de Lista de Remarketing Semelhante Negativo da Campanha , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
Audiência
O nome da lista de remarketing semelhante.
Este campo em massa mapeia para o campo Audiência do registo Lista de Remarketing Semelhante .
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 novas Associações de Listas de Remarketing Semelhantes de Campanha Com novas listas de remarketing semelhantes no mesmo ficheiro em massa e, se não definir o campo ID da 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 Lista de Remarketing Semelhante . 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 lista de remarketing semelhante associada à campanha.
Este campo em massa mapeia para o campo ID do registo Lista de Remarketing Semelhante .
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 lista de remarketing semelhante existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Lista de Remarketing Semelhante principal. 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 Lista de Remarketing Semelhante . Qualquer uma destas opções é recomendada se estiver a adicionar novas Associações de Listas de Remarketing Semelhantes de Campanha Com novas listas de remarketing semelhantes 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 está associada à lista de remarketing semelhante.
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 Campanha .
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 uma campanha e uma lista de remarketing semelhante.
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 da campanha que está associada à lista de remarketing semelhante.
Este campo em massa mapeia para o campo ID do registo campanha .
Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de campanha existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Campanha principal. Isto é recomendado se estiver a associar listas de remarketing semelhantes a uma nova campanha 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 Campanha .
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.