Partager via

Enregistrement d’audience personnalisé - En bloc

  • Article

Définit une audience personnalisée qui peut être téléchargée et chargée dans un fichier en bloc.

Remarque

Seule la mise à jour des champs Audience (nom de l’audience) et Description est prise en charge pour le chargement. Vous pouvez supprimer mais ne pouvez pas ajouter une audience personnalisée à l’aide de l’API Bing Ads. Cela dit, vous pouvez ajouter et supprimer des associations et des exclusions d’audience personnalisées.

Une audience personnalisée est un type de liste de remarketing qui est généré à l’aide de vos propres données client pour créer des segments d’utilisateurs plus riches. Vous pouvez utiliser des audiences personnalisées conjointement avec vos listes de remarketing, généralement par le biais de votre fournisseur de gestion des données (DMP). Lorsque votre DMP se connecte à notre fonctionnalité d’audience personnalisée, vous pouvez importer vos audiences personnalisées dans Microsoft Advertising pour le remarketing de recherche. Vous pouvez utiliser des audiences personnalisées séparément du remarketing, sans aucun suivi de suivi des conversions.

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 personnalisée dans le compte en incluant la valeur DownloadEntity de CustomAudiences 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.

L’exemple CSV en bloc suivant met à jour la description d’une audience personnalisée. Remarque : Pour une audience personnalisée, la durée d’appartenance n’est pas définie dans l’application web Microsoft Advertising, et Microsoft Advertising s’en remet aux paramètres de votre fournisseur d’audience personnalisé.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
Custom Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,Updated Custom Audience Description,30,Account,Custom 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 charger et télécharger l’objet BulkCustomAudience , 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.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCustomAudience
var bulkCustomAudience = new BulkCustomAudience
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // CustomAudience object of the Campaign Management service.
    CustomAudience = new CustomAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "Updated Custom Audience Description",
        // 'Id' column header in the Bulk file
        Id = customAudienceIdKey,
        // 'Audience' column header in the Bulk file
        Name = null,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = null,
        // '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(bulkCustomAudience);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Pour un enregistrement Audience personnalisée , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

Audience

Nom de l’audience personnalisée.

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

Ajouter: Non pris en charge
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: En lecture seule

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.

L’audience doit avoir au moins 300 personnes avant que Microsoft Advertising ne l’utilise pour les optimisations.

Ajouter: Non pris en charge
Mettre à jour: En lecture seule
Supprimer: En lecture seule

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.

L’audience doit avoir au moins 300 personnes avant que Microsoft Advertising ne l’utilise pour les optimisations.

Cette propriété sera vide pendant jusqu’à 24 heures pendant la génération de l’audience, par exemple si vous avez importé de nouvelles audiences personnalisées à partir de DMP, la génération de l’audience prend 24 heures et, entre-temps, cette propriété sera vide.

Ajouter: Non pris en charge
Mettre à jour: En lecture seule
Supprimer: En lecture seule

ID client

Permet d’associer des enregistrements du fichier de chargement en bloc aux enregistrements du fichier de résultats. La valeur de ce champ n’est pas utilisée ou stockée par le serveur ; il est simplement copié de l’enregistrement chargé vers l’enregistrement de résultat correspondant. Il peut s’agir d’une chaîne valide d’une longueur maximale de 100.

Ajouter: Non pris en charge
Mettre à jour: Optionnel
Supprimer: En lecture seule

Description

Description de l’audience personnalisée. Utilisez une description pour vous aider à vous souvenir de l’audience que vous ciblez avec cette audience personnalisée.

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

Ajouter: Non pris en charge
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

ID

Identificateur généré par le système de l’audience personnalisée.

Ajouter: Non pris en charge
Mettre à jour: Obligatoire
Supprimer: Lecture seule et Obligatoire

Durée de l’appartenance

La durée d’appartenance détermine à quel moment Microsoft Advertising doit rechercher les actions qui correspondent à votre définition d’audience personnalisée afin d’ajouter des personnes à votre liste. Pour un public personnalisé, la durée d’appartenance n’est pas définie dans l’application web Microsoft Advertising, et Microsoft Advertising s’en remet aux paramètres de votre fournisseur d’audience personnalisé.

Lorsque vous demandez l’audience personnalisée via l’API Bing Ads, la durée d’appartenance retournée est null.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Supprimer: En lecture seule

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: En lecture seule
Supprimer: En lecture seule

Parent Id

Identificateur Microsoft Advertising du client qui contient l’audience personnalisée.

Ajouter: Non pris en charge
Mettre à jour: Obligatoire
Supprimer: En lecture seule

Portée

L’étendue définit les comptes qui peuvent utiliser cette audience personnalisée. Pour une audience personnalisée, la seule étendue prise en charge est Customer, et l’audience personnalisée peut être associée à des campagnes et des groupes d’annonces sur tous les comptes du client.

Ajouter: Non pris en charge
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Statut

L’audience personnalisée status.

Les valeurs possibles sont Active ou Deleted.

Ajouter: Non pris en charge
Mettre à jour: En lecture seule
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.

Types de campagnes pris en charge

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

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: En lecture seule
Supprimer: En lecture seule