Enregistrement d’audience du produit - En bloc

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

Remarque

Les listes de remarketing dynamiques étaient auparavant appelées audiences de produits dans Microsoft Advertising. Vous verrez « Liste de remarketing dynamique » dans l’interface utilisateur Microsoft Advertising, mais pour éviter les modifications cassantes, les objets d’API sont toujours nommés « audience de produit ».

Les listes de remarketing dynamiques associent des clients à des produits spécifiques en fonction de ce qu’ils ont examiné, considéré ou déjà acheté sur votre site web. Vous pouvez utiliser des listes de remarketing dynamiques dans les campagnes de recherche et les campagnes d’audience (tout le monde n’a pas encore de campagnes d’audience).

Les listes de remarketing dynamique fonctionnent mieux avec les campagnes Shopping et les campagnes d’audience basées sur les flux, c’est-à-dire les campagnes qui tirent parti d’un ID de magasin Microsoft Merchant Center.

Importante

Veillez à modifier le script correspondant à l’ID de balise de suivi des conversions sur votre site web pour inclure les ecomm_prodid paramètres et ecomm_pagetype . Le paramètre ecomm_prodid est l’ID de produit du produit sur la page. Il est unique pour chaque élément et doit correspondre à l’attribut id ou item_group_id dans votre flux de produit. Caractères numériques et alphanumériques (y compris les traits d’union) uniquement, avec un maximum de 50 caractères. Le paramètre ecomm_pagetype identifie le type de page visité par l’utilisateur. Options valides : accueil, searchresults, catégorie, produit, panier, achat, autre.

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

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 de produit dans le compte en incluant la valeur DownloadEntity de ProductAudiences 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 ajoute une nouvelle audience de produit.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Product Audience Type,Supported Campaign Types
Format Version,,,,,,6.0,,,,,,,
Product Audience,Active,-10,ParentIdHere,ClientIdGoesHere,,,New product audience,30,Account,TagIdHere,My Product Audience,GeneralVisitors,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 BulkProductAudience , 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 BulkProductAudience
var bulkProductAudience = new BulkProductAudience
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ProductAudience object of the Campaign Management service.
    ProductAudience = new ProductAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New product audience",
        // 'Id' column header in the Bulk file
        Id = productAudienceIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "My Product Audience",
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Product Audience Type' column header in the Bulk file
        ProductAudienceType = ProductAudienceType.GeneralVisitors,
        // '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,
        // 'UET Tag Id' column header in the Bulk file
        TagId = tagIdKey
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkProductAudience);

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 de produit , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

• Audience
• Taille du réseau d’audience
• Taille de la recherche d’audience
• Client Id
• Description
• Id
• Durée de l’appartenance
• Heure de modification
• Parent Id
• Type d’audience du produit
• Scope
• État
• Types de campagnes pris en charge
• ID de balise de suivi des conversions

Audience

Nom de l’audience du produit.

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

Ajouter: Obligatoire
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: En lecture seule
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é est vide pendant 24 heures maximum pendant la génération de l’audience, par exemple si vous ajoutez ou mettez à jour la durée d’appartenance, la règle ou l’identificateur de balise de l’audience du produit.

Cette propriété est vide si la balise de suivi des conversions associée à l’audience du produit a un status non vérifié ou inactif, car l’audience du produit ne peut pas recevoir les informations client de votre site web dont elle a besoin pour créer la liste.

Ajouter: En lecture seule
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: Optionnel
Mettre à jour: Optionnel
Supprimer: En lecture seule

Description

Description de l’audience du produit. Utilisez une description pour vous aider à vous souvenir de l’audience que vous ciblez avec cette audience de produit.

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

Ajouter: Optionnel
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 du produit.

Ajouter: En lecture seule
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Durée de l’appartenance

Lorsque vous créez une audience de produit, vous pouvez spécifier dans quelle mesure Microsoft Advertising doit rechercher des actions qui correspondent à votre définition d’audience de produit 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: Optionnel
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

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

Parent Id

Identificateur généré par le système du compte ou du client. Si l’étendue est définie sur Compte, il s’agit de l’ID de compte et, sinon, il s’agit de l’ID client.

Ajouter: Optionnel
Mettre à jour: En lecture seule. Vous ne pouvez pas modifier l’ID parent.
Supprimer: En lecture seule

Type d’audience du produit

Détermine qui ajouter à votre audience de produit.

Les valeurs possibles sont GeneralVisitors, ProductSearchers, ProductViewers, ShoppingCartAbandoners et PastBuyers.

Ajouter: Obligatoire
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

Portée

L’étendue définit les comptes qui peuvent utiliser cette audience de produit. Si l’étendue est définie sur Compte, l’audience du produit ne peut être associée qu’à des campagnes et des groupes d’annonces au sein d’un compte spécifié (ID parent). Si l’étendue est définie sur Client, l’audience du produit peut être associée à des campagnes et des groupes d’annonces sur tous les comptes du client.

Ajouter: Obligatoire
Mettre à jour: En lecture seule. Vous ne pouvez pas modifier l’étendue.
Supprimer: En lecture seule

Statut

Le public du produit status.

Les valeurs possibles sont Active ou Deleted.

Ajouter: Optionnel. La valeur par défaut est Active.
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 de produit.

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

ID de balise de suivi des conversions

Identificateur Microsoft Advertising de la balise Suivi des événements universels (UET) qui est utilisée avec l’audience du produit.

Importante

Veillez à modifier le script de suivi des conversions sur votre site web pour inclure les prodid paramètres et pagetype .

window.uetq = window.uetq || [];
window.uetq.push({'prodid': 'PRODUCT_ID', 'pagetype': 'PAGE_TYPE'});

Ajouter: Obligatoire
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

Modèle de règle CustomEvents

Pour la règle CustomEvents , vous devez inclure une ou plusieurs des paires d’opérateurs d’événements conditionnels suivantes : (ActionOperator et Action), (CategoryOperator et Category), (LabelOperator et Label), (ValueOperator et Value). Si plusieurs conditions sont spécifiées, les conditions sont jointes à l’aide de l’opérateur AND logique. En d’autres termes, le visiteur n’est ajouté à votre public produit que si toutes les conditions de règle spécifiées sont remplies.

Par exemple, supposons que les événements personnalisés suivants sont définis en tant qu’expression logique dans le fichier en bloc :

CustomEvents(Category Equals video) et (Action égale la lecture) et (Label Equals trailer) et (Value Equals 5)

L’évaluation de l’expression logique détermine qui sera ajouté à l’audience du produit.

Modèle de règle PageVisitors

Pour la règle PageVisitors , vous devez inclure un ou plusieurs groupes d’éléments de règle. Avec chaque groupe d’éléments de règle, les conditions d’élément de règle pour la même page sont jointes à l’aide de l’opérateur AND logique. Ensuite, chaque résultat de la liste des groupes d’éléments de règle est joint à l’aide de l’opérateur OR logique. En d’autres termes, l’utilisateur est ajouté à votre audience de produit si toutes les conditions d’élément de règle spécifiées dans l’un des groupes d’éléments de règle sont remplies.

Par exemple, supposons que les groupes d’éléments de règle suivants sont définis en tant qu’expression logique dans le fichier en bloc :

PageVisitors((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))

L’évaluation de l’expression logique détermine lequel des exemples d’utilisateurs suivants sera ajouté à l’audience du produit.

Utilisateur	URL visitée	URL du référent	Ajouté à la liste
Utilisateur 1	A	X	Oui. Évaluation des résultats de l’expression logique avec la valeur True. ((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl Equals Z)) (False et True) ou (True) ou (False) False, True ou False True
Utilisateur 2	B	O	Non. Évaluation des résultats de l’expression logique comme False. ((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl Equals Z)) (False et True) ou (False) ou (False) False ou False ou False False
Utilisateur 3	C	Z	Oui. Évaluation des résultats de l’expression logique avec la valeur True. ((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl Equals Z)) (False et False) ou (True) ou (True) False, True ou True True

Modèle de règle PageVisitorsWhoDidNotVisitAnotherPage

Les règles de remarketing sont des conditions utilisées pour déterminer qui ajouter à votre audience de produit. Pour la règle PageVisitorsWhoDidNotVisitAnotherPage , vous devez inclure un ou plusieurs groupes d’éléments de règle pour la page visitée (IncludeRuleItemGroups), et vous devez également inclure un ou plusieurs groupes d’éléments de règles pour la page qui ne doit pas avoir été visitée (ExcludeRuleItemGroups).

Pour chaque groupe d’éléments de règle dans IncludeRuleItemGroups, les conditions d’élément de règle pour la même page sont jointes à l’aide de l’opérateur AND logique. Ensuite, chaque résultat de la liste des groupes d’éléments de règle est joint à l’aide de l’opérateur OR logique.

De même, pour chaque groupe d’éléments de règle dans ExcludeRuleItemGroups, les conditions d’élément de règle pour la même page sont jointes à l’aide de l’opérateur AND logique. Ensuite, chaque résultat de la liste des groupes d’éléments de règle est joint à l’aide de l’opérateur OR logique. Enfin, l’opérateur NOT logique est appliqué au résultat agrégé des groupes d’éléments de règle d’exclusion.

En d’autres termes, le visiteur est ajouté à votre public produit si l’une des conditions du groupe d’éléments de règle d’inclusion est remplie et qu’aucune des conditions du groupe d’éléments de règle d’exclusion n’est remplie.

Par exemple, supposons que les groupes d’éléments de règle suivants sont définis en tant qu’expression logique dans le fichier en bloc :

(((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) et non ((Url BeginsWith A) et (ReferrerUrl BeginsWith B)) ou ((Url Contains C)))

L’évaluation de l’expression logique détermine lequel des exemples d’utilisateurs suivants sera ajouté à l’audience du produit.

Utilisateur	URL visitée	URL du référent	Ajouté à la liste
Utilisateur 1	A	X	Oui. Évaluation des résultats de l’expression logique avec la valeur True. (((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) et non ((Url BeginsWith A) et (ReferrerUrl BeginsWith B)) ou ((Url Contains C))) ((Faux et Vrai) ou (Vrai) ou (Faux)) et non ((Vrai et Faux) ou (Faux)) (False, True ou False) et non (False ou False) True et non False True
Utilisateur 2	B	O	Oui. Évaluation des résultats de l’expression logique avec la valeur True. (((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) et non ((Url BeginsWith A) et (ReferrerUrl BeginsWith B)) ou ((Url Contains C))) ((Faux et Vrai) ou (Vrai) ou (Faux)) et non (Faux et faux) ou (Faux)) (False, True ou False) et non (False ou False) True et non False True
Utilisateur 3	C	Z	Non. Évaluation des résultats de l’expression logique comme False. (((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) et non ((Url BeginsWith A) et (ReferrerUrl BeginsWith B)) ou ((Url Contains C))) ((Faux et Faux) ou (Vrai) ou (Vrai)) et non ((Faux et Faux) ou (Vrai)) (False, True ou True) et non (False ou True) True et not True False

Modèle de règle PageVisitorsWhoVisitedAnotherPage

Les règles de remarketing sont des conditions utilisées pour déterminer qui ajouter à votre audience de produit. Pour la règle PageVisitorsWhoVisitedAnotherPage , vous devez inclure un ou plusieurs groupes d’éléments de règle pour la page visitée (RuleItemGroups), et vous devez également inclure un ou plusieurs groupes d’éléments de règles pour une autre page qui doit avoir été visitée (AnotherRuleItemGroups).

Pour chaque groupe d’éléments de règle dans RuleItemGroups, les conditions d’élément de règle pour la même page sont jointes à l’aide de l’opérateur AND logique. Ensuite, chaque résultat de la liste des groupes d’éléments de règle est joint à l’aide de l’opérateur OR logique.

De même, pour chaque groupe d’éléments de règle dans AnotherRuleItemGroups, les conditions d’élément de règle pour la même page sont jointes à l’aide de l’opérateur AND logique. Ensuite, chaque résultat de la liste des groupes d’éléments de règle est joint à l’aide de l’opérateur OR logique.

En d’autres termes, le visiteur est ajouté à votre public produit si l’une des conditions du groupe d’éléments de règle est remplie et si l’une des autres conditions du groupe d’éléments de règle est remplie.

Par exemple, supposons que les groupes d’éléments de règle suivants sont définis en tant qu’expression logique dans le fichier en bloc :

(((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C))))

L’évaluation de l’expression logique détermine lequel des exemples d’utilisateurs suivants sera ajouté à l’audience du produit.

Utilisateur	URL visitée	URL du référent	Ajouté à la liste
Utilisateur 1	A	X	Non. Évaluation des résultats de l’expression logique comme False. (((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))) ((Faux et Vrai) ou (Vrai) ou (Faux)) et ((Vrai et Faux) ou (Faux)) (False, True ou False) et (False ou False) True et False False
Utilisateur 2	B	O	Non. Évaluation des résultats de l’expression logique comme False. (((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))) ((Faux et Vrai) ou (Vrai) ou (Faux)) et ((Faux et Faux) ou (Faux)) (False, True ou False) et (False ou False) True et False False
Utilisateur 3	C	Z	Oui. Évaluation des résultats de l’expression logique avec la valeur True. (((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and ((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))) ((Faux et Vrai) ou (Vrai) ou (Vrai)) et ((Faux et Faux) ou (True)) (False, True ou True) et (False ou True) True et True True