Enregistrement d’exclusion de responsabilité - En bloc
Définit une clause d’exclusion de responsabilité qui peut être téléchargée et chargée dans un fichier en bloc.
Vous pouvez associer une clause d’exclusion de responsabilité à une campagne dans le compte. Utilisez les enregistrements d’exclusion de responsabilité de campagne pour gérer les associations d’exclusion de responsabilité.
Vous pouvez télécharger tous les enregistrements d’extension d’annonce d’exclusion de responsabilité dans le compte en incluant la valeur DownloadEntity de DisclaimerAdExtensions 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 clause d’exclusion de responsabilité à la bibliothèque partagée du compte.
Type,Status,Id,Parent Id,Campaign,Client Id,Modified Time,Start Date,End Date,Ad Schedule,Use Searcher Time Zone,Disclaimer Layout,Name,Popup Text,Title,Final Url,Mobile Final Url
Format Version,,,,,,,,,,,6.0,,,,,,
Disclaimer Ad Extension,Active,-18,0,,,ClientIdGoesHere,,,12/31/2020,English,,(Monday[09:00-21:00]),FALSE,Amenities,ValueOne;ValueTwo;ValueThree,https://www.contoso.com/one; https://www.contoso.com/two; https://www.contoso.com/three,https://mobile.contoso.com/one; https://mobile.contoso.com/two; https://mobile.contoso.com/three
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 BulkDisclaimerAdExtension , 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 BulkDisclaimerAdExtension
var bulkDisclaimerAdExtension = new BulkDisclaimerAdExtension
{
// 'Parent Id' column header in the Bulk file
AccountId = 0,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// DisclaimerAdExtension object of the Campaign Management service.
DisclaimerAdExtension = new DisclaimerAdExtension
{
// 'DisclaimerLayout' column header in the Bulk file
DisclaimerLayout = "additionalLine",
// 'Id' column header in the Bulk file
Id = disclaimerAdExtensionIdKey,
// 'Final Url' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://www.contoso.com/one",
"https://www.contoso.com/two",
"https://www.contoso.com/three"
},
// 'Mobile Final Url' column header in the Bulk file
FinalMobileUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://mobile.contoso.com/one",
"https://mobile.contoso.com/two",
"https://mobile.contoso.com/three"
},
// 'Name' column header in the Bulk file
Name = "DisclaimerName",
// 'PopupText' column header in the Bulk file
PopupText = "DisclaimerPopupText",
// 'Title' column header in the Bulk file
Title = "Disclaimer info",
// 'Tracking Template' column header in the Bulk file
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file
UrlCustomParameters = new CustomParameters
{
// Each custom parameter is delimited by a semicolon (;) in the Bulk file
Parameters = new[] {
new CustomParameter(){
Key = "promoCode",
Value = "PROMO1"
},
new CustomParameter(){
Key = "season",
Value = "summer"
},
}
},
// 'Ad Schedule' column header in the Bulk file
Scheduling = new Schedule
{
// Each day and time range is delimited by a semicolon (;) in the Bulk file
DayTimeRanges = new[]
{
// Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
new DayTime
{
Day = Day.Monday,
StartHour = 9,
StartMinute = Minute.Zero,
EndHour = 21,
EndMinute = Minute.Zero,
},
},
// 'End Date' column header in the Bulk file
EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Start Date' column header in the Bulk file
StartDate = null,
// 'Use Searcher Time Zone' column header in the Bulk file
UseSearcherTimeZone = false,
},
// 'Status' column header in the Bulk file
Status = AdExtensionStatus.Active,
},
};
uploadEntities.Add(bulkDisclaimerAdExtension);
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’exclusion de responsabilité , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.
- Planification des annonces
- Client Id
- Disposition de clause d’exclusion de responsabilité
- Emplacement éditorial
- Code de raison éditorial
- État éditorial
- Terme éditorial
- Date de fin
- URL finale
- Id
- URL finale mobile
- Heure de modification
- Name
- Parent Id
- Texte contextuel
- Pays d’éditeur
- Date de début
- Status
- Titre
- Utiliser le fuseau horaire du moteur de recherche
- Version
Planification des annonces
Liste des plages de jours et de temps auxquelles vous souhaitez que l’enregistrement s’affiche avec vos annonces. Chaque jour et intervalle de temps inclut le jour de la semaine, l’heure de début/fin et la minute de début/fin planifiée. Chaque plage de jours et de temps est placée entre parenthèses gauche et droite, et séparées des autres plages de jour et de temps par un point-virgule (;) délimiteur. Dans chaque jour et intervalle de temps, le format est Day[StartHour :StartMinue-EndHour :EndMinute].
Les valeurs possibles de StartHour sont comprises entre 00 et 23, où 00 équivaut à 12h00 et 12h00 à 12h00.
Les valeurs possibles de EndHour sont comprises entre 00 et 24, où 00 équivaut à 12 :00 et 12 :00.
Les valeurs possibles de StartMinute et EndMinute sont comprises entre 00 et 60.
L’exemple suivant illustre les plages de jour et de temps pendant les jours de la semaine de 9h00 à 21h00 : (lundi[09 :00-21 :00]);( Mardi[09 :00-21 :00]) ; (Mercredi[09 :00-21 :00]) ; (jeudi[09 :00-21 :00]) ; (Vendredi[09 :00-21 :00])
Ajouter: Optionnel. Si vous ne définissez pas ce champ, l’enregistrement peut être planifié à tout moment pendant les dates de début et de fin du calendrier.
Mettre à jour: Optionnel. Les plages de jours et de temps individuelles ne peuvent pas être mises à jour. Vous pouvez mettre à jour efficacement les plages de jours et de temps en envoyant un nouvel ensemble qui doit remplacer l’ensemble précédent. Les champs Planification des annonces, Date de fin, Date de début et Utiliser le fuseau horaire de la recherche dépendent les uns des autres et sont mis à jour ensemble. Si vous laissez tous ces champs vides pendant la mise à jour, aucun d’entre eux n’est mis à jour. Si vous incluez des valeurs pour l’un de ces champs, les valeurs précédentes de tous ces champs sont supprimées ou remplacées. Pour supprimer tous les paramètres de planification précédents, définissez chacun de ces champs sur delete_value.
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: Optionnel
Supprimer: En lecture seule
Disposition de clause d’exclusion de responsabilité
Disposition de l’exclusion de responsabilité. Il peut s’agir d’une valeur supplémentaireLine ou d’une fenêtre contextuelle.
Emplacement éditorial
Composant ou propriété de l’enregistrement qui a échoué à la révision éditoriale.
Ajouter: En lecture seule
Mettre à jour: 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
Mettre à jour: En lecture seule
Supprimer: En lecture seule
État éditorial
La status éditoriale de l’enregistrement.
Les valeurs possibles sont décrites dans le tableau ci-dessous.
Ajouter: En lecture seule
Mettre à jour: 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
Mettre à jour: En lecture seule
Supprimer: En lecture seule
End Date
Chaîne de date de fin planifiée d’enregistrement au format MM/JJ/AAAA.
La date de fin est incluse. Par exemple, si vous définissez ce champ sur 31/12/2020, les enregistrements cesseront d’être affichés à 23h59 le 31/12/2020.
Ajouter: Optionnel. Si vous ne spécifiez pas de date de fin, l’enregistrement continuera d’être remis, sauf si vous suspendez les campagnes, groupes d’annonces ou annonces associés.
Mettre à jour: Optionnel. La date de fin peut être raccourcie ou prolongée, tant que la date de début est null ou se produit avant la nouvelle date de fin. Si vous définissez ce champ sur la chaîne delete_value , vous supprimez effectivement la date de fin. Les champs Planification des annonces, Date de fin, Date de début et Utiliser le fuseau horaire de la recherche dépendent les uns des autres et sont mis à jour ensemble. Si vous laissez tous ces champs vides pendant la mise à jour, aucun d’entre eux n’est mis à jour. Si vous incluez des valeurs pour l’un de ces champs, les valeurs précédentes de tous ces champs sont supprimées ou remplacées. Pour supprimer tous les paramètres de planification précédents, définissez chacun de ces champs sur delete_value.
Supprimer: En lecture seule
URL finale
URL de la page d’accueil.
Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales.
- La longueur de l’URL est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.
- Vous pouvez spécifier jusqu’à 10 éléments de liste pour l’URL finale et l’URL finale mobile. Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service autorise jusqu’à 10 éléments de liste pour une compatibilité descendante potentielle.
- Chaque URL est délimitée par un point-virgule et un espace (« ; »).
- L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple {lpurl}.
- Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://.
- Si vous spécifiez l’URL finale mobile, vous devez également spécifier l’URL finale.
Ajouter: Obligatoire
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: En lecture seule
ID
Identificateur généré par le système de l’enregistrement.
Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. Un jeu d’identificateurs négatifs pour l’enregistrement peut ensuite être référencé dans le champ Id des types d’enregistrements dépendants tels que et Exclusion de responsabilité de campagne. Cette option est recommandée si vous ajoutez un nouvel enregistrement et de nouveaux enregistrements dépendants 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: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire
URL finale mobile
URL de la page d’accueil des appareils mobiles.
Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales.
- La longueur de l’URL est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.
- Vous pouvez spécifier jusqu’à 10 éléments de liste pour l’URL finale et l’URL finale mobile. Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service autorise jusqu’à 10 éléments de liste pour une compatibilité descendante potentielle.
- Chaque URL est délimitée par un point-virgule et un espace (« ; »).
- L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple {lpurl}.
- Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://.
- Si vous spécifiez l’URL finale mobile, vous devez également spécifier l’URL finale.
Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
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: En lecture seule
Supprimer: En lecture seule
Nom
Nom de l’exclusion de responsabilité. Il est utilisé uniquement pour la création de rapports afin d’identifier l’enregistrement.
Longueur longueur : 35 caractères.
Parent Id
Identificateur généré par le système du compte qui contient l’enregistrement.
Ce champ en bloc est mappé au champ Id de l’enregistrement de compte .
Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule
Texte contextuel
Texte obligatoire si la clause d’exclusion de responsabilité est dans la disposition contextuelle .
Longueur longueur : 500 caractères.
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
Mettre à jour: En lecture seule
Supprimer: En lecture seule
Date de début
Chaîne de date de début planifiée de l’enregistrement au format MM/JJ/AAAA.
La date de début est incluse. Par exemple, si vous définissez StartDate sur 5/5/2020, les enregistrements commenceront à être affichés à 12h00 le 5/5/2020.
Ajouter: Optionnel. Si vous ne spécifiez pas de date de début, l’enregistrement peut immédiatement être planifié.
Mettre à jour: Optionnel. La date de début peut être raccourcie ou prolongée, tant que la date de fin est null ou se produit après la nouvelle date de début. Si vous définissez ce champ sur la chaîne delete_value , vous supprimez effectivement la date de début et l’enregistrement est immédiatement éligible pour être planifié. Les champs Planification des annonces, Date de fin, Date de début et Utiliser le fuseau horaire de la recherche dépendent les uns des autres et sont mis à jour ensemble. Si vous laissez tous ces champs vides pendant la mise à jour, aucun d’entre eux n’est mis à jour. Si vous incluez des valeurs pour l’un de ces champs, les valeurs précédentes de tous ces champs sont supprimées ou remplacées. Pour supprimer tous les paramètres de planification précédents, définissez chacun de ces champs sur delete_value.
Supprimer: En lecture seule
Statut
Status de l’enregistrement.
Les valeurs possibles sont Active ou Deleted.
Ajouter: Optionnel. La valeur par défaut est Active.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.
Titre
Titre de la fenêtre contextuelle dans la disposition contextuelle.
Longueur longueur : 75 caractères.
Utiliser le fuseau horaire du moteur de recherche
Détermine s’il faut utiliser le fuseau horaire du compte ou le fuseau horaire de l’utilisateur de recherche où les publicités peuvent être remises.
Affectez à cette propriété la valeur TRUE si vous souhaitez que les enregistrements soient affichés dans le fuseau horaire de l’utilisateur de recherche, et définissez-la sur FALSE.
Ajouter: Optionnel. Si vous ne spécifiez pas ce champ ou si vous le laissez vide, la valeur par défaut false est définie et le fuseau horaire du compte est utilisé.
Mettre à jour: Optionnel. Si vous définissez ce champ sur la chaîne delete_value , vous réinitialisez efficacement la valeur par défaut false. Les champs Planification des annonces, Date de fin, Date de début et Utiliser le fuseau horaire de la recherche dépendent les uns des autres et sont mis à jour ensemble. Si vous laissez tous ces champs vides pendant la mise à jour, aucun d’entre eux n’est mis à jour. Si vous incluez des valeurs pour l’un de ces champs, les valeurs précédentes de tous ces champs sont supprimées ou remplacées. Pour supprimer tous les paramètres de planification précédents, définissez chacun de ces champs sur delete_value.
Supprimer: En lecture seule
Version
Nombre de mises à jour du contenu de l’enregistrement. La version est définie sur 1 lorsque vous ajoutez l’enregistrement et est incrémentée chaque fois qu’elle est révisée.
Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule