Enregistrement de site négatif du groupe d’annonces - En bloc
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: Non applicable. 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: Non applicable. 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: Non applicable. 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: Non applicable. 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: Non applicable. 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 .
Statut
Représente l’association status 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: Non applicable. 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 ou SyndicatedSearchOnly.
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: Non applicable. Un site négatif peut être ajouté et supprimé, mais ne peut pas être mis à jour.
Supprimer: En lecture seule