Registo de Site Negativo da Campanha - Em Massa
Define um site negativo atribuído a uma campanha que pode ser carregada e transferida num ficheiro em massa.
No esquema em massa, cada um dos sites negativos associados a uma campanha é representado individualmente pela sua própria linha. Por exemplo, se tiver dois sites negativos, estes são representados por dois registos de Site Negativo de Campanha no ficheiro em massa com o Estado definido como Ativo. Ao carregar ou transferir registos para uma lista atualizada de sites negativos associados, um registo terá o Estado definido como Eliminado com um campo de Web site vazio. Isto indica que foram efetuadas algumas alterações à lista e que os registos do Site Negativo da Campanha que se seguem estão ativos.
Nota
O Site Negativo da Campanha pode ser adicionado e eliminado, mas não pode ser atualizado.
Pode transferir todos os registos de Site Negativo da Campanha na conta ao incluir o valor DownloadEntity de CampaignNegativeSites 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 site negativo de campanha se for fornecido um valor de ID Principal válido.
Type,Status,Id,Parent Id,Campaign,Ad Group,Website,Client Id,Modified Time,Name
Format Version,,,,,,,,,6.0
Campaign Negative Site,Active,,-112,,,contoso.com,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 BulkCampaignNegativeSite , 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 BulkCampaignNegativeSites
var bulkCampaignNegativeSites = new BulkCampaignNegativeSites
{
// 'Campaign' column header in the Bulk file
CampaignName = null,
// Map properties in the Bulk file to the
// CampaignNegativeSites object of the Campaign Management service.
CampaignNegativeSites = new CampaignNegativeSites
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
NegativeSites = new[]
{
// 'Website' column header in the Bulk file
"contoso.com",
}
},
// 'Status' column header in the Bulk file
Status = Status.Active,
};
// BulkCampaignNegativeSites does not support 'Client Id' and
// replaces all negative sites for the campaign, whereas BulkCampaignNegativeSite
// enables you to add or delete one negative site at a time.
// Map properties in the Bulk file to the BulkCampaignNegativeSite
var bulkCampaignNegativeSite = new BulkCampaignNegativeSite
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
// 'Website' column header in the Bulk file
Website = "contoso.com",
};
uploadEntities.Add(bulkCampaignNegativeSite);
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 site negativo de campanha , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
Campanha
O nome da campanha que contém o site negativo.
Adicionar: Só de leitura e Obrigatório
Atualização: Não aplicável. Um site negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Só de leitura e Obrigatório
Nota
Para adicionar 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: Não aplicável. Um site negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
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: Não aplicável. Um site negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Só de leitura
ID principal
O identificador gerado pelo sistema da campanha que contém o site negativo.
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 adicionar novos sites negativos 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: Não aplicável. Um site negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Só de leitura
Nota
Para adicionar e eliminar, tem de especificar o campo ID Principal ou Campanha .
Estado
Representa o estado de associação entre a campanha e o site negativo.
Se o site negativo estiver associado à campanha, o valor deste campo é Ativo.
Os valores possíveis são Ativos ou Eliminados.
Adicionar: Opcional. O valor predefinido é Ativo.
Atualização: Não aplicável. Um site negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Necessário. O Estado tem de ser definido como Eliminado. Para eliminar um site negativo específico, tem de carregar o Estado, o ID Principal e o Site. Para eliminar todos os sites negativos da campanha, só tem de carregar o Estado e o ID Principal num único registo. Em seguida, opcionalmente, pode adicionar novos registos de site negativos para substituir o conjunto eliminado.
Web site
O URL do site onde não pretende que os anúncios sejam apresentados.
Cada URL tem de especificar o nome de domínio, por exemplo, contoso.com que pode incluir até três subdomínios e dois subdiretórios. A contagem de subdomínios inclui o prefixo www . Por exemplo, one.two.three.contoso.com/1/2, www.two.three.contoso.com/1/2 e one.two.contoso.co.uk/1/2 são URLs válidos, enquanto one.two.three.contoso.co.uk/1/2 (demasiados subdomínios) e one.two.three.contoso.com/1/2/3 (demasiados subdiretórios) não são. Não são permitidos URLs de site negativos duplicados por campanha ou grupo de anúncios.
Só pode excluir sites para sites de pesquisa sindicados. A rede do grupo de anúncios tem de ser definida como OwnedAndOperatedAndSyndicatedSearch.
Os URLs de site negativos especificados ao nível do grupo de anúncios são utilizados em vez de urLs de site negativos especificados ao nível da campanha. Se associar listas de exclusão de sites a uma conta de anúncio (disponível através do serviço Gestão de Campanhas), a lista de sites negativos é utilizada para além dos sites negativos da campanha ou sites negativos do grupo de anúncios.
Adicionar: Necessário
Atualização: Não aplicável. Um site negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Só de leitura