Schéma de fichier en bloc

Le schéma en bloc définit le contenu du fichier à télécharger ou charger avec l’API en bloc. Pour le téléchargement et le chargement, le service en bloc prend en charge les types de fichiers et les schémas correspondants dans l’ensemble de valeurs DownloadEntity .

Pour plus d’informations sur l’utilisation du service en bloc pour gérer vos campagnes, consultez Téléchargement et chargement en bloc. Pour plus d’informations sur la compréhension du contenu du fichier de données, consultez les sections ci-dessous.

• Schéma de fichier
• Format Versions
• Types d’enregistrements
• Hiérarchie de types
• Clés de référence
• Identificateurs de client
• Erreurs

Schéma de fichier

Vous pouvez choisir de télécharger un ensemble d’enregistrements (lignes) et de champs (colonnes) délimités par des virgules ou par onglets. Le premier en-tête de colonne est nommé Type. Le reste des noms de colonnes sont mappés aux propriétés dans ou associées au type d’enregistrement correspondant.

Format Versions

La version au format en bloc est distincte de la version de l’API Bing Ads. La version de format permet un chemin de mise à niveau flexible pour adopter les dernières fonctionnalités prises en charge sans interrompre votre application. Il est recommandé de toujours effectuer une mise à niveau vers la dernière version du format. Actuellement, la seule version de format prise en charge est 6.0.

Pour spécifier la version du format de fichier à l’aide du téléchargement en bloc, définissez FormatVersion sur 6.0 dans la requête DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds .

Pour spécifier la version à l’aide du chargement en bloc, définissez le champ Nom de l’enregistrement format version sur 6.0.

Types d’enregistrements

Les enregistrements disponibles pour le chargement et le téléchargement à l’aide du format version 6.0 sont détaillés dans le tableau ci-dessous.

Hiérarchie de types

Le fichier de téléchargement inclut toujours un enregistrement pour les types d’enregistrements Format Version et Compte . Pour le chargement, la version de format est requise et doit précéder tous les autres types d’enregistrements dans le fichier en bloc.

• Si une entité parente est créée dans le même fichier, elle doit précéder tous les enregistrements enfants dépendants dans le fichier en bloc. Par exemple, comme illustré dans le diagramme ci-dessous, lors de l’association d’une extension d’annonce de lien de site à une campagne, l’enregistrement Campaign Sitelink Ad Extension doit être inclus dans le fichier après les enregistrements Campaign et Sitelink Ad Extension . Les champs Id et Id parent de l’enregistrement d’extension d’annonce de lien de site de campagne doivent être définis sur l’identificateur des enregistrements Extension d’annonce sitelink et Campagne , respectivement. Si les enregistrements Sitelink Ad Extension et Campaign sont également nouveaux et n’ont pas encore d’identificateurs Microsoft Advertising attribués, vous devez utiliser des clés de référence.

  

• Il n’est pas nécessaire d’inclure l’enregistrement d’une entité parente à laquelle un identificateur Microsoft Advertising valide a déjà été attribué.

• La réussite partielle est prise en charge lors de l’ajout, de la mise à jour et de la suppression d’enregistrements de fichiers en bloc. Par exemple, si vous essayez d’ajouter trois campagnes et que seules deux sont correctement spécifiées dans le fichier, deux sont ajoutées. Le fichier de résultats inclut les détails des enregistrements de campagne réussis, d’un enregistrement de campagne tentée et d’un enregistrement d’erreur de campagne .

• Si le nouvel identificateur de campagne n’est pas encore connu, par exemple lors de l’ajout d’une campagne, d’un groupe d’annonces, d’une annonce textuelle et d’un mot clé dans le même fichier, spécifiez le nom de la campagne comme clé de référence logique pour tous les enregistrements enfants. Il n’est pas nécessaire de spécifier un parent existant dans le chargement.

• Les mises à jour partielles sont prises en charge pour les enregistrements en bloc, y compris les mots clés négatifs, les sites négatifs et les critères cibles. Par exemple, vous pouvez mettre à jour l’enchère d’un seul critère d’emplacement, et vous n’avez pas besoin de télécharger et de charger l’ensemble des critères cibles pour la campagne ou le groupe d’annonces.

• Lors de la mise à jour d’un enregistrement, le champ Id de l’enregistrement mis à jour est requis. L’ID parent ou les clés de référence de l’enregistrement parent sont également nécessaires.

• Lors de la mise à jour du nom de la campagne ou du groupe d’annonces, il est facultatif de spécifier le nouveau nom pour les enregistrements enfants si l’ID parent correct est fourni.

• Si vous remplacez un jeu d’enregistrements par un autre jeu, vous devez spécifier les enregistrements supprimés avant le nouveau jeu. Par exemple, pour remplacer tous les mots clés Campaign Negative existants pour une campagne donnée, commencez par inclure un mot clé Campaign Negative avec l’état défini sur Supprimé et l’ID parent défini sur l’ID de campagne. Si vous ne spécifiez aucun ID , c’est-à-dire que vous n’essayez pas de supprimer un mot clé camapaign négatif spécifique, cela supprimera en fait tous les mots clés négatifs de campagne pour cette campagne. Sous l’enregistrement « delete all », vous pouvez inclure un ou plusieurs nouveaux enregistrements campaign negative keyword avec toutes les propriétés requises pour l’opération d’ajout de chargement.

• Si vous remplacez un enregistrement existant par un nouvel enregistrement qui a les mêmes propriétés uniques, vous devez spécifier l’enregistrement supprimé avant le nouvel enregistrement. Par exemple, pour remplacer une cible publicitaire de recherche dynamique de groupe d’annonces existante pour un groupe d’annonces donné, commencez par inclure une cible publicitaire de recherche dynamique de groupe d’annonces avec l’état défini sur Supprimé, l’ID défini sur l’ID de la cible d’annonce dynamique existante (critère de page web) et l’ID parent défini sur l’ID du groupe d’annonces. Sous l’enregistrement supprimé, vous pouvez inclure un nouvel enregistrement cible d’annonces de recherche dynamique de groupe d’annonces (probablement avec de nouvelles conditions de page web).

  Remarque

  Dans la plupart des cas, vous pouvez mettre à jour l’enregistrement existant au lieu d’envoyer des enregistrements de suppression et d’ajout distincts. Par exemple, vous pouvez mettre à jour le champ Ajustement des enchères d’un critère de sexe de campagne existant.

• Lors de la suppression d’un enregistrement, le champ Id est obligatoire. Une référence à l’entité parente, que la valeur soit un identificateur système attribué par Microsoft Advertising ou une clé de référence pour l’enregistrement parent, est également requise. Par exemple, lors de la suppression d’un groupe d’annonces, le champ Id parent de l’enregistrement Groupe d’annonces doit correspondre au champ Id dans l’enregistrement Campagne ou le champ Campagne de l’enregistrement Groupe d’annonces doit correspondre au champ Campagne dans l’enregistrement campagne . Si les deux sont fournis, le champ Id parent de l’enregistrement du groupe d’annonces (clés de référence) est ignoré.

• À quelques exceptions près, le fichier de résultat inclut uniquement les colonnes que vous avez chargées. Par exemple, si vous chargez un nouveau mot clé négatif du groupe d’annonces sans l’en-tête de colonne Id , le fichier de résultats n’inclut pas l’identificateur attribué pour le nouveau mot clé négatif. Le fichier en bloc doit contenir la colonne Id ; Toutefois, vous devez laisser l’ID vide pour chaque nouveau mot clé négatif du groupe d’annonces. Les exceptions à cette règle sont les campagnes, les groupes d’annonces, les annonces et les mots clés, auquel cas le fichier de résultats contient toutes les colonnes, quelles que soient les colonnes chargées.

Mettre à jour avec delete_value

Pour supprimer un paramètre existant, vous ne devez pas écrire une chaîne vide («  ») dans le fichier en bloc, car ces chaînes sont ignorées par le service en bloc. Utilisez la chaîne « delete_value » réservée pour supprimer ou réinitialiser la valeur d’un champ facultatif.

• Si vous utilisez la chaîne « delete_value » réservée dans un champ facultatif, le paramètre précédent est supprimé. Par exemple, si vous définissez le champ Paramètre personnalisé de l’enregistrement du groupe d’annonces sur « delete_value », tous les paramètres personnalisés précédents sont supprimés du groupe d’annonces. De même, si vous définissez le champ Modèle de suivi de l’enregistrement du groupe d’annonces sur « delete_value », le modèle de suivi précédent est supprimé du groupe d’annonces.
• Les sdk Bing Ads pour .NET, Java et Python écrivent automatiquement « delete_value » le cas échéant. Pour plus d’informations , consultez Bulk Service Manager - Mettre à jour avec delete_value.

Si vous utilisez « delete_value » dans les champs obligatoires, notez ce qui suit.

• Si vous utilisez la chaîne « delete_value » réservée à la place d’une valeur primitive requise, elle sera ignorée. Bien que le champ n’ait pas été mis à jour, la chaîne « delete_value » est transmise via le fichier de résultats de chargement. Par exemple, si vous définissez le champ Groupe d’annonces (nom du groupe d’annonces) de l’enregistrement groupe d’annonces sur « delete_value », le nom du groupe d’annonces n’est pas mis à jour.
• Si vous utilisez la chaîne « delete_value » réservée à la place d’un jeu de valeurs obligatoire, le champ est mis à jour avec la valeur par défaut et le fichier de résultats reflète cette modification. Par exemple, si vous définissez le champ Distribution réseau de l’enregistrement du groupe d’annonces sur « delete_value », la distribution réseau du groupe d’annonces est définie sur OwnedAndOperatedAndSyndicatedSearch et le fichier de résultats de chargement reflète la même chose.

Clés de référence

Lorsque vous faites référence à un enregistrement précédent dans le fichier en bloc qui n’a pas encore d’identificateur Microsoft Advertising affecté, vous pouvez utiliser une clé de référence logique ou une clé de référence négative en fonction du type d’enregistrement.

Clé de référence négative

Lorsque vous faites référence à un enregistrement précédent dans le fichier en bloc qui n’a pas encore d’identificateur Microsoft Advertising affecté, vous pouvez définir le champ Id de l’extension sur un nombre négatif de votre choix. Cet ID personnalisé est appelé clé de référence négative. Vous pouvez ensuite utiliser la clé de référence négative dans le champ Id d’un enregistrement dépendant.

Le premier exemple montre comment créer un groupe d’annonces pour une nouvelle campagne. Définissez le champ Id parent dans l’enregistrement groupe d’annonces sur la clé de référence négative de la campagne (-111). Si vous voulez ajouter des enregistrements supplémentaires dans le même fichier qui doivent avoir le groupe d’annonces comme parent (par exemple, mot clé ou extension de légende de groupe d’annonces), vous devez également définir le champ Id dans le groupe d’annonces sur une valeur négative, par exemple -1111 qui peut être référencée à partir des enregistrements enfants.

Le deuxième exemple montre comment créer une extension d’annonce de légende de campagne pour une nouvelle campagne et une nouvelle extension d’annonce de légende. L’exemple montre également comment créer une extension d’annonce de légende de groupe d’annonces pour un nouveau groupe d’annonces et une autre extension d’annonce de légende.

• Définissez le champ Id parent dans l’enregistrement d’extension d’annonce de légende campagne sur la clé de référence négative de la campagne (-111) et définissez le champ Id dans l’enregistrement Extension d’annonce de légende campagne sur la clé de référence négative de l’extension de légende (-11).
• Définissez le champ Id parent dans l’enregistrement Extension d’annonce de légende du groupe d’annonces sur la clé de référence négative du groupe d’annonces (-1111) et définissez le champ Id dans l’enregistrement Extension d’annonce de légende du groupe d’annonces sur la clé de référence négative de l’extension d’annonce de légende (-12).

Clé de référence logique

Lorsque vous faites référence à un nouvel enregistrement de campagne ou de groupe d’annonces , vous pouvez utiliser le nom de la campagne et du groupe d’annonces au lieu de définir le champ Id parent sur une clé de référence négative dans l’enregistrement enfant. Par exemple, pour ajouter un nouveau groupe d’annonces à une nouvelle campagne et ajouter un mot clé new au nouveau groupe d’annonces, définissez les champs Campagne et Groupe d’annonces dans les enregistrements enfants, comme illustré dans l’exemple suivant.

Identificateurs de client

Les identificateurs de client peuvent être utilisés pour associer des enregistrements d’entrée dans le fichier de chargement en bloc aux enregistrements de sortie dans le fichier de résultats. Par exemple, lors de l’ajout de nouveaux enregistrements, vous pouvez définir le champ ID client sur une valeur de chaîne de votre choix. Le système Microsoft Advertising n’apporte aucune modification à vos identificateurs client et les transmet au fichier de résultats de l’enregistrement correspondant.

Erreurs

Le fichier de téléchargement en bloc ou le fichier de résultats de chargement en bloc peut contenir des enregistrements où le champ Type correspondant inclut le suffixe Error. Par exemple, un type d’enregistrement Erreur d’annonce de produit représente une erreur d’annonce de produit. Les colonnes Erreur et Numéro d’erreur contiennent des détails sur l’erreur.

Les erreurs liées aux nouvelles fonctionnalités telles que les URL finales incluent des détails supplémentaires sur l’emplacement où l’erreur s’est produite dans la colonne Chemin du champ . Chaque nom de chemin de champ correspond à un élément de l’un des objets de données campaign management service . Par exemple, si le champ Modèle de suivi d’un enregistrement Campagne ne commence pas par http:// ou https://, {lpurl} ou {unscapedlpurl}, la valeur de cette valeur chemin de champ est TrackingTemplate. TrackingUrlTemplate est un élément de l’objet de données Campaign disponible avec le service de gestion de campagne.

Si le problème est lié à une erreur éditoriale, les colonnes Emplacement éditorial, Terme éditorial, Code de raison éditoriale et Pays de l’éditeur peuvent également contenir des informations supplémentaires sur l’erreur.