Enregistrement de liste de remarketing basé sur l’impression - En bloc

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

Vous pouvez télécharger tous les enregistrements de liste de remarketing basé sur l’impression dans le compte en incluant la valeur DownloadEntityd’ImpressionBasedRemarketingLists 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 basée sur l’impression.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Impression Campaign Id,Impression Ad Group Id,Entity Type
Format Version,,,,,,6.0,,,,,,
Impression Based Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name,CampaignIdHere,AdGroupIdHere,AdGroup
Impression Based Remarketing List,Active,-11,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name1,CampaignIdHere,,Campaign

Si vous utilisez les 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 BulkImpressionBasedRemarketingList , 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 BulkImpressionBasedRemarketingList
var bulkImpressionBasedRemarketingList = new BulkImpressionBasedRemarketingList
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ImpressionBasedRemarketingList object of the Campaign Management service.
    ImpressionBasedRemarketingList = new ImpressionBasedRemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Impression Based Remarketing List",
        // 'Id' column header in the Bulk file
        Id = impressionBasedRemarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Impression Based Remarketing List" + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Impression Ad Group Id' column header in the Bulk file
        AdGroupId = AdGroupIdHere,
        // 'Impression Campaign Id' column header in the Bulk file
        CampaignId = CampaignIdHere,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'Entity Type' column header in the Bulk file
        EntityType = ImpressionBasedEntityType.AdGroup
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkImpressionBasedRemarketingList);

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 liste de remarketing basé sur l’impression , 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
• Type d’entité
• Id
• ID de groupe d’annonces d’impression
• ID de campagne d’impression
• Durée de l’appartenance
• Heure de modification
• Parent Id
• Scope
• État
• Types de campagnes pris en charge

Audience

Nom de la liste de remarketing basée sur l’impression.

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, la règle ou l’identificateur d’étiquette de liste de remarketing basée sur l’impression.

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

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

Type d’entité

Ce type d’entité est basé sur la façon dont les utilisateurs ont consulté une publicité. Vous devez indiquer le type d’entité lorsque vous créez une liste de remarketing basée sur l’impression. Les valeurs possibles sont AdGroup ou Campaign.

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

ID

Identificateur généré par le système de la liste de remarketing basée sur l’impression.

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

ID de groupe d’annonces d’impression

AdGroupId utilisé pour créer la liste de remarketing basée sur l’impression.

Ajouter: Si le type d’entité est AdGroup, il s’agit de Obligatoire. Si Le type d’entité est Campaign, cette valeur est vide.
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

ID de campagne d’impression

CampaignId utilisé pour créer la liste de remarketing basée sur l’impression.

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

Durée de l’appartenance

Lorsque vous créez une liste de remarketing basée sur l’impression, vous pouvez spécifier dans quelle mesure Microsoft Advertising doit rechercher des actions qui correspondent à votre définition de liste de remarketing basée sur l’impression afin d’ajouter des personnes à votre liste.

La durée minimale est de 1 jour et la durée maximale autorisée est de 30 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é).

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

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 basée sur l’impression 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 basée sur l’impression.

Modèle de règle PageVisitors

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

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 basée sur l’impression 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 basée sur l’impression 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 basée sur l’impression.

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 basée sur l’impression. 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 sera ajouté à votre liste de remarketing basée sur l’impression 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 basée sur l’impression.

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 basée sur l’impression. 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 sera ajouté à votre liste de remarketing basée sur l’impression 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 basée sur l’impression.

Portée

L’étendue définit les comptes qui peuvent utiliser cette liste de remarketing basée sur l’impression. Si l’étendue est définie sur Compte, la liste de remarketing basée sur l’impression 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 basée sur l’impression 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

État

État de liste de remarketing basé sur l’impression.

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 basée sur l’impression.

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