Enregistrement de mot clé négatif partagé - En bloc

Article
12/21/2023

Définit une mot clé négative qui est partagée dans une liste de mot clé négative et qui peut être téléchargée et chargée dans un fichier en bloc.

Vous pouvez télécharger tous les enregistrements de mot clé négatif partagé dans le compte en incluant la valeur DownloadEntity de SharedNegativeKeywords 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 un nouveau mot clé négatif à une liste de mot clé négative en fonction d’un ID de liste de mot clé (ID parent) valide.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Shared Negative Keyword,Active,,-19,,,ClientIdGoesHere,,shoes,Exact,

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

    // Map properties in the Bulk file to the 
    // NegativeKeyword object of the Campaign Management service.
    NegativeKeyword = new NegativeKeyword
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Exact,
        // 'Text' column header in the Bulk file
        Text = "shoes"
    },

    // 'Parent Id' column header in the Bulk file
    NegativeKeywordListId = negativeKeywordListIdKey,

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

uploadEntities.Add(bulkSharedNegativeKeyword);

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

Client Id
Id
Mot clé
Type de correspondance
Heure de modification
Parent Id
État

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: Non applicable. Un mot clé négatif peut être ajouté et supprimé, mais ne peut pas être mis à jour.
Supprimer: En lecture seule

ID

Identificateur généré par le système du mot clé négatif.

Ajouter: En lecture seule
Mettre à jour: Non applicable. Un mot clé négatif peut être ajouté et supprimé, mais ne peut pas être mis à jour.
Supprimer: Lecture seule et Obligatoire

Mot clé

Texte mot clé négatif.

Le texte peut contenir un maximum de 100 caractères.

Ajouter: Obligatoire
Mettre à jour: Non applicable. Un mot clé négatif peut être ajouté et supprimé, mais ne peut pas être mis à jour.
Supprimer: En lecture seule

Type de correspondance

Type de correspondance permettant de comparer le mot clé négatif et le terme de recherche de l’utilisateur.

Les valeurs de type de correspondance prises en charge pour un mot clé négatif sont Phrase et Exact.

Ajouter: Obligatoire
Mettre à jour: Non applicable. Un mot clé négatif peut être ajouté et supprimé, mais ne peut pas être mis à jour.
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: Non applicable. Un mot clé négatif peut être ajouté et supprimé, mais ne peut pas être mis à jour.
Supprimer: En lecture seule

Parent Id

Identificateur généré par le système de la liste de mot clé négative qui contient le mot clé négatif.

Ce champ en bloc est mappé au champ Id de l’enregistrement Liste de mots clés négatifs .

Ajouter: En lecture seule et Obligatoire. Vous devez soit spécifier un identificateur de liste négatif mot clé existant, soit un identificateur négatif égal au champ Id de l’enregistrement parent liste de mots clés négatifs. Cette option est recommandée si vous ajoutez de nouveaux mots clés négatifs à une nouvelle liste de mot clé négative 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: Non applicable. Un mot clé négatif peut être ajouté et supprimé, mais ne peut pas être mis à jour.
Supprimer: En lecture seule

Statut

Représente l’association status entre la liste de mot clé négatives et la mot clé négative.

Si le mot clé négatif est associé à la liste de mot clé négatives, la valeur de ce champ est Active.

Les valeurs possibles sont Active ou Deleted.

Ajouter: Optionnel. La valeur par défaut est Active.
Mettre à jour: Non applicable. Un mot clé négatif peut être ajouté et supprimé, mais ne peut pas être mis à jour.
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.

Partager via