In Market Audience Record - Bulk

Articolo
08/06/2024

Definisce un gruppo di destinatari sul mercato che può essere scaricato in un file bulk.

Nota

Questa funzionalità è disponibile in AD, AR, AT, AU, AW, BD, BE, BG, BN, BO, BR, BS, CA, CH, CL, CO, CR, CY, CZ, DE, DK, DM, DO, EC, EE, ES, FI, FJ, FR, GF, GR, GT, GU, GY, HN, HR, HT, HU, ID, IE, IN, IT, KY, LI, LK, LT, LU, LV, MC, MN, MQ, MS, MT, MV, MX, MY, NC, NL, NO, NP, NZ, PA, PE, PF, PG, PH, PL, PR, PT, PY, RO, SE, SG, SI, SK, SM, SV, TH, TT, UK, UY, VA, VE e VN.

Nota

Il caricamento bulk non è supportato. Non è possibile aggiungere, aggiornare o eliminare un gruppo di destinatari sul mercato usando l'API Bing Ads. Detto questo, è possibile aggiungere ed eliminare associazioni e esclusioni di destinatari sul mercato. L'API Bing Ads restituirà sempre tutti i destinatari attualmente attivi sul mercato. Il servizio non restituisce destinatari sul mercato eliminati o download delta per vedere cosa è cambiato. Il pubblico sul mercato restituito tramite l'API Bing Ads è un'unione di tutti i destinatari disponibili sul mercato in tutti i mercati, ad esempio AU, CA, DE, FR, UK e STATI Uniti. Le dimensioni della rete dei destinatari e le dimensioni di ricerca del gruppo di destinatari sono una somma delle dimensioni degli elenchi in tutti i mercati supportati per un determinato gruppo di destinatari sul mercato nella rete corrispondente. L'API Bing Ads non fornisce dettagli sulle dimensioni degli elenchi per mercato. Ad esempio, le dimensioni del pubblico sul mercato "Pubblicità e marketing" nella rete di ricerca potrebbero essere restituite come 17070879 (17,1M) tramite l'API Bing Ads. La suddivisione per mercato mostrata nell'applicazione Web Microsoft Advertising potrebbe essere: 2,88 milioni negli Stati Uniti; 474.000 in UA; 13,7 milioni nel Regno Unito.
Non è consigliabile accettare dipendenze dai gruppi di destinatari della sandbox sul mercato. Alcuni gruppi di destinatari sul mercato sono disponibili nella sandbox, ma non nella produzione. I valori delle proprietà del pubblico sul mercato possono anche differire tra sandbox e produzione, ad esempio il nome e le dimensioni del gruppo di destinatari.

Consiglio

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

È possibile scaricare tutti i record in Market Audience nell'account includendo il valore DownloadEntity di InMarketAudiences 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.

Di seguito è riportato un esempio di download csv bulk per i destinatari sul mercato.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
In Market Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,In Market Audience Description,30,Account,In Market Audience,Search;DynamicSearchAds;Shopping;Audience

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per scaricare l'oggetto BulkInMarketAudience , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.

// Map properties in the Bulk file to the BulkInMarketAudience
var bulkInMarketAudience = new BulkInMarketAudience
{
    // Map properties in the Bulk file to the 
    // InMarketAudience object of the Campaign Management service.
    InMarketAudience = new InMarketAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "In Market Audience Description",
        // 'Id' column header in the Bulk file
        Id = InMarketAudienceIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "In Market Audience",
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // '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
};

Per un record In Market Audience , i campi dell'attributo seguenti sono disponibili nello schema di file bulk.

Gruppo di destinatari
Dimensioni della rete del gruppo di destinatari
Dimensioni della ricerca del gruppo di destinatari
Descrizione
Id
Durata appartenenza
Ora modifica
Parent Id
Ambito
Stato
Tipi di campagna supportati