Record di associazione di destinatari personalizzati negativi del gruppo di annunci - Bulk

Definisce un'associazione di destinatari personalizzata negativa del gruppo di annunci che può essere caricata e scaricata in un file bulk.

Gli obiettivi del gruppo di destinatari non possono essere impostati sia a livello di campagna che di gruppo di annunci. Se imposti criteri di gruppo di destinatari a livello di campagna a livello di campagna, non puoi impostare criteri di gruppo di destinatari a livello di gruppo di annunci disponibili. Le esclusioni del pubblico possono essere impostate sia a livello di campagna che di gruppo di annunci. Microsoft Advertising applica un'unione di esclusioni a livello di campagna e gruppo di annunci.

È possibile scaricare tutti i record dell'associazione di destinatari personalizzati di Ad Group Negative nell'account includendo il valore DownloadEntity di AdGroupNegativeCustomAudienceAssociations 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 una nuova associazione di destinatari personalizzati negativi del gruppo di annunci se viene specificato un valore di ID padre valido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Ad Group Negative Custom Audience Association,Paused,,-1111,,,ClientIdGoesHere,,,,CustomAudienceIdHere,My Custom Audience

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAdGroupNegativeCustomAudienceAssociation , 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 BulkAdGroupNegativeCustomAudienceAssociation
var bulkAdGroupNegativeCustomAudienceAssociation = new BulkAdGroupNegativeCustomAudienceAssociation
{
    // 'Ad Group' column header in the Bulk file
    AdGroupName = 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 AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = customAudienceIdKey,
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Audience' column header in the Bulk file
    AudienceName = null,
};

uploadEntities.Add(bulkAdGroupNegativeCustomAudienceAssociation);

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 associazione di destinatari personalizzata negativa del gruppo di annunci, i campi dell'attributo seguenti sono disponibili nello schema file bulk.

• Gruppo di annunci
• Gruppo di destinatari
• ID gruppo di destinatari
• Campagna
• Client Id
• Id
• Ora modifica
• Parent Id
• Stato

Gruppo di annunci

Nome del gruppo di annunci associato al gruppo di destinatari personalizzato.

Aggiungere: Sola lettura e Obbligatorio
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

Gruppo di destinatari

Nome del gruppo di destinatari personalizzato.

Questo campo bulk viene mappato al campo Audience del record del gruppo di destinatari personalizzato .

Aggiungere: Sola lettura e Obbligatorio per alcuni casi d'uso. È necessario specificare il campo Gruppo di destinatari o ID gruppo di destinatari . Se si aggiungono nuove associazioni di gruppi di destinatari personalizzati negativi del gruppo di annunci con nuovi gruppi di destinatari personalizzati nello stesso file bulk e se non si imposta il campo ID gruppo di destinatari , questo campo Gruppo di destinatari deve essere impostato come chiave logica sullo stesso valore del campo Pubblico del record gruppo di destinatari personalizzato . Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura
Elimina: Sola lettura

ID gruppo di destinatari

Identificatore di Microsoft Advertising del gruppo di destinatari personalizzato associato al gruppo di annunci.

Questo campo bulk esegue il mapping al campo ID del record del gruppo di destinatari personalizzato .

Aggiungere: Sola lettura e Obbligatorio per alcuni casi d'uso. È necessario specificare il campo Gruppo di destinatari o ID gruppo di destinatari . Se si imposta il campo ID gruppo di destinatari, è necessario specificare un identificatore di gruppo di destinatari personalizzato esistente o un identificatore negativo uguale al campo Id del record gruppo di destinatari personalizzato padre. Se il campo ID gruppo di destinatari non è impostato, è necessario impostare il campo Gruppo di destinatari come chiave logica sullo stesso valore del campo Destinatari del record gruppo di destinatari personalizzato . Una di queste opzioni è consigliata se si aggiungono nuove associazioni di gruppi di destinatari personalizzati negativi del gruppo di annunci con nuovi gruppi di destinatari personalizzati nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura
Elimina: Sola lettura

Campagna

Nome della campagna che contiene il gruppo di annunci.

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

Id

Identificatore generato dal sistema per l'associazione tra un gruppo di annunci e un gruppo di destinatari personalizzato.

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).

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

Parent Id

Identificatore generato dal sistema del gruppo di annunci associato al gruppo di destinatari personalizzato.

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 associano gruppi di destinatari personalizzati 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

Stato dell'associazione.

I valori possibili sono Attivo o Eliminato.

Aggiungere: Opzionale. Il valore di stato predefinito è Attivo.
Aggiornamento: Opzionale
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.