Enregistrement d’extension d’annonce de promotion de campagne - En bloc
Définit un enregistrement d’association entre une campagne et une extension d’annonce de promotion qui peut être chargé et téléchargé dans un fichier en bloc. Pour charger ou télécharger l’extension de campagne ou de promotion, utilisez l’enregistrement Campagne ou Extension d’annonce de promotion .
Remarque
Les extensions de promotion sont disponibles pour les clients dans le pilote de fonctionnalité (GetCustomerPilotFeatures retourne 720).
Vous pouvez télécharger tous les enregistrements d’extension d’annonces campaign promotion dans le compte en incluant la valeur DownloadEntity de CampaignPromotionAdExtensions 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 associe une extension de publicité promotionnelle à une campagne si des valeurs ID et ID parent valides sont fournies.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Campaign Promotion Ad Extension,Active,-11,-1111,,,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 BulkCampaignPromotionAdExtension , 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 BulkCampaignPromotionAdExtension
var bulkCampaignPromotionAdExtension = new BulkCampaignPromotionAdExtension
{
// Map properties in the Bulk file to the
// AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
{
// 'Id' column header in the Bulk file
AdExtensionId = promotionAdExtensionIdKey,
// 'Parent Id' column header in the Bulk file
EntityId = campaignIdKey,
},
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
};
uploadEntities.Add(bulkCampaignPromotionAdExtension);
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 d’extension d’annonce de promotion de campagne , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.
- Campagne
- Client Id
- Emplacement éditorial
- Code de raison éditorial
- État éditorial
- Terme éditorial
- Id
- Heure de modification
- Parent Id
- Pays d’éditeur
- État
Campagne
Nom de la campagne à laquelle cette extension d’annonce est associée ou supprimée.
Ajouter: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire
Remarque
Pour ajouter et supprimer, vous devez spécifier l’ID parent ou la 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
Supprimer: En lecture seule
Emplacement éditorial
Composant ou propriété de l’extension d’annonce qui a échoué à la révision éditoriale.
Ajouter: En lecture seule
Supprimer: En lecture seule
Code de raison éditorial
Code qui identifie la raison de l’échec. Pour obtenir la liste des codes de raison possibles, consultez Codes de raison éditorial.
Ajouter: En lecture seule
Supprimer: En lecture seule
État éditorial
La status éditoriale de l’extension d’annonce.
Les valeurs possibles sont décrites dans le tableau ci-dessous.
Ajouter: En lecture seule
Supprimer: En lecture seule
Terme éditorial
Terme qui a échoué à la révision éditoriale.
Ce champ n’est pas défini si une combinaison de termes a provoqué l’échec ou si l’échec est basé sur une violation de stratégie.
Ajouter: En lecture seule
Supprimer: En lecture seule
ID
Identificateur de l’extension d’annonce associée ou supprimée de la campagne.
Ce champ en bloc est mappé au champ Id de l’enregistrement Extension d’annonce de promotion .
Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur d’extension d’annonce existant ou un identificateur négatif égal au champ Id de l’enregistrement d’extension d’annonce de promotion parent. Cette option est recommandée si vous ajoutez de nouvelles extensions et associations 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.
Supprimer: Lecture seule et Obligatoire
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
Supprimer: En lecture seule
Parent Id
Identificateur de la campagne à laquelle cette extension d’annonce est associée ou supprimée.
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. Cela est recommandé si vous associez des extensions publicitaires à 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.
Supprimer: Lecture seule et Obligatoire
Remarque
Pour ajouter et supprimer, vous devez spécifier l’ID parent ou la campagne.
Pays d’éditeur
Liste des pays ou régions de l’éditeur dont les directives éditoriales n’autorisent pas le terme spécifié.
Dans un fichier en bloc, la liste des pays ou régions de l’éditeur est délimitée par un point-virgule (;).
Ajouter: En lecture seule
Supprimer: En lecture seule
Statut
Représente l’association status entre la campagne et l’extension d’annonce.
Les valeurs possibles sont Active et Deleted. Si l’extension d’annonce est associée à la campagne, la valeur de ce champ est Active.
Ajouter: En lecture seule
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.