Record criteri DeviceOS campagna - Bulk
Definisce un criterio del dispositivo della campagna che può essere caricato e scaricato in un file bulk.
Quando si effettua il targeting in base al dispositivo, si sceglie di mostrare gli annunci ai potenziali clienti quando usano desktop, tablet o smartphone.
Ogni criterio del dispositivo definisce un nome di dispositivo per la rettifica dell'offerta del criterio di accompagnamento.
Il numero massimo di criteri del dispositivo che puoi specificare per campagna o gruppo di annunci è tre. Devi avere tre criteri separati per Computer, Smartphone e Tablet, altrimenti non possono esistere criteri di dispositivo per la campagna o il gruppo di annunci.
Se vengono specificati criteri di dispositivo a livello di gruppo di annunci, i criteri del dispositivo a livello di campagna vengono ignorati per tale gruppo di annunci. In altre parole, i criteri del dispositivo del gruppo di annunci sostituiscono i criteri del dispositivo della campagna e non vengono applicati come unione.
Consiglio
Per una panoramica su come usare i criteri di destinazione, vedi Mostra annunci al pubblico di destinazione.
È possibile scaricare tutti i record criteri DeviceOS della campagna nell'account includendo il valore DownloadEntity di CampaignTargetCriterions nella richiesta di servizio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Inoltre, la richiesta di download deve includere l'ambito EntityData . Per altre informazioni sul servizio bulk, incluse le procedure consigliate, vedere Download e caricamento in blocco.
Nell'esempio csv bulk seguente vengono aggiunti tre nuovi criteri del dispositivo della campagna (uno per ogni tipo di dispositivo) se viene fornito un valore id padre valido.
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 si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkCampaignDeviceOSCriterion , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.
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();
Per un record Campaign DeviceOS Criterion , i campi dell'attributo seguenti sono disponibili nello schema bulk del file.
Rettifica dell'offerta
Importo percentuale che si desidera modificare l'offerta per la destinazione corrispondente.
I valori supportati sono da -100 (100 negativi) a 900 (novecento) per cento positivi. L'impostazione della rettifica dell'offerta su -100% comporterà l'esclusione della destinazione corrispondente.
Aggiungere: Opzionale. La rettifica dell'offerta verrà impostata sul valore predefinito 0 se non inclusa.
Aggiornamento: Obbligatorio
Elimina: Sola lettura
Campagna
Nome della campagna in cui questo criterio viene applicato o rimosso.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
ID Client
Usato per associare i record nel file di caricamento bulk ai record nel file dei risultati. Il valore di questo campo non viene utilizzato o archiviato dal server; viene semplicemente copiato dal record caricato nel record di risultati corrispondente. Può essere qualsiasi stringa valida fino a 100 di lunghezza.
Aggiungere: Opzionale
Aggiornamento: Opzionale
Elimina: Opzionale
Id
Identificatore univoco di Microsoft Advertising del criterio.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio
Ora modifica
Data e ora dell'ultimo aggiornamento dell'entità. Il valore è espresso nell'ora UTC (Coordinated Universal Time).
Nota
Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Parent Id
Identificatore della campagna in cui questo criterio viene applicato o rimosso.
Questo campo bulk viene mappato al campo Id del record Campagna .
Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore campagna esistente o un identificatore negativo uguale al campo Id del record campagna padre. Questa opzione è consigliata se si aggiungono nuovi criteri a una nuova campagna nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio
Stato
Rappresenta lo stato di associazione tra la campagna e il criterio. Se il criterio viene applicato alla campagna, il valore di questo campo è Attivo. Per eliminare il criterio, impostare lo stato su Eliminato.
Aggiungere: Sola lettura. Lo stato verrà sempre impostato su Attivo quando si aggiungono criteri. Se si carica un altro valore, ad esempio, Foo il file di risultati conterrà lo stesso valore anche se il criterio è attivo.
Aggiornamento: Opzionale
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato. Per eliminare un'offerta di criterio del dispositivo specifica, è necessario caricare lo stato, l'ID e l'ID padre.
Destinazione
Nome del dispositivo di destinazione con la rettifica dell'offerta corrispondente.
I valori supportati sono Computer, Smartphone e Tablet.
Aggiungere: Obbligatorio. Nel file bulk devono essere specificate tre offerte separate per Computer, Smartphone e Tablet (ognuna delle quali in un record/riga separato). Se non si aggiungono singoli criteri di dispositivo che rappresentano ognuno dei tre tipi di dispositivo, non verranno aggiunti criteri di dispositivo per la campagna.
Aggiornamento: Obbligatorio
Elimina: Sola lettura