Registo de Critérios do Dispositivo de CampanhaOS - Em massa
Define um critério de dispositivo de campanha que pode ser carregado e transferido num ficheiro em massa.
Quando segmenta por dispositivo, opta por mostrar anúncios a potenciais clientes quando estão a utilizar computadores de secretária e tablets ou smartphones.
Cada critério de dispositivo define um nome de dispositivo para o ajuste da oferta de critério que o acompanha.
O número máximo de critérios de dispositivo que pode especificar por campanha ou grupo de anúncios é três. Tem de ter três critérios separados para Computadores, Smartphones e Tablets. Caso contrário, não podem existir critérios de dispositivo para a campanha ou para o grupo de anúncios.
Se forem especificados critérios de dispositivo ao nível do grupo de anúncios, os critérios do dispositivo ao nível da campanha são ignorados para esse grupo de anúncios. Por outras palavras, os critérios do dispositivo do grupo de anúncios substituem os critérios do dispositivo de campanha e não são aplicados como uma união.
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 de Critério deviceOS da campanha na conta ao incluir o valor DownloadEntity de CampaignTargetCriterions 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 três novos critérios de dispositivos de campanha (um para cada tipo de dispositivo) se for fornecido um valor de ID Principal válido.
Type,Status,Id,Parent Id,Sub Type,Campaign,Client Id,Modified Time,Target,Bid Adjustment,Name,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,6.0,,,,,,,,
Campaign DeviceOS Criterion,Active,,-111,,,ClientIdGoesHere,,Computers,20,,,,,,,,,
Campaign DeviceOS Criterion,,,-111,,,ClientIdGoesHere,,Smartphones,0,,,,,,,,,
Campaign DeviceOS Criterion,,,-111,,,ClientIdGoesHere,,Tablets,0,,,,,,,,,
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 BulkCampaignDeviceOSCriterion , 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>();
var bulkCampaignDeviceCriterions = new[] {
// Map properties in the Bulk file to the BulkCampaignDeviceCriterion
new BulkCampaignDeviceCriterion
{
// '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
// BiddableCampaignCriterion object of the Campaign Management service.
CampaignCriterion = new BiddableCampaignCriterion
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
Criterion = new DeviceCriterion
{
// 'Target' column header in the Bulk file
DeviceName = "Computers",
},
CriterionBid = new BidMultiplier
{
// 'Bid Adjustment' column header in the Bulk file
Multiplier = 20,
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = CampaignCriterionStatus.Active,
}
},
new BulkCampaignDeviceCriterion
{
ClientId = "ClientIdGoesHere",
CampaignCriterion = new BiddableCampaignCriterion
{
CampaignId = campaignIdKey,
Criterion = new DeviceCriterion
{
DeviceName = "Smartphones",
},
CriterionBid = new BidMultiplier
{
Multiplier = 0,
},
}
},
new BulkCampaignDeviceCriterion
{
ClientId = "ClientIdGoesHere",
CampaignCriterion = new BiddableCampaignCriterion
{
CampaignId = campaignIdKey,
Criterion = new DeviceCriterion
{
DeviceName = "Tablets",
},
CriterionBid = new BidMultiplier
{
Multiplier = 0,
},
}
},
};
foreach (var bulkCampaignDeviceCriterion in bulkCampaignDeviceCriterions)
{
uploadEntities.Add(bulkCampaignDeviceCriterion);
}
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 DeviceOS de Campanha , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
Ajuste da Oferta
O valor percentual que pretende ajustar a oferta para o Destino correspondente.
Os valores suportados são -100 (100 negativos cem) até 900 por cento positivos (900). Definir o ajuste da oferta para -100 por cento resultará na exclusão do Destino correspondente.
Adicionar: Opcional. O ajuste da oferta será definido como a predefinição de 0 , se não for incluído.
Atualização: Necessário
Eliminar: Só de leitura
Campanha
O nome da campanha em que 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 exclusivo do Critério do Microsoft Advertising.
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 da campanha em que este critério é aplicado ou removido.
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 critérios 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
Estado
Representa o estado de associação entre a campanha e o critério. Se o critério for aplicado à campanha, 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 uma proposta de critério de dispositivo específica, tem de carregar o Estado, o ID e o ID Principal.
Target
O nome do dispositivo que pretende direcionar com o Ajuste de Licitação correspondente.
Os valores suportados são Computadores, Smartphones e Tablets.
Adicionar: Obrigatório. Três ofertas separadas para Computadores, Smartphones e Tablets devem ser especificadas em conjunto no ficheiro em massa (cada oferta num registo/linha separado). Se não adicionar critérios de dispositivo individuais que representem cada um dos três tipos de dispositivo, não serão adicionados critérios de dispositivo para a campanha.
Atualização: Necessário
Eliminar: Só de leitura