Record sito negativo campagna - Bulk
Definisce un sito negativo assegnato a una campagna che può essere caricata e scaricata in un file bulk.
Nello schema bulk ogni sito negativo associato a una campagna è rappresentato singolarmente dalla propria riga. Ad esempio, se si dispone di due siti negativi, questi sono rappresentati da due record del sito negativo campagna 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 della campagna che seguono sono attivi.
Nota
Il sito negativo della campagna può essere aggiunto ed eliminato, ma non può essere aggiornato.
È possibile scaricare tutti i record del sito negativo della campagna nell'account includendo il valore DownloadEntity di CampaignNegativeSites 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 della campagna se viene specificato un valore di ID padre valido.
Type,Status,Id,Parent Id,Campaign,Ad Group,Website,Client Id,Modified Time,Name
Format Version,,,,,,,,,6.0
Campaign Negative Site,Active,,-112,,,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 BulkCampaignNegativeSite , 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 BulkCampaignNegativeSites
var bulkCampaignNegativeSites = new BulkCampaignNegativeSites
{
// 'Campaign' column header in the Bulk file
CampaignName = null,
// Map properties in the Bulk file to the
// CampaignNegativeSites object of the Campaign Management service.
CampaignNegativeSites = new CampaignNegativeSites
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
NegativeSites = new[]
{
// 'Website' column header in the Bulk file
"contoso.com",
}
},
// 'Status' column header in the Bulk file
Status = Status.Active,
};
// BulkCampaignNegativeSites does not support 'Client Id' and
// replaces all negative sites for the campaign, whereas BulkCampaignNegativeSite
// enables you to add or delete one negative site at a time.
// Map properties in the Bulk file to the BulkCampaignNegativeSite
var bulkCampaignNegativeSite = new BulkCampaignNegativeSite
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
// '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(bulkCampaignNegativeSite);
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 del sito negativo della campagna , i campi dell'attributo seguenti sono disponibili nello schema file bulk.
Campagna
Nome della campagna 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
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 della campagna che contiene il sito negativo.
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. È consigliabile aggiungere nuovi siti negativi a una nuova campagna 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
Stato
Rappresenta lo stato di associazione tra la campagna e il sito negativo.
Se il sito negativo è associato alla campagna, 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 la campagna, è 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