Record criteri di posizione del gruppo di annunci - Bulk
Definisce un criterio di posizione del gruppo di annunci che può essere caricato e scaricato in un file bulk.
Con i criteri di posizione, puoi scegliere di mostrare annunci a potenziali clienti in, cercare o visualizzare pagine su:
- Tutti i paesi/aree geografiche disponibili
- Città selezionate, codici postali, aree metropolitane (Area di mercato Microsoft nel Stati Uniti), contee, stati/province e paesi/aree geografiche
Ogni criterio di località definisce un codice di località per la rettifica dell'offerta del criterio associato.
Il numero massimo di criteri di posizione combinata e posizione negativa che puoi specificare per campagna o gruppo di annunci è 10.000.
Nota
Puoi avere un solo record del criterio di finalità della posizione del gruppo di annunci per ogni gruppo di annunci per determinare l'opzione di finalità della posizione che si applica a tutti i record criteri di località del gruppo di annunci e criteri radius del gruppo di annunci . Quando crei il primo criterio del gruppo di annunci, verrà aggiunto automaticamente anche un record criterio di finalità della posizione del gruppo di annunci con target predefinito impostato su PeopleInOrSearchingForOrViewingPages. Puoi aggiungere o aggiornare il criterio di finalità della posizione del gruppo di annunci di un gruppo di annunci, indipendentemente dal fatto che il gruppo di annunci abbia o meno altri criteri. Non puoi eliminare il criterio di finalità della posizione del gruppo di annunci di un gruppo di annunci, anche se non ha scopo senza criteri di posizione o raggio.
Se vengono specificati criteri di posizione a livello di gruppo di annunci (positivi o negativi), i criteri di posizione a livello di campagna vengono ignorati per tale gruppo di annunci. In altre parole, i criteri di posizione del gruppo di annunci sostituiscono i criteri di posizione 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 dei criteri di posizione 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.
Nell'esempio csv bulk seguente viene aggiunto un nuovo criterio di posizione del gruppo di annunci 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 Location Criterion,Active,,-1111,Country,,,ClientIdGoesHere,,190,20,,,,,,,,,,
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAdGroupLocationCriterion , 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 BulkAdGroupLocationCriterion
var bulkAdGroupLocationCriterion = new BulkAdGroupLocationCriterion
{
// '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 LocationCriterion
{
// 'Target' column header in the Bulk file
LocationId = 190,
// 'Sub Type' column header in the Bulk file
LocationType = "Country"
},
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,
}
};
uploadEntities.Add(bulkAdGroupLocationCriterion);
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 di posizione del gruppo di annunci, i campi dell'attributo seguenti sono disponibili nello schema file bulk.
- Gruppo di annunci
- Rettifica dell'offerta
- Campagna
- Client Id
- Id
- Ora modifica
- Parent Id
- Stato
- Sottotipo
- Destinazione
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 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 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 specifica per il criterio di località, è necessario caricare lo stato, l'ID e l'ID padre.
Sottotipo
Sottotipo di posizione di destinazione. Ad esempio, il valore è City se il record rappresenta un criterio di località della città.
Nota
Le località del quartiere saranno presto disponibili. Il sottotipo sarà Neighborhood.
È possibile aggiungere nuovi sottotipi di posizione in qualsiasi momento. Raramente il tipo di posizione cambia per un DETERMINATO ID posizione.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Destinazione
Identificatore della località a cui si vuole assegnare la rettifica dell'offerta corrispondente.
Per i valori possibili, vedere il campo Id posizione del file delle posizioni geografiche. È possibile chiamare l'operazione GetGeoLocationsFileUrl per scaricare il file.
Importante
Prima di aggiungere o aggiornare un criterio di posizione, controllare il campo Stato nel file delle posizioni geografiche . Se lo stato è PendingDeprecation, il criterio di posizione non viene più usato per la destinazione o le esclusioni. È comunque possibile recuperare i criteri di posizione deprecati, ma non è possibile aggiungere o aggiornare i criteri di posizione deprecati.
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: Sola lettura