Partager via


Enregistrement d’audience sur le marché - En bloc

Définit une audience sur le marché qui peut être téléchargée dans un fichier en bloc.

Remarque

Cette fonctionnalité est disponible dans 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 et VN.

Remarque

Le chargement en bloc n’est pas pris en charge. Vous ne pouvez pas ajouter, mettre à jour ou supprimer une audience sur le marché à l’aide de l’API Bing Ads. Cela dit, vous pouvez ajouter et supprimer des associations et des exclusions d’audience sur le marché. L’API Bing Ads retourne toujours toutes les audiences actuellement actives sur le marché. Le service ne retourne pas d’audiences sur le marché supprimées, ni aucun téléchargement delta pour voir ce qui a changé. Les audiences sur le marché retournées via l’API Bing Ads sont une union de toutes les audiences disponibles sur tous les marchés, par exemple AU, CA, DE, FR, Royaume-Uni et États-Unis. La taille du réseau d’audience et la taille de recherche d’audience sont une somme de tailles de listes sur tous les marchés pris en charge pour une audience sur le marché donnée dans le réseau correspondant. L’API Bing Ads ne fournit pas de détails sur les tailles de liste par marché. Par exemple, la taille de l’audience « Publicité et marketing » dans le réseau de recherche peut être retournée en tant que 17070879 (17,1 M) via l’API Bing Ads. La répartition par marché indiquée dans l’application web Microsoft Advertising peut être : 2,88 M aux États-Unis ; 474 Ko en UA ; 13,7 millions au Royaume-Uni.
Vous ne devez pas prendre de dépendances sur les audiences du bac à sable sur le marché. Certaines audiences sur le marché sont disponibles dans le bac à sable, mais pas en production. Les valeurs des propriétés d’audience sur le marché peuvent également différer entre le bac à sable et la production, par exemple, le nom et la taille de l’audience.

Conseil

Pour obtenir une vue d’ensemble et plus d’informations sur les audiences, consultez le guide technique des API d’audience .

Vous pouvez télécharger tous les enregistrements d’audience in market dans le compte en incluant la valeur DownloadEntityd’InMarketAudiences dans la demande de service DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . En outre, la demande de téléchargement doit inclure l’étendue EntityData . Pour plus d’informations sur le service en bloc, y compris les meilleures pratiques, consultez Téléchargement et chargement en bloc.

Voici un exemple de téléchargement csv en bloc pour le public sur le marché.

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 vous utilisez les Kits de développement logiciel (SDK) Bing Ads pour .NET, Java ou Python, vous pouvez gagner du temps à l’aide de BulkServiceManager pour télécharger l’objet BulkInMarketAudience , au lieu d’appeler directement les opérations de service et d’écrire du code personnalisé pour analyser chaque champ dans le fichier en bloc.

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

Pour un enregistrement d’audience sur le marché , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

Audience

Nom de l’audience sur le marché.

Le nom peut contenir un maximum de 128 caractères.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge

Taille du réseau d’audience

Nombre total de personnes qui sont des membres actifs de cette audience dans le réseau Audience. Cela vous donne une idée du nombre d’utilisateurs du réseau Audience que vous pouvez cibler.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge

Taille de la recherche d’audience

Nombre total de personnes qui sont des membres actifs de cette audience dans le réseau de recherche. Cela vous donne une idée du nombre d’utilisateurs de recherche que vous pouvez cibler.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge

Description

Description de l’audience sur le marché. Utilisez une description pour vous aider à vous souvenir de l’audience que vous ciblez avec cette audience sur le marché.

La description peut contenir un maximum de 1 024 caractères.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge

ID

Identificateur généré par le système de l’audience sur le marché.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge

Durée de l’appartenance

Lorsque vous créez une audience sur le marché dans l’application web Microsoft Advertising, vous pouvez spécifier dans quelle mesure Microsoft Advertising doit rechercher des actions qui correspondent à votre définition d’audience sur le marché afin d’ajouter des personnes à votre liste.

La durée de mimimum est de 1 jour et la durée maximale autorisée est de 180 jours.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge

Heure de modification

Date et heure de la dernière mise à jour de l’entité. La valeur est exprimée au format UTC (temps universel coordonné).

Remarque

La valeur de date et d’heure reflète la date et l’heure sur le serveur, et non le client. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge

Parent Id

Identificateur Microsoft Advertising du client qui contient l’audience sur le marché.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge

Portée

L’étendue définit les comptes qui peuvent utiliser cette audience sur le marché. Pour une audience sur le marché, la seule étendue prise en charge est Client, et l’audience sur le marché peut être associée à n’importe quelle campagne et groupe de publicités sur tous les comptes du client.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge

Statut

Le public du marché status.

Les valeurs possibles sont Active ou Deleted.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge

Types de campagnes pris en charge

Liste délimitée par des points-virgules des types de campagne qui prennent en charge cette audience sur le marché.

Les valeurs prises en charge sont Audience, DynamicSearchAds, Search et Shopping. De nouveaux types de campagne peuvent être ajoutés à l’avenir. Vous ne devez donc pas dépendre d’un ensemble fixe de valeurs.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: Non pris en charge