Enregistrement d’étiquette - En bloc

Article
12/21/2023

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

Les étiquettes vous permettent d’organiser des campagnes, des groupes d’annonces, des publicités et des mots clés en groupes en fonction de ce qui est important pour vous. Vous pouvez ensuite filtrer et exécuter des rapports sur vos étiquettes pour obtenir les données les plus significatives pour vous.

Vous pouvez télécharger tous les enregistrements Label dans le compte en incluant la valeur DownloadEntity de Labels 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 étiquette.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Label,,-22,,,,ClientIdGoesHere,,,Label Description,Label Name,#FFFFFF

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

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    Label = new Label
    {
        // 'Color' column header in the Bulk file
        ColorCode = "#FFFFFF",
        // 'Description' column header in the Bulk file
        Description = "Label Description",
        // 'Id' column header in the Bulk file
        Id = labelIdKey,
        // 'Label' column header in the Bulk file
        Name = "Label Name " + DateTime.UtcNow
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkLabel);

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 Label , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

Color
Client Id
Description
Id
Label
Heure de modification
État

Couleur

Couleur d’étiquette sous forme de code hexadécimal.

La valeur hexadécimale doit avoir le préfixe « # ». Par exemple, vous pouvez utiliser la valeur de #FFFFFF pour une étiquette blanche.

La couleur peut être consultée dans l’application web Microsoft Advertising. Votre application peut afficher la couleur ou utiliser la valeur hexadécimale pour catégoriser un ensemble d’étiquettes.

Ajouter: Optionnel. Si vous ne spécifiez aucune couleur, la valeur est attribuée au hasard pour chaque étiquette.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Vous pouvez mettre à jour le code de couleur, mais vous ne pouvez pas le supprimer.
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 l’étiquette.

La description de l’étiquette peut comporter entre 1 et 200 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é.
Supprimer: En lecture seule

ID

Identificateur généré par le système de l’étiquette.

Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. Un identificateur négatif défini pour l’étiquette peut ensuite être référencé dans le champ Id parent des types d’enregistrements dépendants tels que l’étiquette de campagne. Cette option est recommandée si vous ajoutez une nouvelle étiquette et de nouveaux enregistrements dépendants 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

Étiquette

Nom de l’étiquette.

Le nom d’étiquette respectant la casse peut être compris entre 1 et 80 caractères et doit être unique sur toutes les étiquettes du compte.

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

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

Statut

Status de l’étiquette.

Les valeurs possibles sont Active ou Deleted.

Ajouter: Optionnel. La valeur par défaut est Active.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.

Partager via