Record elenco combinato - Bulk

  • Articolo

Definisce un elenco combinato che può essere scaricato e caricato in un file bulk.

Un elenco combinato è un gruppo di destinatari creato da una combinazione di più gruppi di destinatari esistenti.

Consiglio

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

È possibile scaricare tutti i record dell'elenco combinato nell'account includendo il valore DownloadEntity di CombinedLists 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 elenco combinato.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Combination Rule
Format Version,,,,,,6.0,,,,,,
Combined List,Active,-10,,ClientIdGoesHere,,,New combined list description,Customer,New Combined List,NOT(123IdGoesHere,234IdGoesHere)&AND(345IdGoesHere,456IdGoesHere)&OR(567IdGoesHere)

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkCombinedList , 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 BulkCombinedList
var bulkCombinedList = new BulkCombinedList
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // CombinedList object of the Campaign Management service.
    CombinedList = new CombinedList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Combined List",
        // 'Id' column header in the Bulk file
        Id = combinedListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Combined List " + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Combination Rule' column header in the Bulk file
        CombinationRules = new[]
        {
            // Each rule is delimited by a semicolon (;) in the Bulk file
            new CombinationRule
            {
                AudienceIds = new [] { 123, 234 },
                Operator = LogicalOperator.And
            },
            new CombinationRule
            {
                AudienceIds = new [] { 345, 456 },
                Operator = LogicalOperator.And
            },
        },
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // '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(bulkCombinedList);

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 elenco combinato , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

Gruppo di destinatari

Nome dell'elenco combinato.

Il nome può contenere un massimo di 128 caratteri.

Aggiungere: Obbligatorio
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: Sola lettura
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 si aggiunge o si aggiorna la durata combinata dell'appartenenza all'elenco, la regola o l'identificatore di tag.

Questa proprietà sarà vuota se il tag UET associato all'elenco combinato ha lo stato Non verificato o Inattivo, perché l'elenco combinato non può ricevere le informazioni sui clienti dal sito Web necessario per compilare l'elenco.

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

Regola di combinazione

Una regola di combinazione include le condizioni usate per determinare chi aggiungere all'elenco combinato.

È possibile combinare gruppi di destinatari personalizzati, elenchi di clienti, gruppi di destinatari di prodotti, gruppi di destinatari simili ed elenchi di remarketing. Non è possibile includere altri elenchi combinati o gruppi di destinatari sul mercato in un elenco combinato.

Puoi creare un massimo di 1.000 elenchi combinati per account pubblicitario e fino a 5.000 per cliente. La regola di combinazione di ogni elenco può includere fino a 100 set di condizioni logiche e ogni set può contenere fino a 100 ID gruppo di destinatari.

Con alcune restrizioni descritte di seguito, è possibile combinare i gruppi di destinatari usando questi operatori logici:

  • OPPURE: includerà i clienti che si trovano in uno di questi elenchi di destinatari.
  • AND: includerà solo i clienti che si trovano in ognuno di questi elenchi di destinatari.
  • NOT: escluderà i clienti che si trovano in uno di questi elenchi di destinatari.

Un set di condizioni logiche fa riferimento a un gruppo di ID gruppo di destinatari qualificato da OR, AND o NOT. Nell'API bulk ogni set è delimitato da una e commerciale ('&').

Di seguito sono riportati ad esempio 10 set per una regola di combinazione, ognuno con un ID gruppo di destinatari: NOT(1)&AND(2)&OR(3)&NOT(4)&AND(5)&OR(6)&NOT(7)&AND(8)&OR(9)&NOT(10)

Ecco un esempio di 10 set per una regola di combinazione, ognuno con due ID gruppo di destinatari: NOT(1.101)&AND(2.102)&OR(3.103)&NOT(4.104)&AND(5.105))&OR(6.106)&NOT(7.107)&AND(8.108)&OR(9.109)&NOT(10,110)

La valutazione dell'espressione logica determina chi verrà aggiunto all'elenco combinato. Più combinazioni vengono sempre combinate con una funzione AND. Ciò significa che un cliente deve soddisfare tutti i criteri di ogni combinazione per poter essere visualizzato in questo elenco di gruppi di destinatari della combinazione personalizzata. Si supponga, ad esempio, che la regola di combinazione sia impostata su NOT(123.234)&NOT(345.456)&AND(567.678)&OR(789.890)&OR(987,876). L'elenco combinato includerà i clienti che a) si trovano nel pubblico 567 e 678 e b) si trovano nel pubblico 789 o 890 e c) si trovano nel pubblico 987 o 876, a meno che d) il cliente sia tra i destinatari 123, 234, 345 o 456.

Un elenco combinato deve includere almeno un gruppo di destinatari che usa gli operatori OR o AND. Un elenco combinato non può usare solo l'operatore NOT. In questo caso è consigliabile usare invece le esclusioni di gruppi di destinatari.

I gruppi di destinatari personalizzati e gli elenchi di clienti non possono essere combinati con altri tipi di destinatari.

Gruppi di destinatari simili non possono essere combinati tramite gli operatori AND o NOT. Gruppi di destinatari simili possono essere usati solo in una singola condizione OR. In altre parole, può essere presente un solo set di gruppi di destinatari che contiene gruppi di destinatari simili e tale set deve usare l'operatore OR.

Sono consentiti gruppi di destinatari duplicati, anche se lo stesso ID gruppo di destinatari non può essere combinato tramite l'operatore AND e NOT.

Se si crea un nuovo gruppo di destinatari insieme a questo elenco combinato nello stesso caricamento bulk, la regola di combinazione può includere un identificatore negativo uguale al campo Id degli altri nuovi destinatari. Ad esempio, se si sta creando un nuovo elenco di remarketing e si vuole includerlo nell'elenco combinato, è possibile impostare il valore Id dell'elenco di remarketing su -1. Nello stesso caricamento bulk è possibile fare riferimento al nuovo elenco di remarketing usando -1 nella regola di combinazione, ad esempio NOT(123.234)&AND(345.456)&OR(-1,678). Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.

Se si crea un nuovo gruppo di destinatari insieme a questo elenco combinato nello stesso caricamento bulk, la regola di combinazione può includere una chiave di riferimento negativa al campo ID negativo degli altri nuovi destinatari. È anche possibile usare una chiave di riferimento logica per il campo Audience (nome) degli altri nuovi destinatari.

  • Come esempio di uso di una chiave di riferimento negativa, nello stesso caricamento bulk è incluso un nuovo elenco remarketing in cui l'ID è impostato su -1. Fare quindi riferimento al nuovo elenco di remarketing usando -1 nella regola di combinazione, ad esempio NOT(123,234)&AND(345,456)&OR(-1,678).
  • Come esempio di uso di una chiave di riferimento logica, nello stesso caricamento in blocco è incluso un nuovo elenco di remarketing in cui il nome del gruppo di destinatari è impostato su My New Audience. Fare quindi riferimento al nuovo elenco di remarketing usando "Il mio pubblico" (racchiuso tra virgolette singole) nella regola di combinazione, ad esempio NOT(123.234)&AND(345.456)&OR('My New Audience',678)).

Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.

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

Descrizione

Descrizione dell'elenco combinato. Usare una descrizione per ricordare il gruppo di destinatari di questo elenco combinato.

La descrizione può contenere un massimo di 1.024 caratteri.

Aggiungere: Opzionale
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 dell'elenco combinato.

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 dell'account o del cliente. Se l'ambito è impostato su Account, questo è l'ID account e in caso contrario è l'ID cliente.

Aggiungere: Opzionale
Aggiornamento: Sola lettura. Non è possibile modificare l'ID padre.
Elimina: Sola lettura

Ambito

L'ambito definisce gli account che possono usare questo elenco combinato. Se l'ambito è impostato su Account, l'elenco combinato può essere associato solo alle campagne e ai gruppi di annunci all'interno di un account specificato (ID padre). Se l'ambito è impostato su Cliente, l'elenco combinato può essere associato a qualsiasi campagna e gruppo di annunci in tutti gli account del cliente.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura. Non è possibile modificare l'ambito.
Elimina: Sola lettura

Stato

Stato dell'elenco combinato.

I valori possibili sono Attivo o Eliminato.

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

Tipi di campagna supportati

Elenco delimitato da punti e virgola dei tipi di campagna che supportano questo elenco combinato.

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