In Market Audience Record - Bulk

Artigo
12/21/2023

Define uma audiência no mercado que pode ser transferida num ficheiro em massa.

Nota

Esta funcionalidade está disponível no 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, US, UY, VA, VE e VN.

Nota

O carregamento em massa não é suportado. Não pode adicionar, atualizar ou eliminar uma audiência no mercado com a API de Anúncios do Bing. Dito isto, pode adicionar e eliminar associações e exclusões de audiências no mercado. A API de Anúncios do Bing devolverá sempre todas as audiências atualmente ativas no mercado. O serviço não devolve audiências eliminadas no mercado ou qualquer transferência delta para ver o que mudou. As audiências no mercado devolvidas através da API de Anúncios do Bing são uma união de todas as audiências disponíveis no mercado em todos os mercados, por exemplo, AU, CA, DE, FR, UK e EUA. O Tamanho da Rede da Audiência e o Tamanho da Pesquisa da Audiência são uma soma de tamanhos de listas em todos os mercados suportados para uma determinada audiência no mercado na rede correspondente. A API de Anúncios do Bing não fornece detalhes sobre os tamanhos de lista por mercado. Por exemplo, o tamanho da audiência no mercado "Publicidade e Marketing" na rede de pesquisa pode ser devolvido como 17070879 (17,1 M) através da API de Anúncios do Bing. A discriminação por mercado mostrada na aplicação Web Microsoft Advertising pode ser: 2,88M nos EUA; 474 K na UA; 13,7 M no Reino Unido.
Não deve assumir quaisquer dependências nas audiências do sandbox no mercado. Algumas audiências no mercado estão disponíveis no sandbox, mas não em produção. Os valores de propriedade de audiência no mercado também podem diferir entre sandbox e produção, por exemplo, o nome e o tamanho da audiência.

Sugestão

Para obter uma descrição geral e mais informações sobre audiências, veja o Guia técnico das APIs de Audiência .

Pode transferir todos os registos da Audiência no Mercado na conta ao incluir o valor DownloadEntity de InMarketAudiences no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.

Segue-se um exemplo de transferência de CSV em massa para audiências no mercado.

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 estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para transferir o objeto BulkInMarketAudience , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.

// 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
};

Para um registo de Audiência no Mercado , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Audiência
Tamanho da Rede da Audiência
Tamanho da Pesquisa da Audiência
Descrição
ID
Duração da Associação
Hora da Modificação
ID principal
Âmbito
Estado
Tipos de Campanha Suportados