Condividi tramite

Record del criterio DeviceOS del gruppo di annunci - Bulk

  • Articolo

Definisce un criterio del dispositivo del gruppo di annunci 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 del criterio DeviceOS del gruppo ad nell'account includendo il valore DownloadEntity di AdGroupTargetCriterions 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.

L'esempio csv bulk seguente aggiunge tre nuovi criteri di dispositivo del gruppo di annunci (uno per ogni tipo di dispositivo) se viene fornito un valore id padre valido.

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 DeviceOS Criterion,Active,,-1111,,,,ClientIdGoesHere,,Computers,20,,,,,,,,,,
Ad Group DeviceOS Criterion,,,-1111,,,,ClientIdGoesHere,,Smartphones,0,,,,,,,,,,
Ad Group DeviceOS Criterion,,,-1111,,,,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 BulkAdGroupDeviceOSCriterion , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.

var uploadEntities = new List<BulkEntity>();

var bulkAdGroupDeviceCriterions = new [] {
    // Map properties in the Bulk file to the BulkAdGroupDeviceCriterion
    new BulkAdGroupDeviceCriterion
    {
        // '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 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 = AdGroupCriterionStatus.Active,
        }
    },
    new BulkAdGroupDeviceCriterion
    {
        ClientId = "ClientIdGoesHere",
        BiddableAdGroupCriterion = new BiddableAdGroupCriterion
        {
            AdGroupId = adGroupIdKey,
            Criterion = new DeviceCriterion
            {
                DeviceName = "Smartphones",
            },
            CriterionBid = new BidMultiplier
            {
                Multiplier = 0,
            },
        }
    },
    new BulkAdGroupDeviceCriterion
    {
        ClientId = "ClientIdGoesHere",
        BiddableAdGroupCriterion = new BiddableAdGroupCriterion
        {
            AdGroupId = adGroupIdKey,
            Criterion = new DeviceCriterion
            {
                DeviceName = "Tablets",
            },
            CriterionBid = new BidMultiplier
            {
                Multiplier = 0,
            },
        }
    },
};

foreach (var bulkAdGroupDeviceCriterion in bulkAdGroupDeviceCriterions)
{
    uploadEntities.Add(bulkAdGroupDeviceCriterion);
}

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 criteri DeviceOS del gruppo di annunci , i campi dell'attributo seguenti sono disponibili nello schema del file bulk.

Gruppo di annunci

Nome del gruppo di annunci in cui questo criterio viene applicato o rimosso.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura

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 che contiene il gruppo di annunci 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 del gruppo di annunci in cui questo criterio viene applicato o rimosso.

Questo campo bulk viene mappato al campo Id del record gruppo di annunci .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore del gruppo di annunci esistente o un identificatore negativo uguale al campo Id del record gruppo di annunci padre. Questa opzione è consigliata se si aggiungono nuovi criteri a un nuovo gruppo di annunci 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 il gruppo di annunci e il criterio. Se il criterio viene applicato al gruppo di annunci, 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 aggiungi singoli criteri di dispositivo che rappresentano ognuno dei tre tipi di dispositivo, non verranno aggiunti criteri di dispositivo per il gruppo di annunci.
Aggiornamento: Obbligatorio
Elimina: Sola lettura