Registo de Critério de Intenção de Localização do Grupo de Anúncios - Em Massa
Define um critério de localização do grupo de anúncios que pode ser carregado e transferido num ficheiro em massa.
Cada critério de intenção de localização define a opção de intenção para todos os critérios de localização e raio da campanha ou grupo de anúncios. Não há nenhum ajuste de proposta de critério que o acompanhe.
O número máximo de critérios de intenção de localização que pode especificar por campanha ou grupo de anúncios é um deles.
Nota
Só pode ter um registo de Critério de Intenção de Localização do Grupo de Anúncios por grupo de anúncios para determinar a opção de intenção de localização que se aplica a todos os registos de Critérios de Localização do Grupo de Anúncios e Critérios radius do Grupo de Anúncios . Quando cria o primeiro critério do grupo de anúncios, um registo de Critério de Intenção de Localização do Grupo de Anúncios também será adicionado automaticamente com o Destino predefinido definido como PeopleInOrSearchingForOrViewingPages. Pode adicionar ou atualizar o Critério de Intenção de Localização do Grupo de Anúncios de um grupo de anúncios, quer o grupo de anúncios tenha ou não outros critérios. Não é possível eliminar o Critério de Intenção de Localização do Grupo de Anúncios de um grupo de anúncios, embora não tenha qualquer finalidade sem critérios de localização ou raio.
PeopleSearchingForOrViewingPages foi preterido a partir de abril de 2024. Se tentar definir IntentOption para PeopleSearchingForOrViewingPages, este será definido como PeopleInOrSearchingForOrViewingPages . Vamos converter automaticamente as campanhas existentes com esta definição em PeopleInOrSearchingForOrViewingPages.
Importante
Defina Critérios de Intenção de Localização AIM como PeopleIn em vez de PeopleInOrSearchingForOrViewingPages.
Sugestão
Para obter uma descrição geral de como utilizar critérios de destino, consulte Mostrar Anúncios à Audiência de Destino.
Pode transferir todos os registos do Critério de Intenção de Localização do Grupo de Anúncios na conta ao incluir o valor DownloadEntity de AdGroupTargetCriterions 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 critério de intenção de localização do grupo de anúncios se for fornecido um valor de ID Principal válido.
Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Target,Bid Adjustment,Name,OS Names,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,,6.0,,,,,,,,,
Ad Group Location Intent Criterion,Active,,-1111,,,,ClientIdGoesHere,,PeopleIn,,,,,,,,,,,
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 BulkAdGroupLocationIntentCriterion , 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 BulkAdGroupLocationIntentCriterion
var bulkAdGroupLocationIntentCriterion = new BulkAdGroupLocationIntentCriterion
{
// 'Ad Group' column header in the Bulk file is read-only
AdGroupName = null,
// 'Campaign' column header in the Bulk file is read-only
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// BiddableAdGroupCriterion object of the Campaign Management service.
BiddableAdGroupCriterion = new BiddableAdGroupCriterion
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
Criterion = new LocationIntentCriterion
{
// 'Target' column header in the Bulk file
IntentOption = IntentOption.PeopleIn
},
CriterionBid = null,
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Active,
}
};
uploadEntities.Add(bulkAdGroupLocationIntentCriterion);
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 Critério de Intenção de Localização do Grupo de Anúncios , 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 onde este critério é aplicado ou removido.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
Campanha
O nome da campanha que contém o grupo de anúncios onde este critério é aplicado ou removido.
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: Opcional
ID
O identificador do critério.
Nota
Atualmente, o identificador do critério de intenção de localização é igual ao identificador principal, embora não deva assumir uma dependência dessa relação. Como melhor prática, deve considerar o identificador de critério de intenção de localização como distinto.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
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 do grupo de anúncios onde este critério é aplicado ou removido.
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 adicionar novos critérios 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
Estado
Representa o estado de associação entre o grupo de anúncios e o critério. Se o critério estiver definido para o grupo de anúncios, o valor deste campo é Ativo. Para eliminar o critério, defina o estado como Eliminado.
Adicionar: Só de leitura. O estado será sempre definido como Ativo quando adicionar critérios. Se carregar outro valor, por exemplo, Foo , o ficheiro de resultados conterá o mesmo valor, embora o critério esteja ativo.
Atualização: Opcional
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado. Para eliminar um critério de intenção de localização específico, tem de carregar o Estado e o ID Principal.
Target
Determina se uma pessoa tem de estar fisicamente localizada na localização de destino para que o anúncio seja apresentado.
Os seguintes valores são suportados. O valor predefinido é PeopleInOrSearchingForOrViewingPages.
- Utilize PeopleInOrSearchingForOrViewingPages se quiser mostrar anúncios a pessoas em, procurar ou visualizar páginas sobre a sua localização de destino.
- Utilize PeopleIn se quiser mostrar anúncios a pessoas na sua localização de destino.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo, este tem de ser definido para um valor válido, ou seja, PeopleInOrSearchingForOrViewingPages ou PeopleIn.
Eliminar: Só de leitura