Enregistrement d’association d’audience de produit négatif du groupe d’annonces - En bloc
Définit une association d’audience de produit négative de groupe d’annonces qui peut être chargée et télé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 cibles d’audience ne peuvent pas être définies au niveau de la campagne et du groupe d’annonces. Si vous définissez des critères d’audience au niveau de la campagne biddable, vous ne pouvez pas définir de critères d’audience au niveau du groupe d’annonces biddables. Les exclusions d’audience peuvent être définies au niveau de la campagne et du groupe d’annonces. Microsoft Advertising applique une union d’exclusions au niveau de la campagne et du groupe d’annonces.
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’association d’audience de produit négatif du groupe d’annonces dans le compte en incluant la valeur DownloadEntityd’AdGroupNegativeProductAudienceAssociations 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 association d’audience de produit négative de groupe d’annonces si une valeur d’ID parent valide est fournie.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Ad Group Negative Product Audience Association,Paused,,-1111,,,ClientIdGoesHere,,,,ProductAudienceIdHere,My Product 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 BulkAdGroupNegativeProductAudienceAssociation , 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 BulkAdGroupNegativeProductAudienceAssociation
var bulkAdGroupNegativeProductAudienceAssociation = new BulkAdGroupNegativeProductAudienceAssociation
{
// 'Ad Group' column header in the Bulk file
AdGroupName = null,
// Map properties in the Bulk file to the
// NegativeAdGroupCriterion object of the Campaign Management service.
NegativeAdGroupCriterion = new NegativeAdGroupCriterion
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
Criterion = new AudienceCriterion
{
// 'Audience Id' column header in the Bulk file
AudienceId = productAudienceIdKey,
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Paused
},
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Audience' column header in the Bulk file
AudienceName = null,
};
uploadEntities.Add(bulkAdGroupNegativeProductAudienceAssociation);
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 d’association d’audience de produit négative de groupe d’annonces, les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.
Groupe d’annonces
Nom du groupe d’annonces associé à l’audience du produit.
Ajouter: Lecture seule et Obligatoire
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire
Remarque
Pour ajouter, mettre à jour et supprimer, vous devez spécifier le champ Id parent ou Groupe d’annonces .
Audience
Nom de l’audience du produit.
Ce champ en bloc est mappé au champ Audience de l’enregistrement Audience du produit .
Ajouter: En lecture seule et Obligatoire pour certains cas d’usage. Vous devez spécifier le champ Audience ou Id d’audience . Si vous ajoutez de nouvelles associations d’audiences négatives de produit de groupe d’annonces avec de nouvelles audiences de produits dans le même fichier en bloc, et si vous ne définissez pas le champ Id d’audience, ce champ Audience doit être défini comme une clé logique à la même valeur que le champ Audience de l’enregistrement Audience du produit . Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Mettre à jour: En lecture seule
Supprimer: En lecture seule
ID d’audience
Identificateur Microsoft Advertising de l’audience de produit associée au groupe d’annonces.
Ce champ en bloc est mappé au champ Id de l’enregistrement Audience produit .
Ajouter: En lecture seule et Obligatoire pour certains cas d’usage. Vous devez spécifier le champ Audience ou Id d’audience . Si vous définissez le champ Id d’audience , vous devez spécifier un identificateur d’audience de produit existant ou un identificateur négatif égal au champ Id de l’enregistrement d’audience de produit parent. Si le champ Id d’audience n’est pas défini, vous devez définir le champ Audience en tant que clé logique sur la même valeur que le champ Audience de l’enregistrement Audience du produit . L’une de ces options est recommandée si vous ajoutez de nouvelles associations d’audiences de produits négatifs de groupe d’annonces avec de nouvelles audiences de produits dans le même fichier en bloc. Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Mettre à jour: En lecture seule
Supprimer: En lecture seule
Campagne
Nom de la campagne qui contient le groupe d’annonces.
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
ID
Identificateur généré par le système pour l’association entre un groupe d’annonces et une audience de produit.
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 groupe d’annonces associé à l’audience du produit.
Ce champ en bloc est mappé au champ Id de l’enregistrement groupe d’annonces .
Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur de groupe d’annonces existant ou un identificateur négatif égal au champ Id de l’enregistrement de groupe d’annonces parent. Cela est recommandé si vous associez des audiences de produits à un nouveau groupe d’annonces dans le même fichier en bloc. Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire
Remarque
Pour ajouter, mettre à jour et supprimer, vous devez spécifier le champ Id parent ou Groupe d’annonces .
Statut
L’association status.
Les valeurs possibles sont Active ou Deleted.
Ajouter: Optionnel. La valeur de status par défaut est Active.
Mettre à jour: Optionnel
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.