Record criteri raggio campagna - Bulk

Definisce un criterio di raggio della campagna che può essere caricato e scaricato in un file bulk.

Con i criteri radius, puoi scegliere di mostrare annunci a potenziali clienti in, cercare o visualizzare pagine su un raggio specifico intorno a un codice postale, coordinate, punti di riferimento o area.

Ogni criterio di raggio definisce un raggio, una latitudine e una longitudine per l'adeguamento dell'offerta del criterio associato.

Il numero massimo di criteri raggio che puoi specificare per campagna o gruppo di annunci è 2.000.

Nota

È possibile avere un solo record del criterio di finalità della posizione della campagna per ogni campagna per determinare l'opzione di finalità della posizione che si applica a tutti i record Criteri località campagna e Criterio raggio campagna della campagna. Quando si crea il primo criterio della campagna, verrà aggiunto automaticamente anche un record Criteri di finalità della posizione della campagna con target predefinito impostato su PeopleInOrSearchingForOrViewingPages. È possibile aggiungere o aggiornare il criterio di finalità della posizione della campagna, indipendentemente dal fatto che la campagna abbia o meno altri criteri. Non è possibile eliminare il criterio di finalità della località campagna di una campagna, anche se non ha scopo senza criteri di posizione o raggio.

Se vengono specificati criteri di raggio a livello di gruppo di annunci, i criteri di raggio a livello di campagna vengono ignorati per tale gruppo di annunci. In altre parole, i criteri radius del gruppo di annunci sostituiscono i criteri di raggio della campagna e non vengono applicati come unione.

Si noti inoltre che è necessario considerare i criteri di posizione, posizione negativa e raggio come set di criteri geografici. Se il gruppo di annunci ha criteri geografici, nessuno dei criteri geografici della campagna viene ereditato. Se il gruppo di annunci non ha criteri geografici, tutti i criteri geografici della campagna vengono ereditati. I criteri geografici possono essere ereditati dalla campagna anche se il gruppo di annunci ha un criterio di finalità della posizione. Se vengono usati i criteri geografici del gruppo di annunci, viene usato il criterio di finalità della posizione del gruppo di annunci; se i criteri geografici della campagna vengono ereditati, viene usato il criterio di finalità della posizione della campagna e il criterio di finalità della posizione del gruppo di annunci viene ignorato. Non puoi eliminare il criterio di finalità della posizione di una campagna o di un gruppo di annunci, anche se non ha scopo senza criteri di posizione o raggio.

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 Radius 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 viene aggiunto un nuovo criterio di raggio della campagna se viene specificato 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 Radius Criterion,Active,,-111,,,ClientIdGoesHere,,RadiusName,20,,10,Kilometers,,,,,10.5,40.5

Se si usano gli SDK Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkCampaignRadiusCriterion , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignRadiusCriterion
var bulkCampaignRadiusCriterion = new BulkCampaignRadiusCriterion
{
    // '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 RadiusCriterion
        {
            // 'Latitude' column header in the Bulk file
            LatitudeDegrees = 10.5,

            // 'Longitude' column header in the Bulk file
            LongitudeDegrees = 40.5,

            // 'Name' column header in the Bulk file
            Name = "RadiusName",

            // 'Radius' column header in the Bulk file
            Radius = 10,

            // 'Unit' column header in the Bulk file
            RadiusUnit = DistanceUnit.Kilometers,
        },

        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,
    }
};

uploadEntities.Add(bulkCampaignRadiusCriterion);

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 Radius Criterion , i campi dell'attributo seguenti sono disponibili nello schema del file bulk.

• Rettifica dell'offerta
• Campagna
• Client Id
• Id
• Latitudine
• Longitudine
• Ora modifica
• Nome
• Parent Id
• Raggio
• Stato
• Unità

Rettifica dell'offerta

Importo percentuale che si desidera modificare l'offerta per il criterio di raggio corrispondente.

I valori supportati sono negativi da novanta (-90) a 900 positivi (900).

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

Latitudine

La latitudine, espressa in gradi, del criterio di posizione.

La latitudine deve essere maggiore o uguale a -85,0 e minore o uguale a +85,0.

È possibile specificare la latitudine e la longitudine come valori decimali. Ad esempio, la latitudine e la longitudine di One Redmond Way, Redmond, WA sono rispettivamente 47,755367 e -122.091827. Per ottenere questi valori, è possibile immettere l'indirizzo di una posizione geografica in Bing Mappe e le coordinate verranno visualizzate sotto l'indirizzo.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura

Longitudine

Longitudine, espressa in gradi, del criterio di posizione.

La longitudine deve essere maggiore o uguale a -180,0 e minore o uguale a +180,0.

È possibile specificare la latitudine e la longitudine come valori decimali. Ad esempio, la latitudine e la longitudine di One Redmond Way, Redmond, WA sono rispettivamente 47,755367 e -122.091827. Per ottenere questi valori, è possibile immettere l'indirizzo di una posizione geografica in Bing Mappe e le coordinate verranno visualizzate sotto l'indirizzo.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura

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

Nome

Nome della posizione geografica di destinazione.

Il nome può contenere un massimo di 50 caratteri.

Aggiungere: Opzionale
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

Raggio

Raggio che specifica l'area che circonda la posizione geografica di destinazione.

Se il campo Unità radius è impostato su Miglia, vengono accettati valori interi positivi compresi tra 1 e 500.

Se il campo Unità radius è impostato su Chilometri, vengono accettati valori interi positivi compresi tra 1 e 800.

Nota

Il tipo di dati è double e può essere supportato in una versione futura. Attualmente il servizio accetta e restituisce solo valori integer.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura

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 specifica per il criterio di località, è necessario caricare lo stato, l'ID e l'ID padre.

Unità

Unità di misura per il raggio specificato.

I valori supportati sono Miglia (impostazione predefinita) e Chilometri.

Aggiungere: Opzionale. Se non specificato, verrà impostato il valore predefinito di Miles .
Aggiornamento: Obbligatorio
Elimina: Sola lettura