Record dei criteri negativi del settore del gruppo di annunci - Bulk

  • Articolo

Definisce un criterio di settore negativo del gruppo di annunci che può essere caricato e scaricato in un file bulk.

È possibile escludere persone in un settore specifico in base a LinkedIn impostando l'ID profilo.

Microsoft Advertising applica un'unione dei criteri del profilo a livello di campagna e gruppo di annunci. Tuttavia, se applichi un criterio con lo stesso ID profilo, ad esempio target o escludi lo stesso nome aziendale sia a livello di campagna che di gruppo di annunci, il criterio a livello di gruppo di annunci sostituirà il criterio a livello di campagna.

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 settore negativi 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.

L'esempio CSV bulk seguente aggiungerebbe un nuovo criterio di settore negativo del gruppo di annunci se viene fornito un valore di ID padre valido.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Name,Profile Id,
Format Version,,,,,,,,,6.0,,
Ad Group Negative Industry Criterion,Active,,-1111,,,,ClientIdGoesHere,,,ProfileIdGoesHere,

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAdGroupNegativeIndustryCriterion , 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 BulkAdGroupNegativeIndustryCriterion
var bulkAdGroupNegativeIndustryCriterion = new BulkAdGroupNegativeIndustryCriterion
{
    // '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",

    // 'Profile' column header in the Bulk file is read-only
    ProfileName = null,

    // Map properties in the Bulk file to the 
    // NegativeAdGroupCriterion object of the Campaign Management service.

    NegativeAdGroupCriterion = new NegativeAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,

        Criterion = new ProfileCriterion
        {
            // 'Profile Id' column header in the Bulk file
            ProfileId = 0,

            // Maps to the 'Ad Group Negative Industry Criterion' record name in the Bulk file
            ProfileType = ProfileType.Industry
        },

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

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

uploadEntities.Add(bulkAdGroupNegativeIndustryCriterion);

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 settore negativi del gruppo di annunci, i campi di attributo seguenti sono disponibili nello schema del file bulk.

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

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

Profilo

Nome visualizzato del profilo del gruppo di destinatari in inglese.

Per scaricare i nomi visualizzati del profilo in altre lingue, è possibile chiamare l'operazione GetProfileDataFileUrl tramite l'API Campaign Management.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura

ID profilo

Identificatore del profilo del gruppo di destinatari da escludere.

Per informazioni dettagliate su come ottenere gli identificatori del profilo, vedere Dati del profilo.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Elimina: 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 criterio di settore specifico, è necessario caricare lo stato, l'ID e l'ID padre.