Partager via


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

Définit un mot clé négatif affecté à une campagne qui peut être chargé et téléchargé dans un fichier en bloc.

Dans le schéma en bloc, chacun des mots clés négatifs associés à une campagne est représenté individuellement par sa propre ligne. Par exemple, si une campagne a deux mots clés négatifs, ils sont représentés par deux enregistrements de mot clé négatif de campagne dans le fichier en bloc avec État défini sur Actif.

Remarque

Le mot clé Campaign Negative peut être ajouté et supprimé, mais ne peut pas être mis à jour.

Vous pouvez télécharger tous les enregistrements de mot clé négatif campaign dans le compte en incluant la valeur DownloadEntity de CampaignNegativeKeywords 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 campagne négative mot clé si une valeur d’ID parent valide est fournie.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Campaign Negative Keyword,Active,,-112,,,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 BulkCampaignNegativeKeyword , au lieu d’appeler directement les opérations de service et d’écrire du code personnalisé pour analyser chaque champ du fichier en bloc.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignNegativeKeyword
var bulkCampaignNegativeKeyword = new BulkCampaignNegativeKeyword
{
    // 'Parent Id' column header in the Bulk file
    CampaignId = campaignIdKey,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // '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"
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignNegativeKeyword);

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

Campagne

Nom de la campagne qui contient le mot clé négatif.

Ajouter: Lecture seule et Obligatoire
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

Remarque

Pour ajouter et supprimer, vous devez spécifier le champ Id parent ou Campagne .

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 campagne qui contient le mot clé négatif.

Ce champ en bloc est mappé au champ Id de l’enregistrement de campagne .

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur de campagne existant ou un identificateur négatif égal au champ Id de l’enregistrement de campagne parent. Cette option est recommandée si vous ajoutez de nouveaux mots clés négatifs à une nouvelle campagne 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

Remarque

Pour ajouter et supprimer, vous devez spécifier le champ Id parent ou Campagne .

Statut

Représente l’association status entre la campagne et la mot clé négative.

Si le mot clé négatif est associé à la campagne, 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é. Pour supprimer un mot clé négatif spécifique, vous devez charger l’État, l’ID et l’ID parent. Pour supprimer tous les mots clés négatifs pour la campagne, vous devez uniquement charger l’état et l’ID parent dans un seul enregistrement. Vous pouvez ensuite ajouter éventuellement de nouveaux enregistrements mot clé négatifs pour remplacer le jeu supprimé.