Partager via

Enregistrement de site négatif du groupe d’annonces - En bloc

  • Article

Définit un site négatif affecté à un groupe d’annonces qui peut être chargé et téléchargé dans un fichier en bloc.

Dans le schéma en bloc, chacun des sites négatifs associés à un groupe d’annonces est représenté individuellement par leur propre ligne. Par exemple, si vous avez deux sites négatifs, ils sont représentés par deux enregistrements site négatif de groupe d’annonces dans le fichier en bloc avec État défini sur Actif. Lors du chargement ou du téléchargement d’enregistrements pour une liste mise à jour des sites négatifs associés, l’état d’un enregistrement est défini sur Supprimé avec un champ Site web vide. Cela indique que certaines modifications ont été apportées à la liste et que les enregistrements de site négatif du groupe d’annonces qui suivent sont actifs.

Remarque

Le site négatif du groupe d’annonces peut être ajouté et supprimé, mais ne peut pas être mis à jour.

Vous pouvez télécharger tous les enregistrements de site négatif du groupe d’annonces dans le compte en incluant la valeur DownloadEntityd’AdGroupNegativeSites 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 site négatif de groupe d’annonces si une valeur d’ID parent valide est fournie.

Type,Status,Id,Parent Id,Campaign,Ad Group,Website,Client Id,Modified Time,Name
Format Version,,,,,,,,,6.0
Ad Group Negative Site,Active,,-1111,,,contoso.com,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 BulkAdGroupNegativeSite , 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 BulkAdGroupNegativeSites
var bulkAdGroupNegativeSites = new BulkAdGroupNegativeSites
{
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,

    // Map properties in the Bulk file to the 
    // AdGroupNegativeSites object of the Campaign Management service.
    AdGroupNegativeSites = new AdGroupNegativeSites
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        NegativeSites = new[]
        {
            // 'Website' column header in the Bulk file
            "contoso.com",
        }
    },
                
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

// BulkAdGroupNegativeSites does not support 'Client Id' and
// replaces all negative sites for the ad group, whereas BulkAdGroupNegativeSite
// enables you to add or delete one negative site at a time.

// Map properties in the Bulk file to the BulkAdGroupNegativeSite
var bulkAdGroupNegativeSite = new BulkAdGroupNegativeSite
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
    // 'Website' column header in the Bulk file
    Website = "contoso.com",
};

uploadEntities.Add(bulkAdGroupNegativeSite);

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 site négatif 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 qui contient le site négatif.

Ajouter: Lecture seule et Obligatoire
Mettre à jour: Sans objet. Un site 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 Groupe d’annonces .

Campagne

Nom de la campagne qui contient le groupe d’annonces et le site négatif.

Ajouter: En lecture seule
Mettre à jour: Sans objet. Un site négatif peut être ajouté et supprimé, mais ne peut pas être mis à jour.
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: Sans objet. Un site 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: Sans objet. Un site 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 du groupe d’annonces qui contient le site négatif.

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 ajoutez de nouveaux sites négatifs à 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: Sans objet. Un site 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 Groupe d’annonces .

État

Représente l’état d’association entre le groupe d’annonces et le site négatif.

Si le site négatif est associé au groupe d’annonces, 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: Sans objet. Un site 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 site négatif spécifique, vous devez charger l’état, l’ID parent et le site web. Pour supprimer tous les sites négatifs pour le groupe d’annonces, vous devez uniquement charger l’état et l’ID parent dans un seul enregistrement. Ensuite, si vous le souhaitez, vous pouvez ajouter de nouveaux enregistrements de site négatifs pour remplacer le jeu supprimé.

Site web

URL du site web où vous ne souhaitez pas que vos annonces s’affichent.

Chaque URL doit spécifier le nom de domaine, par exemple , contoso.com qui peut inclure jusqu’à trois sous-domaines et deux sous-répertoires. Le nombre de sous-domaines inclut le préfixe www . Par exemple , one.two.three.contoso.com/1/2, www.two.three.contoso.com/1/2 et one.two.contoso.co.uk/1/2 sont des URL valides, contrairement aux one.two.three.contoso.co.uk/1/2 (trop de sous-domaines) et one.two.three.contoso.com/1/2/3 (trop de sous-répertoires). Les URL de site négatives en double par campagne ou groupe d’annonces ne sont pas autorisées.

Vous pouvez uniquement exclure des sites web pour les sites web de recherche syndiqués. Le réseau du groupe d’annonces doit être défini sur OwnedAndOperatedAndSyndicatedSearch.

Les URL de site négatives spécifiées au niveau du groupe d’annonces sont utilisées à la place des URL de site négatives spécifiées au niveau de la campagne. Si vous associez des listes d’exclusion de sites web à un compte publicitaire (disponible via le service Gestion des campagnes), la liste des sites négatifs est utilisée en plus des sites négatifs de campagne ou des sites négatifs du groupe d’annonces.

Ajouter: Obligatoire
Mettre à jour: Sans objet. Un site négatif peut être ajouté et supprimé, mais ne peut pas être mis à jour.
Supprimer: En lecture seule