In Market Audience Record - Bulk

Artículo
11/13/2024

Define una audiencia en el mercado que se puede descargar en un archivo masivo.

Nota:

Esta característica está disponible en 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 y VN.

Nota:

No se admite la carga masiva. No se puede agregar, actualizar ni eliminar una audiencia en el mercado mediante la API de Bing Ads. Dicho esto, puede agregar y eliminar asociaciones y exclusiones de audiencias en el mercado. Bing Ads API siempre devolverá todas las audiencias activas actualmente en el mercado. El servicio no devuelve audiencias eliminadas en el mercado ni ninguna descarga diferencial para ver qué ha cambiado. Las audiencias en el mercado devueltas a través de Bing Ads API son una unión de todas las audiencias disponibles en el mercado en todos los mercados, por ejemplo, AU, CA, DE, FR, Reino Unido y EE. UU. El tamaño de la red de audiencia y el tamaño de búsqueda de audiencia son una suma de tamaños de listas en todos los mercados admitidos para una audiencia determinada en el mercado en la red correspondiente. La API de Bing Ads no proporciona detalles de los tamaños de lista por mercado. Por ejemplo, el tamaño de la audiencia "Publicidad y marketing" en el mercado en la red de búsqueda podría devolverse como 17070879 (17,1 M) a través de la API de Bing Ads. El desglose por mercado que se muestra en la aplicación web de Microsoft Advertising podría ser: 2,88 Millones en EE. UU.; 474K en AU; 13,7 millones en Reino Unido.
No debe tomar ninguna dependencia en el espacio aislado en las audiencias del mercado. Algunas audiencias en el mercado están disponibles en el espacio aislado, pero no en producción. Los valores de propiedad de la audiencia en el mercado también pueden diferir entre el espacio aislado y la producción, por ejemplo, el nombre y el tamaño de la audiencia.

Sugerencia

Para obtener información general y más información sobre las audiencias, consulte la Guía técnica de las API de audiencia .

Puede descargar todos los registros de audiencia en el mercado de la cuenta incluyendo el valor DownloadEntity de InMarketAudiences en la solicitud de servicio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Además, la solicitud de descarga debe incluir el ámbito EntityData . Para obtener más información sobre el servicio masivo, incluidos los procedimientos recomendados, consulte Descarga y carga masivas.

A continuación se muestra una descarga de ejemplo de CSV masiva para el público en el 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

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para descargar el objeto BulkInMarketAudience , en lugar de llamar a las operaciones de servicio directamente y escribir código personalizado para analizar cada campo en el archivo masivo.

// 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 un registro de audiencia en el mercado , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

Público
Tamaño de red de audiencia
Tamaño de búsqueda de audiencia
Descripción
Id
Duración de la pertenencia
Tiempo de modificación
Parent Id
Scope
Estado
Tipos de campaña admitidos