Registo da Extensão do Ad do Sitelink de Campanha - Em Massa
Define um registo de associação entre uma Campanha e uma Extensão de Anúncios do Sitelink que pode ser carregada e transferida num ficheiro em massa. Para carregar ou transferir a extensão de anúncio da campanha ou da ligação de site, utilize o registo Campanha ou Extensão de Anúncios do Sitelink .
Pode transferir todos os registos da Extensão do Ad Sitelink da Campanha na conta ao incluir o valor DownloadEntity de CampaignSitelinkAdExtensions 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 associaria uma extensão de anúncio de ligação de site a uma campanha se fossem fornecidos valores de ID e ID Principal válidos.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Campaign Sitelink Ad Extension,Active,-11,-1111,,,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 BulkCampaignSitelinkAdExtension , 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 BulkCampaignSitelinkAdExtension
var bulkCampaignSitelinkAdExtension = new BulkCampaignSitelinkAdExtension
{
// Map properties in the Bulk file to the
// AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
{
// 'Id' column header in the Bulk file
AdExtensionId = sitelinkAdExtensionIdKey,
// 'Parent Id' column header in the Bulk file
EntityId = campaignIdKey,
},
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
};
uploadEntities.Add(bulkCampaignSitelinkAdExtension);
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 Extensão do Ad sitelink de campanha , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
- Campanha
- ID de Cliente
- Localização Editorial
- Código do Motivo Editorial
- Estado Editorial
- Termo Editorial
- ID
- Hora da Modificação
- ID principal
- Países do Publisher
- Estado
Campanha
O nome da campanha em que esta extensão de anúncios está associada ou removida.
Adicionar: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório
Nota
Para adicionar e eliminar, tem de especificar o ID Principal ou a 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
Eliminar: Só de leitura
Localização Editorial
O componente ou propriedade da extensão de anúncio que falhou na revisão editorial.
Adicionar: Só de leitura
Eliminar: Só de leitura
Código do Motivo Editorial
Um código que identifica o motivo da falha. Para obter uma lista de possíveis códigos de motivos, consulte Códigos de Razão Editoriais.
Adicionar: Só de leitura
Eliminar: Só de leitura
Estado Editorial
O estado editorial da extensão de anúncios.
Os valores possíveis estão descritos na tabela abaixo.
Adicionar: Só de leitura
Eliminar: Só de leitura
Termo Editorial
O termo que falhou na revisão editorial.
Este campo não será definido se uma combinação de termos tiver causado a falha ou se a falha tiver sido baseada numa violação de política.
Adicionar: Só de leitura
Eliminar: Só de leitura
ID
O identificador da extensão de anúncios que está associada ou removida da campanha.
Este campo em massa mapeia para o campo ID do registo extensão do Ad do Sitelink .
Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de extensão de anúncio existente ou especificar um identificador negativo que seja igual ao campo ID do registo da Extensão do Ad do Sitelink principal. Isto é recomendado se estiver a adicionar novas extensões e associações de anúncios 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 da campanha em que esta extensão de anúncio está associada ou removida.
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 extensões de anúncios 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.
Eliminar: Só de leitura e Obrigatório
Nota
Para adicionar e eliminar, tem de especificar o ID Principal ou a Campanha.
Países do Publisher
A lista de países ou regiões publicadores cujas diretrizes editoriais não permitem o termo especificado.
Num ficheiro em massa, a lista de países ou regiões do publicador é delimitada com um ponto e vírgula (;).
Adicionar: Só de leitura
Eliminar: Só de leitura
Estado
Representa o estado de associação entre a campanha e a extensão de anúncios.
Os valores possíveis são Ativo e Eliminado. Se a extensão de anúncio estiver associada à campanha, o valor deste campo é Ativo.
Adicionar: Só de leitura
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.