Enregistrement d’étiquette de groupe d’annonces - En bloc
Définit un enregistrement d’association entre un groupe d’annonces et une étiquette qui peut être chargé et téléchargé dans un fichier en bloc. Pour charger ou télécharger le groupe d’annonces ou l’étiquette, utilisez l’enregistrement Groupe d’annonces ou Étiquette .
Vous pouvez télécharger tous les enregistrements d’étiquette de groupe d’annonces dans le compte en incluant la valeur DownloadEntityd’AdGroupLabels 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 applique une étiquette à un groupe d’annonces si des valeurs ID et ID parent valides sont fournies.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Ad Group Label,,-22,-1111,,,ClientIdGoesHere,,,,,
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 BulkAdGroupLabel , 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 BulkAdGroupLabel
var bulkAdGroupLabel = new BulkAdGroupLabel
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// LabelAssociation object of the Campaign Management service.
LabelAssociation = new LabelAssociation
{
// 'Parent Id' column header in the Bulk file
EntityId = adGroupIdKey,
// 'Id' column header in the Bulk file
LabelId = labelIdKey
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkAdGroupLabel);
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’étiquette de groupe d’annonces, les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.
Remarque
Les champs Groupe d’annonces et Campagne ne sont pas retournés dans le fichier de téléchargement.
Groupe d’annonces
Nom du groupe d’annonces dans lequel cette étiquette est appliquée ou supprimée.
Ajouter: En lecture seule
Supprimer: En lecture seule
Remarque
Pour ajouter et supprimer, vous devez spécifier l’ID parent ou les deux champs Groupe d’annonces et Campagne .
Campagne
Nom de la campagne qui contient le groupe d’annonces dans lequel cette étiquette est appliquée ou supprimée.
Ajouter: En lecture seule
Supprimer: En lecture seule
Remarque
Pour ajouter et supprimer, vous devez spécifier l’ID parent ou les deux champs Groupe d’annonces et Campagne . Pour le téléchargement en bloc, les champs Groupe d’annonces et Campagne ne sont pas retournés.
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
Supprimer: En lecture seule
ID
Identificateur de l’étiquette qui est appliquée ou supprimée du groupe d’annonces.
Ce champ en bloc est mappé au champ Id de l’enregistrement Label .
Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur d’étiquette existant ou un identificateur négatif égal au champ Id de l’enregistrement Label parent. Cela est recommandé si vous appliquez de nouvelles étiquettes à des groupes 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.
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
Supprimer: En lecture seule
Parent Id
Identificateur du groupe d’annonces dans lequel cette étiquette est appliquée ou supprimée.
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 appliquez des étiquettes à 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.
Supprimer: Lecture seule et Obligatoire
Remarque
Pour ajouter et supprimer, vous devez spécifier l’ID parent ou les deux champs Groupe d’annonces et Campagne . Pour le téléchargement en bloc, les champs Groupe d’annonces et Campagne ne sont pas retournés.
Statut
Représente le status appliqué entre le groupe d’annonces et l’étiquette.
Les valeurs possibles sont Active et Deleted. Si l’étiquette est appliquée au groupe d’annonces, la valeur de ce champ est Active.
Ajouter: En lecture seule
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.