Record del gruppo di destinatari personalizzato - Bulk

  • Articolo

Definisce un gruppo di destinatari personalizzato che può essere scaricato e caricato in un file bulk.

Nota

Solo l'aggiornamento dei campi Destinatari (nome gruppo di destinatari) e Descrizione è supportato per il caricamento. È possibile eliminare ma non aggiungere un gruppo di destinatari personalizzato usando l'API Bing Ads. Detto questo, è possibile aggiungere ed eliminare associazioni di destinatari ed esclusioni personalizzate.

Un gruppo di destinatari personalizzato è un tipo di elenco di remarketing generato usando i dati dei clienti per creare segmenti utente più completi. È possibile usare gruppi di destinatari personalizzati in combinazione con gli elenchi di remarketing, in genere tramite il provider di gestione dati (DMP). Quando il tuo DMP si connette alla nostra funzionalità di audience personalizzata, puoi importare i tuoi gruppi di destinatari personalizzati in Microsoft Advertising per il remarketing di ricerca. È possibile usare gruppi di destinatari personalizzati separatamente dal remarketing, senza uet obbligatorio.

Consiglio

Per una panoramica e altre informazioni sui gruppi di destinatari, vedere la guida tecnica sulle API audience .

È possibile scaricare tutti i record del gruppo di destinatari personalizzati nell'account includendo il valore DownloadEntity di CustomAudiences nella richiesta del 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 aggiornata la descrizione di un gruppo di destinatari personalizzato. Nota: per un gruppo di destinatari personalizzato la durata dell'appartenenza non è impostata nell'applicazione Web Microsoft Advertising e Microsoft Advertising rinvia alle impostazioni del provider di gruppi di destinatari personalizzato.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
Custom Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,Updated Custom Audience Description,30,Account,Custom Audience,Search;DynamicSearchAds;Shopping;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 BulkCustomAudience , 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 BulkCustomAudience
var bulkCustomAudience = new BulkCustomAudience
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // CustomAudience object of the Campaign Management service.
    CustomAudience = new CustomAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "Updated Custom Audience Description",
        // 'Id' column header in the Bulk file
        Id = customAudienceIdKey,
        // 'Audience' column header in the Bulk file
        Name = null,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = null,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCustomAudience);

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

Gruppo di destinatari

Nome del gruppo di destinatari personalizzato.

Il nome può contenere un massimo di 128 caratteri.

Aggiungere: Non supportato
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Dimensioni della rete del gruppo di destinatari

Numero totale di persone che sono membri attivi di questo gruppo di destinatari nella rete Audience. In questo modo si ha un'idea del numero di utenti di rete audience che è possibile definire come target.

Il pubblico deve avere almeno 300 persone prima che Microsoft Advertising lo usi per le ottimizzazioni.

Aggiungere: Non supportato
Aggiornamento: Sola lettura
Elimina: Sola lettura

Dimensioni della ricerca del gruppo di destinatari

Numero totale di persone che sono membri attivi di questo gruppo di destinatari nella rete di ricerca. In questo modo si ha un'idea del numero di utenti di ricerca di destinazione.

Il pubblico deve avere almeno 300 persone prima che Microsoft Advertising lo usi per le ottimizzazioni.

Questa proprietà sarà vuota per un massimo di 24 ore durante la compilazione del gruppo di destinatari, ad esempio se sono stati importati nuovi gruppi di destinatari personalizzati da DMP, sono necessarie 24 ore per compilare il gruppo di destinatari e nel frattempo questa proprietà sarà vuota.

Aggiungere: Non supportato
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: Non supportato
Aggiornamento: Opzionale
Elimina: Sola lettura

Descrizione

Descrizione del gruppo di destinatari personalizzato. Usare una descrizione per ricordare il gruppo di destinatari a cui si sta rivolgendo questo gruppo di destinatari personalizzato.

La descrizione può contenere un massimo di 1.024 caratteri.

Aggiungere: Non supportato
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura

Id

Identificatore generato dal sistema del gruppo di destinatari personalizzato.

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

Durata appartenenza

La durata dell'appartenenza determina quanto tempo fa Microsoft Advertising deve cercare le azioni che corrispondono alla definizione del gruppo di destinatari personalizzato per aggiungere persone all'elenco. Per un gruppo di destinatari personalizzato, la durata dell'appartenenza non è impostata nell'applicazione Web Microsoft Advertising e Microsoft Advertising rinvia alle impostazioni del provider di gruppi di destinatari personalizzato.

Quando si richiede il gruppo di destinatari personalizzato tramite l'API Bing Ads, la durata dell'appartenenza restituita sarà Null.

Aggiungere: Non supportato
Aggiornamento: Non supportato
Elimina: 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: Non supportato
Aggiornamento: Sola lettura
Elimina: Sola lettura

Parent Id

Identificatore microsoft advertising del cliente che contiene il gruppo di destinatari personalizzato.

Aggiungere: Non supportato
Aggiornamento: Obbligatorio
Elimina: Sola lettura

Ambito

L'ambito definisce gli account che possono usare questo gruppo di destinatari personalizzato. Per un gruppo di destinatari personalizzato, l'unico ambito supportato è Customer e il gruppo di destinatari personalizzato può essere associato a qualsiasi campagna e gruppo di annunci in tutti gli account del cliente.

Aggiungere: Non supportato
Aggiornamento: Sola lettura
Elimina: Sola lettura

Stato

Stato del gruppo di destinatari personalizzato.

I valori possibili sono Attivo o Eliminato.

Aggiungere: Non supportato
Aggiornamento: Sola lettura
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.

Tipi di campagna supportati

Elenco delimitato da punto e virgola dei tipi di campagna che supportano questo gruppo di destinatari personalizzato.

I valori supportati sono Audience, DynamicSearchAds, Search e Shopping. In futuro potrebbero essere aggiunti nuovi tipi di campagna, quindi non è consigliabile assumere alcuna dipendenza da un set fisso di valori.

Aggiungere: Non supportato
Aggiornamento: Sola lettura
Elimina: Sola lettura