Enregistrement de site négatif de campagne - En bloc
Définit un site 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 sites négatifs associés à une campagne est représenté individuellement par sa propre ligne. Par exemple, si vous avez deux sites négatifs, ils sont représentés par deux enregistrements de site négatif de campagne 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 de campagne qui suivent sont actifs.
Remarque
Le site négatif de campagne peut être ajouté et supprimé, mais ne peut pas être mis à jour.
Vous pouvez télécharger tous les enregistrements du site négatif de campagne dans le compte en incluant la valeur DownloadEntity de CampaignNegativeSites 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 campagne 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
Campaign Negative Site,Active,,-112,,,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 BulkCampaignNegativeSite , 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 BulkCampaignNegativeSites
var bulkCampaignNegativeSites = new BulkCampaignNegativeSites
{
// 'Campaign' column header in the Bulk file
CampaignName = null,
// Map properties in the Bulk file to the
// CampaignNegativeSites object of the Campaign Management service.
CampaignNegativeSites = new CampaignNegativeSites
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
NegativeSites = new[]
{
// 'Website' column header in the Bulk file
"contoso.com",
}
},
// 'Status' column header in the Bulk file
Status = Status.Active,
};
// BulkCampaignNegativeSites does not support 'Client Id' and
// replaces all negative sites for the campaign, whereas BulkCampaignNegativeSite
// enables you to add or delete one negative site at a time.
// Map properties in the Bulk file to the BulkCampaignNegativeSite
var bulkCampaignNegativeSite = new BulkCampaignNegativeSite
{
// '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",
// 'Status' column header in the Bulk file
Status = Status.Active,
// 'Website' column header in the Bulk file
Website = "contoso.com",
};
uploadEntities.Add(bulkCampaignNegativeSite);
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 campagne , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.
Campagne
Nom de la campagne 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
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 de la campagne qui contient le site 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 sites 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 site 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 campagne et le site négatif.
Si le site 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 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 la campagne, 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