Condividi tramite

Record criterio finalità percorso campagna - Bulk

  • Articolo

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

Ogni criterio di finalità della posizione definisce l'opzione di finalità per tutti i criteri di posizione e raggio della campagna o del gruppo di annunci. Non esiste alcuna rettifica dell'offerta del criterio di accompagnamento.

Il numero massimo di criteri di finalità della posizione che puoi specificare per campagna o gruppo di annunci è uno.

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.

Consiglio

Per una panoramica su come usare i criteri di destinazione, vedi Mostra annunci al pubblico di destinazione.

È possibile scaricare tutti i record dei criteri di finalità della posizione 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 finalità della posizione 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 Location Intent Criterion,Active,,-111,,,ClientIdGoesHere,,PeopleIn,,,,,,,,,,

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkCampaignLocationIntentCriterion , 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 BulkCampaignLocationIntentCriterion
var bulkCampaignLocationIntentCriterion = new BulkCampaignLocationIntentCriterion
{
    // '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 LocationIntentCriterion
        {
            // 'Target' column header in the Bulk file
            IntentOption = IntentOption.PeopleIn
        },

        CriterionBid = null,

        // 'Id' column header in the Bulk file
        Id = null,

        // 'Status' column header in the Bulk file
        Status = CampaignCriterionStatus.Active,
    }
};

uploadEntities.Add(bulkCampaignLocationIntentCriterion);

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 Location Intent Criterion sono disponibili i campi di attributo seguenti nello schema bulk del file.

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 del criterio.

Nota

Attualmente l'identificatore del criterio di finalità della posizione è uguale all'identificatore padre, anche se non è consigliabile assumere una dipendenza da tale relazione. Come procedura consigliata, è consigliabile considerare l'identificatore del criterio di finalità della posizione come distinto.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
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

Parent Id

Identificatore di una 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 di 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 una campagna e il criterio. Se il criterio è impostato per una 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 criterio di finalità della posizione specifico, è necessario caricare lo stato e l'ID padre.

Destinazione

Determina se una persona deve trovarsi fisicamente nella posizione di destinazione affinché l'annuncio venga visualizzato.

Sono supportati i valori seguenti. Il valore predefinito è PeopleInOrSearchingForOrViewingPages.

  • Usa PeopleInOrSearchingForOrViewingPages se vuoi mostrare annunci agli utenti in, cercare o visualizzare pagine sulla tua posizione di destinazione.
  • Usa PeopleIn se vuoi mostrare annunci alle persone nella tua posizione di destinazione.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo, è necessario impostarlo su un valore valido, ad esempio PeopleInOrSearchingForOrViewingPages o PeopleIn.
Elimina: Sola lettura