Enregistrement de liste de remarketing - En bloc

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

Remarque

Microsoft Advertising génère automatiquement des audiences similaires pour les listes de remarketing si vous êtes un participant pilote. Vous ne pouvez pas créer ou modifier l’audience similaire pour une liste de remarketing. Cela dit, vous pouvez ajouter et supprimer des associations et des exclusions de liste de remarketing similaires. Si vous supprimez la liste de remarketing source, l’audience similaire est également supprimée. Si une audience similaire est associée à une campagne ou un groupe d’annonces, vous ne pouvez pas supprimer la liste de remarketing source. Pour plus d’informations, consultez Liste de remarketing similaire.

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 de liste de remarketing dans le compte en incluant la valeur DownloadEntity de RemarketingLists 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 liste de remarketing.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Remarketing Rule
Format Version,,,,,,6.0,,,,,,
Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New list with CustomEventsRule,30,Account,TagIdHere,Remarketing List with CustomEventsRule,CustomEvents(Action Equals play) and (Category Equals video) and (Label Equals trailer) and (Value Equals 5.00)

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 BulkRemarketingList , 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 BulkRemarketingList
var bulkRemarketingList = new BulkRemarketingList
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // RemarketingList object of the Campaign Management service.
    RemarketingList = new RemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New list with CustomEventsRule",
        // 'Id' column header in the Bulk file
        Id = remarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Remarketing List with CustomEventsRule " + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Remarketing Rule' column header in the Bulk file
        Rule = new CustomEventsRule
        {
            // The rule definition is translated to the following logical expression: 
            // CustomEvents(Category Equals video) and (Action Equals play) and (Label Equals trailer) 
            // and (Value Equals 5)
            Action = "play",
            ActionOperator = StringOperator.Equals,
            Category = "video",
            CategoryOperator = StringOperator.Equals,
            Label = "trailer",
            LabelOperator = StringOperator.Equals,
            Value = 5.00m,
            ValueOperator = NumberOperator.Equals,
        },
        // '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(bulkRemarketingList);

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 de liste de remarketing , 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
• Règle de remarketing
• Scope
• État
• Types de campagnes pris en charge
• ID de balise de suivi des conversions

Audience

Nom de la liste de remarketing.

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é sera vide pendant jusqu’à 24 heures pendant la génération de l’audience, par exemple si vous ajoutez ou mettez à jour la durée d’appartenance à la liste de remarketing, la règle ou l’identificateur de balise.

Cette propriété est vide si la balise de suivi des conversions associée à la liste de remarketing a un status non vérifié ou inactif, car la liste de remarketing 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 la liste de remarketing. Utilisez une description pour vous aider à vous souvenir de l’audience que vous ciblez avec cette liste de remarketing.

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 la liste de remarketing.

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 liste de remarketing, vous pouvez spécifier à quel moment Microsoft Advertising doit rechercher des actions qui correspondent à votre définition de liste de remarketing 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

Règle de remarketing

Un modèle de règle inclut des conditions utilisées pour déterminer qui ajouter à votre liste de remarketing.

Vous pouvez choisir l’un des quatre types de règles pour cibler différentes audiences : CustomEventsRule, PageVisitorsRule, PageVisitorsWhoDidNotVisitAnotherPageRule et PageVisitorsWhoVisitedAnotherPageRule. Pour plus d’informations sur le format de chaque règle dans le fichier en bloc, consultez les sections de remarques de modèle de règle CustomEvents, PageVisitorsWhoDidNotVisitAnotherPage et PageVisitorsWhoVisitedAnotherPage ci-dessous.

Ajouter: Obligatoire
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous souhaitez conserver l’un des éléments de règle précédents, vous devez les définir explicitement à nouveau lors de la mise à jour. Vous pouvez choisir de modifier le type de règle pendant la mise à jour.
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 liste de remarketing 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é à la liste de remarketing.

Modèle de règle PageVisitors

Pour la règle PageVisitors , vous devez inclure un ou plusieurs groupes d’éléments de règle.

Importante

Au cours de l’année civile 2021, nous avons ajouté la prise en charge de la forme normale conjonctive (CNF). Auparavant, Microsoft Advertising prenait uniquement en charge la forme normale disjonctive (DNF). La forme normale par défaut d’une règle de visiteurs de nouvelle page reste DNF. Toutefois, vous devez vous assurer que votre application peut lire et faire la distinction entre CNF et DNF. Votre application ne doit plus supposer que la règle est disjonctive.

Si la forme normale est conjonctive (CNF), les conditions d’élément de règle pour la même page sont d’abord jointes à l’aide de l’opérateur OR logique. Ensuite, chaque résultat de la liste des groupes d’éléments de règle est joint à l’aide de l’opérateur AND logique. En d’autres termes, l’utilisateur est ajouté à votre liste de remarketing si l’une des conditions d’élément de règle spécifiées dans tous les groupes d’éléments de règle est remplie.

• Règle 1 ET Règle 2
• (Règle 1 OU Règle 2) AND Rule 3
• (Règle 1 OU Règle 2) AND (Règle 3 OU Règle 4)

Si la forme normale est disjonctive (DNF), les conditions d’élément de règle pour la même page sont d’abord jointes à l’aide de l’opérateur LOGIQUE AND . 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 liste de remarketing 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.

• Règle 1 OU Règle 2
• (Règle 1 ET Règle 2) OR, règle 3
• (Règle 1 ET Règle 2) OR (Règle 3 ET Règle 4)

Pour obtenir un exemple d’évaluation DNF, 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é à la liste de remarketing.

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 liste de remarketing. 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 liste de remarketing si l’une des conditions du groupe d’éléments de règle include 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é à la liste de remarketing.

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 liste de remarketing. 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 liste de remarketing 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é à la liste de remarketing.

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

Portée

L’étendue définit les comptes qui peuvent utiliser cette liste de remarketing. Si l’étendue est définie sur Compte, la liste de remarketing 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, la liste de remarketing peut être associée à toutes les campagnes et 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

La liste de remarketing 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 liste de remarketing.

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) utilisée avec la liste de remarketing.

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