Record sito negativo gruppo di annunci - Bulk
Definisce un sito negativo assegnato a un gruppo di annunci che può essere caricato e scaricato in un file bulk.
Nello schema bulk ognuno dei siti negativi associati a un gruppo di annunci è rappresentato singolarmente dalla propria riga. Ad esempio, se si dispone di due siti negativi, questi sono rappresentati da due record del sito negativo del gruppo di annunci nel file bulk con Stato impostato su Attivo. Quando si caricano o scaricano record per un elenco aggiornato di siti negativi associati, lo stato di un record sarà impostato su Eliminato con un campo Sito Web vuoto. Ciò indica che sono state apportate alcune modifiche all'elenco e che i record del sito negativo del gruppo di annunci che seguono sono attivi.
Nota
Il sito negativo del gruppo di annunci può essere aggiunto ed eliminato, ma non può essere aggiornato.
È possibile scaricare tutti i record del sito negativo del gruppo ad nell'account includendo il valore DownloadEntity di AdGroupNegativeSites 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 sito negativo del gruppo di annunci se viene specificato un valore id padre valido.
Type,Status,Id,Parent Id,Campaign,Ad Group,Website,Client Id,Modified Time,Name
Format Version,,,,,,,,,6.0
Ad Group Negative Site,Active,,-1111,,,contoso.com,ClientIdGoesHere,,
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAdGroupNegativeSite , 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 BulkAdGroupNegativeSites
var bulkAdGroupNegativeSites = new BulkAdGroupNegativeSites
{
// 'Ad Group' column header in the Bulk file
AdGroupName = null,
// Map properties in the Bulk file to the
// AdGroupNegativeSites object of the Campaign Management service.
AdGroupNegativeSites = new AdGroupNegativeSites
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
NegativeSites = new[]
{
// 'Website' column header in the Bulk file
"contoso.com",
}
},
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Status' column header in the Bulk file
Status = Status.Active,
};
// BulkAdGroupNegativeSites does not support 'Client Id' and
// replaces all negative sites for the ad group, whereas BulkAdGroupNegativeSite
// enables you to add or delete one negative site at a time.
// Map properties in the Bulk file to the BulkAdGroupNegativeSite
var bulkAdGroupNegativeSite = new BulkAdGroupNegativeSite
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
// 'Ad Group' column header in the Bulk file
AdGroupName = null,
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
// 'Website' column header in the Bulk file
Website = "contoso.com",
};
uploadEntities.Add(bulkAdGroupNegativeSite);
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 sito negativo del gruppo di annunci, i campi dell'attributo seguenti sono disponibili nello schema file bulk.
Gruppo di annunci
Nome del gruppo di annunci che contiene il sito negativo.
Aggiungere: Sola lettura e Obbligatorio
Aggiornare: Non applicabile. Un sito negativo può essere aggiunto ed eliminato, ma non può essere aggiornato.
Cancellare: Sola lettura e Obbligatorio
Nota
Per l'aggiunta e l'eliminazione, è necessario specificare il campo Id padre o Gruppo di annunci .
Campagna
Nome della campagna che contiene il gruppo di annunci e il sito negativo.
Aggiungere: Sola lettura
Aggiornare: Non applicabile. Un sito negativo può essere aggiunto ed eliminato, ma non può essere aggiornato.
Cancellare: 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
Aggiornare: Non applicabile. Un sito negativo può essere aggiunto ed eliminato, ma non può essere aggiornato.
Cancellare: 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
Aggiornare: Non applicabile. Un sito negativo può essere aggiunto ed eliminato, ma non può essere aggiornato.
Cancellare: Sola lettura
Parent Id
Identificatore generato dal sistema del gruppo di annunci che contiene il sito negativo.
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. Questo è consigliato se si aggiungono nuovi siti negativi a un nuovo gruppo di annunci nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornare: Non applicabile. Un sito negativo può essere aggiunto ed eliminato, ma non può essere aggiornato.
Cancellare: Sola lettura
Nota
Per l'aggiunta e l'eliminazione, è necessario specificare il campo Id padre o Gruppo di annunci .
Stato
Rappresenta lo stato di associazione tra il gruppo di annunci e il sito negativo.
Se il sito negativo è associato al gruppo di annunci, il valore di questo campo è Attivo.
I valori possibili sono Attivo o Eliminato.
Aggiungere: Opzionale. Il valore predefinito è Attivo.
Aggiornare: Non applicabile. Un sito negativo può essere aggiunto ed eliminato, ma non può essere aggiornato.
Cancellare: Obbligatorio. Lo stato deve essere impostato su Eliminato. Per eliminare un sito negativo specifico, è necessario caricare lo stato, l'ID padre e il sito Web. Per eliminare tutti i siti negativi per il gruppo di annunci, è sufficiente caricare lo stato e l'ID padre in un singolo record. Facoltativamente, è quindi possibile aggiungere nuovi record del sito negativi per sostituire il set eliminato.
Sito Web
URL del sito Web in cui non vuoi visualizzare i tuoi annunci.
Ogni URL deve specificare il nome di dominio, ad esempio contoso.com che può includere fino a tre sottodomini e due sottodirectory. Il numero di sottodomini include il prefisso www . Ad esempio , one.two.three.contoso.com/1/2, www.two.three.contoso.com/1/2 e one.two.contoso.co.uk/1/2 sono URL validi, mentre one.two.three.contoso.co.uk/1/2 (troppi sottodomini) e one.two.three.contoso.com/1/2/3 (troppe sottodirectory) non lo sono. Gli URL dei siti negativi duplicati per campagna o gruppo di annunci non sono consentiti.
È possibile escludere solo i siti Web per siti Web di ricerca di diffusione. La rete del gruppo di annunci deve essere impostata su OwnedAndOperatedAndSyndicatedSearch.
Gli URL del sito negativi specificati a livello di gruppo di annunci vengono usati invece degli URL del sito negativi specificati a livello di campagna. Se associ elenchi di esclusione di siti Web a un account pubblicitario (disponibile tramite il servizio Campaign Management), l'elenco dei siti negativi viene usato oltre ai siti negativi della campagna o ai siti negativi del gruppo di annunci.
Aggiungere: Obbligatorio
Aggiornare: Non applicabile. Un sito negativo può essere aggiunto ed eliminato, ma non può essere aggiornato.
Cancellare: Sola lettura