Enregistrement de liste combiné - En bloc

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

Une liste combinée est une audience créée à partir d’une combinaison de plusieurs audiences existantes.

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

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Combination Rule
Format Version,,,,,,6.0,,,,,,
Combined List,Active,-10,,ClientIdGoesHere,,,New combined list description,Customer,New Combined List,NOT(123IdGoesHere,234IdGoesHere)&AND(345IdGoesHere,456IdGoesHere)&OR(567IdGoesHere)

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

    // Map properties in the Bulk file to the 
    // CombinedList object of the Campaign Management service.
    CombinedList = new CombinedList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Combined List",
        // 'Id' column header in the Bulk file
        Id = combinedListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Combined List " + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Combination Rule' column header in the Bulk file
        CombinationRules = new[]
        {
            // Each rule is delimited by a semicolon (;) in the Bulk file
            new CombinationRule
            {
                AudienceIds = new [] { 123, 234 },
                Operator = LogicalOperator.And
            },
            new CombinationRule
            {
                AudienceIds = new [] { 345, 456 },
                Operator = LogicalOperator.And
            },
        },
        // '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
};

uploadEntities.Add(bulkCombinedList);

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 combinée , 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
• Règle de combinaison
• Description
• Id
• Heure de modification
• Parent Id
• Scope
• État
• Types de campagnes pris en charge

Audience

Nom de la liste combinée.

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 combinée, la règle ou l’identificateur de balise.

Cette propriété est vide si la balise de suivi des conversions associée à la liste combinée a un status non vérifié ou inactif, car la liste combinée 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

Règle de combinaison

Une règle de combinaison inclut des conditions utilisées pour déterminer qui doit ajouter à votre liste combinée.

Vous pouvez combiner des audiences personnalisées, des listes de clients, des audiences de produits, des audiences similaires et des listes de remarketing. Vous ne pouvez pas inclure d’autres listes combinées ou audiences sur le marché dans une liste combinée.

Vous pouvez créer un maximum de 1 000 listes combinées par compte publicitaire et jusqu’à 5 000 par client. La règle de combinaison de chaque liste peut inclure jusqu’à 100 ensembles de conditions logiques, et chaque ensemble peut contenir jusqu’à 100 ID d’audience.

Avec certaines restrictions décrites ci-dessous, vous pouvez combiner des audiences à l’aide de ces opérateurs logiques :

• OU : Cela inclut les clients qui figurent dans l’une de ces listes d’audience.
• ET : cela inclut uniquement les clients qui figurent dans chacune de ces listes d’audiences.
• NOT : cela exclut les clients qui figurent dans l’une de ces listes d’audiences.

Un jeu de conditions logiques fait référence à un groupe d’ID d’audience qualifiés par OR, AND ou NOT. Dans l’API en bloc, chaque jeu est délimité par une esperluette (« & »).

Par exemple, voici 10 ensembles pour une règle de combinaison, chacun avec un ID d’audience : NOT(1)&AND(2)&OR(3)&NOT(4)&AND(5)&OR(6)&NOT(7)&AND(8)&OR(9)&NOT(10)

Voici un exemple de 10 ensembles pour une règle de combinaison, chacune avec deux ID d’audience : NOT(1,101)&AND(2,102)&OR(3,103)&NOT(4,104)&AND(5,105))&OR(6,106)&NOT(7,107)&AND(8,108)&OR(9,109)&NOT(10,110)

L’évaluation de l’expression logique détermine qui sera ajouté à la liste combinée. Plusieurs combinaisons sont toujours combinées avec une fonction AND. Cela signifie qu’un client doit répondre à tous les critères de chaque combinaison afin d’apparaître dans cette liste d’audiences de combinaison personnalisée. Par exemple, supposons que la règle de combinaison est définie sur NOT(123,234)&NOT(345,456)&AND(567,678)&OR(789,890)&OR(987,876). La liste combinée inclut les clients qui a) sont dans les deux audiences 567 et 678, et b) sont dans l’audience 789 ou 890, et c) sont dans l’une ou l’autre audience 987 ou 876, sauf si d) le client est dans l’audience 123, 234, 345 ou 456.

Une liste combinée doit inclure au moins un public utilisant les opérateurs OR ou AND. Une liste combinée ne peut pas utiliser uniquement l’opérateur NOT. Dans ce cas, vous devez utiliser des exclusions d’audience à la place.

Les audiences personnalisées et les listes de clients ne peuvent pas être combinées avec d’autres types d’audience.

Des audiences similaires ne peuvent pas être combinées via les opérateurs AND ou NOT. Des audiences similaires ne peuvent être utilisées que dans une seule condition OR. En d’autres termes, il ne peut y avoir qu’un seul jeu d’audiences contenant des audiences similaires, et ce jeu doit utiliser l’opérateur OR.

Les audiences en double sont autorisées, bien que le même ID d’audience ne puisse pas être combiné via l’opérateur AND et NOT.

Si vous créez une audience avec cette liste combinée dans le même chargement en bloc, la règle de combinaison peut inclure un identificateur négatif égal au champ Id de l’autre nouvelle audience. Par exemple, si vous créez une liste de remarketing et que vous souhaitez également l’inclure dans la liste combinée, vous pouvez définir la valeur ID de la liste de remarketing sur -1. Dans le même chargement en bloc, vous pouvez faire référence à la nouvelle liste de remarketing en utilisant -1 dans la règle de combinaison, par exemple , NOT(123,234)&AND(345,456)&OR(-1,678). Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.

Si vous créez une audience avec cette liste combinée dans le même chargement en bloc, la règle de combinaison peut inclure une clé de référence négative au champ Id négatif de l’autre nouvelle audience. Vous pouvez également utiliser une clé de référence logique pour le champ Audience (nom) de l’autre nouvelle audience.

• À titre d’exemple d’utilisation d’une clé de référence négative, dans le même chargement en bloc, incluez une nouvelle liste de remarketing où son ID est défini sur -1. Reportez-vous ensuite à la nouvelle liste de remarketing en utilisant -1 dans la règle de combinaison, par exemple NOT(123,234)&AND(345,456)&OR(-1,678).
• À titre d’exemple d’utilisation d’une clé de référence logique, dans le même chargement en bloc, incluez une nouvelle liste de remarketing où son nom d’audience est défini sur Ma nouvelle audience. Reportez-vous ensuite à la nouvelle liste de remarketing à l’aide de « Mon audience » (entourée de guillemets simples) dans la règle de combinaison, par exemple , NOT(123,234)&AND(345,456)&OR('My New Audience',678).

Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.

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

Description

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

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 combinée.

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

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

Portée

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

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