Campagna negativa nel record dell'associazione del pubblico di mercato - Bulk

Definisce un'associazione campaign negative in market audience che può essere caricata e scaricata in un file bulk.

Nota

Questa funzionalità è disponibile in Australia, Canada, Francia, Germania, Regno Unito e Stati Uniti.

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 Campaign Negative In Market Audience Association nell'account includendo il valore DownloadEntity di CampaignNegativeInMarketAudienceAssociations 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 aggiunta una nuova campaign negative in market audience association se viene specificato un valore 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,,
Campaign Negative In Market Audience Association,Paused,,-1111,,,ClientIdGoesHere,,,,InMarketAudienceIdHere,My In Market 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 BulkCampaignNegativeInMarketAudienceAssociation , 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 BulkCampaignNegativeInMarketAudienceAssociation
var bulkCampaignNegativeInMarketAudienceAssociation = new BulkCampaignNegativeInMarketAudienceAssociation
{
    // 'Campaign' column header in the Bulk file
    CampaignName = null,

    // Map properties in the Bulk file to the 
    // NegativeCampaignCriterion object of the Campaign Management service.
    NegativeCampaignCriterion = new NegativeCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = inMarketAudienceIdKey,
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = CampaignCriterionStatus.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(bulkCampaignNegativeInMarketAudienceAssociation);

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 Campaign Negative In Market Audience Association , i campi di attributo seguenti sono disponibili nello schema bulk del file.

Gruppo di destinatari

Nome del pubblico sul mercato.

Questo campo bulk è mappato al campo Audience del record In Market Audience .

Il download bulk delle API restituisce tutte le associazioni di destinatari sul mercato, indipendentemente dal fatto che il gruppo di destinatari sul mercato sia attivo o eliminato. Se l'associazione è per un gruppo di destinatari sul mercato eliminato, questo campo verrà impostato sullo stesso valore del campo ID gruppo di destinatari .

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 campaign negative nel gruppo di destinatari di mercato con nuovi gruppi di destinatari sul mercato nello stesso file bulk e se non si imposta il campo ID gruppo di destinatari , questo campo Destinatari deve essere impostato come chiave logica sullo stesso valore del campo Destinatari del record Destinatari nel mercato . 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 pubblico sul mercato associato alla campagna.

Questo campo bulk viene mappato al campo Id del record In Market Audience .

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 esistente sul mercato o specificare un identificatore negativo uguale al campo Id del record padre In Market Audience . Se il campo ID gruppo di destinatari non è impostato, è necessario impostare il campo Audience come chiave logica sullo stesso valore del campo Audience del record In Market Audience.If the Audience ID field is not set, then you must set the Audience field as a logical key to the same value of the Audience field of the In Market Audience record. Una di queste opzioni è consigliata se si aggiungono nuove associazioni campaign negative nel pubblico di mercato con nuovi gruppi di destinatari sul mercato 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 associata al pubblico sul mercato.

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

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Campagna .

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 una campagna e il pubblico sul mercato.

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 generato dal sistema della campagna associata al pubblico sul mercato.

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. Questa opzione è consigliata se si associano gruppi di destinatari sul mercato a una nuova campagna 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

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Campagna .

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.