Enregistrement d’extension d’annonce de promotion - En bloc
Définit une extension d’annonce de promotion qui peut être téléchargée et chargée dans un fichier en bloc.
Remarque
Les extensions de promotion sont disponibles pour les clients en AU, CA, DE, FR, États-Unis et Royaume-Uni.
Vous pouvez associer une extension de publicité promotionnelle au compte ou à des campagnes et des groupes d’annonces dans le compte. Chaque entité (compte, campagne ou groupe d’annonces) peut être associée à jusqu’à 20 extensions publicitaires de promotion. Utilisez les enregistrements Account Promotion Ad Extension, Ad Group Promotion Ad Extension et Campaign Promotion Ad Extension pour gérer les associations d’extension d’annonce de promotion.
Vous pouvez télécharger tous les enregistrements d’extension Promotion Ad dans le compte en incluant la valeur DownloadEntity de PromotionAdExtensions 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 extension d’annonce de promotion à la bibliothèque partagée du compte.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Language,Start Date,End Date,Name,Version,Ad Schedule,Use Searcher Time Zone,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Promotion Target,Discount Modifier,Percent Off,Money Amount Off,Promotion Code,Orders Over Amount,Occasion,Promotion Start,Promotion End,Currency Code
Format Version,,,,,,,,,,,6,,,,,,,,,,,,,,,,,
Promotion Ad Extension,Active,-25,0,,,ClientIdGoesHere,,English,,12/31/2021,,,(Monday[09:00-21:00]),FALSE,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,shoes,None,20000000,,SAVE20,,WomensDay,,12/31/2021,USD
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 BulkPromotionAdExtension , 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 BulkPromotionAdExtension
var bulkPromotionAdExtension = new BulkPromotionAdExtension
{
// '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
// PromotionAdExtension object of the Campaign Management service.
PromotionAdExtension = new PromotionAdExtension
{
// 'Id' column header in the Bulk file
Id = promotionAdExtensionIdKey,
// 'Currency Code' column header in the Bulk file
CurrencyCode = "USD",
// 'Discount Modifier' column header in the Bulk file
DiscountModifier = PromotionDiscountModifier.None,
// 'Language' column header in the Bulk file
Language = "English",
// 'Money Amount Off' column header in the Bulk file
MoneyAmountOff = null,
// 'Orders Over Amount' column header in the Bulk file
OrdersOverAmount = null,
// 'Percent Off' column header in the Bulk file
PercentOff = 20000000,
// 'Promotion Code' column header in the Bulk file
PromotionCode = "SAVE20",
// 'Promotion Target' column header in the Bulk file
PromotionItem = "shoes",
// 'Occasion' column header in the Bulk file
PromotionOccasion = PromotionOccasion.WomensDay,
// 'Promotion End' column header in the Bulk file
PromotionEndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Promotion Start' column header in the Bulk file
PromotionStartDate = null,
// '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/womenshoesale"
},
// '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/womenshoesale"
},
// '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(bulkPromotionAdExtension);
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 , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.
- Planification des annonces
- Client Id
- Code monétaire
- Paramètre personnalisé
- Modificateur de remise
- Emplacement éditorial
- Code de raison éditorial
- État éditorial
- Terme éditorial
- Date de fin
- URL finale
- Suffixe d’URL final
- Id
- Language
- URL finale mobile
- Heure de modification
- Montant de l’argent off
- Ocasion
- Commandes supérieures au montant
- Parent Id
- Pays d’éditeur
- Promotion Code
- Fin de la promotion
- Démarrage de la promotion
- Cible de promotion
- Date de début
- État
- Modèle de suivi
- 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’extension d’annonce 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’extension d’annonce sera éligible pour la planification à 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
Code monétaire
Code monétaire du prix ou de la remise de la promotion.
Ce champ s’applique uniquement si vous définissez Money Amount Off ou Orders Over Amount.
Les codes monétaires pris en charge sont ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, GBP, HKD, INR, MXN, NZD, PEN, PHP, PLN, SEK, SGD, USD, TWD et VEF.
Ajouter: Obligatoire si Money Amount Off ou Orders Over Amount sont définis.
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 pourcentage désactivé ou code de promotion, ce paramètre n’est plus applicable et sera supprimé.
Supprimer: En lecture seule
Paramètre personnalisé
Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL.
Dans un fichier en bloc, la liste des paramètres personnalisés est mise en forme comme suit.
Mettez en forme chaque paire de paramètres personnalisés en tant que Clé=Valeur, par exemple {_promoCode}=PROMO1.
Microsoft Advertising accepte les 3 premières paires clé/valeur de paramètres personnalisés que vous incluez, et tous les paramètres personnalisés supplémentaires seront ignorés. Pour les clients dans le pilote d’augmentation de la limite des paramètres personnalisés phase 3 (GetCustomerPilotFeatures retourne 635), Microsoft Advertising accepte les 8 premières paires clé/valeur de paramètre personnalisé que vous incluez, et si vous incluez plus de 8 paramètres personnalisés, une erreur est retournée.
Chaque paire clé-valeur est délimitée par un point-virgule et un espace (« ; »), par exemple {_promoCode}=PROMO1 ; {_season}=été.
Une clé ne peut pas contenir de point-virgule. Si une valeur contient un point-virgule, elle doit être placée dans une séquence d’échappement en tant que « \ ; ». En outre, si la valeur contient une barre oblique inverse, elle doit également être placée dans une séquence d’échappement en tant que « \ ».
La clé ne peut pas dépasser 16 UTF-8 octets et la valeur ne peut pas dépasser 200 UTF-8 octets. Pour les clients du pilote d’augmentation de la limite des paramètres personnalisés phase 3 (GetCustomerPilotFeatures retourne 635), la limite de valeur passe à 250 octets UTF-8. La clé est obligatoire et la valeur est facultative. La taille maximale de la clé n’inclut pas les accolades et le trait de soulignement, c’est-à-dire « { », « _ » et « } ».
Remarque
Avec le service en bloc, la clé doit être mise en forme avec des accolades environnantes et un trait de soulignement de début. Par exemple, si la clé est promoCode, elle doit être mise en forme comme {_promoCode}. Avec le service Gestion des campagnes, vous ne pouvez pas spécifier les accolades et le trait de soulignement environnants.
Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer tous les paramètres personnalisés, définissez ce champ sur delete_value. Le delete_value mot clé supprime le paramètre précédent. Pour supprimer un sous-ensemble de paramètres personnalisés, spécifiez les paramètres personnalisés que vous souhaitez conserver et omettez ceux que vous ne souhaitez pas conserver. Le nouvel ensemble de paramètres personnalisés remplace tout jeu de paramètres personnalisé précédent.
Supprimer: En lecture seule
Modificateur de remise
Modificateur de remise de promotion.
Les valeurs possibles pour ce champ sont None et UpTo.
- Aucun : la remise de promotion n’est pas modifiée.
- UpTo : la remise de promotion est modifiée avec le préfixe de chaîne « Up to ». Par exemple, si la remise de promotion non modifiée est « 20 $ de rabais sur les chaussures », la promotion modifiée est « Jusqu’à 20 $ sur les chaussures ».
Ajouter: Optionnel. Si vous ne spécifiez pas ce champ ou si vous le laissez vide, la valeur par défaut None est définie.
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
Emplacement éditorial
Composant ou propriété de l’extension d’annonce 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’extension d’annonce.
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’extension d’annonce au format MM/JJ/AAAA.
La date de fin est incluse. Par exemple, si vous définissez ce champ sur 31/12/2020, les extensions d’annonce cesseront d’être affichées à 23h59 le 31/12/2020.
Ajouter: Optionnel. Si vous ne spécifiez pas de date de fin, l’extension d’annonce continuera d’être remise, 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
Suffixe d’URL final
Le suffixe d’URL final peut inclure des paramètres de suivi qui seront ajoutés à la fin de l’URL de votre page d’accueil. Nous vous recommandons de placer les paramètres de suivi requis par votre page d’accueil dans un suffixe d’URL final afin que vos clients soient toujours envoyés à votre page d’accueil. Pour plus d’informations et les règles de validation, consultez Suffixe d’URL final dans les guides techniques.
Remarque
Cette fonctionnalité n’est disponible que pour les clients dans le pilote Final URL Suffix Phase 3 (GetCustomerPilotFeatures renvoie 636). Si vous n’êtes pas dans le pilote, cette propriété sera ignorée et aucune erreur ne sera retournée.
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
ID
Identificateur généré par le système de l’extension d’annonce.
Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. Un identificateur négatif défini pour l’extension d’annonce peut ensuite être référencé dans le champ Id des types d’enregistrements dépendants tels que l’extension d’annonce de promotion de groupe d’annonces et l’extension d’annonce de promotion de campagne. Cette option est recommandée si vous ajoutez de nouvelles extensions d’annonces 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
Langue
Langue dans laquelle l’extension de publicité sera servie.
L’extension est toujours servie dans cette langue, quels que soient les paramètres linguistiques de la campagne ou du groupe d’annonces.
Les chaînes de langue prises en charge sont les suivantes : danois, néerlandais, anglais, finnois, Français, allemand, italien, norvégien, portugais, espagnol, suédois et traditionnelchinese.
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
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
Montant de l’argent off
La valeur de la promotion de l’argent.
Par exemple, pour promouvoir « 20 $ sur les chaussures - Sur les commandes de plus de 100 $ », définissez la cible de promotion sur « chaussures », définissez Code monétaire sur « USD », définissez Money Amount Off sur 20 et définissez Commandes supérieures au montant sur 100.
Ajouter: Obligatoire. Vous devez définir Money Amount Off ou Percent Off, mais vous ne pouvez pas définir les deux.
Mettre à jour: Optionnel. Vous pouvez définir money amount off ou percent off, mais vous ne pouvez pas définir les deux.
Supprimer: En lecture seule
Ocasion
L’occasion de la promotion.
Les champs Occasion de promotion et Planification (Planification des annonces, Date de fin, Date de début et Utiliser les champs Fuseau horaire de la recherche) déterminent quand la promotion est éligible pour être affichée dans les annonces.
L’occasion de promotion détermine la période ou la saisonnalité, par exemple, WomensDay du 15 février au 31 mars de chaque année. La promotion ne s’exécutera que dans les dates correspondant à l’occasion que vous définissez. Consultez le tableau ci-dessous pour plus d’informations sur la plage de dates définie pour chaque occasion.
La planification peut limiter la promotion à une période plus courte dans la plage de dates de l’occasion, par exemple, limiter la promotion à s’exécuter du 20 février au 8 mars. La planification peut également être utilisée pour exécuter la même promotion plusieurs années, par exemple, exécuter la promotion WomensDay chaque année du 15 février au 31 mars.
Ajouter: Optionnel. Si vous ne spécifiez pas ce champ ou si vous le laissez vide, la valeur par défaut None est définie.
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, le début de la promotion et la fin de la promotion doivent également être définis pour conserver ou mettre à jour les paramètres précédents.
Supprimer: En lecture seule
Commandes supérieures au montant
Valeur des commandes sur le montant ajoutée à la cible de promotion.
Par exemple, pour promouvoir « 20 $ sur les chaussures - Sur les commandes de plus de 100 $ », définissez la cible de promotion sur « chaussures », définissez Code monétaire sur « USD », définissez Money Amount Off sur 20 et définissez Commandes supérieures au montant sur 100.
Ajouter: Optionnel. Vous ne pouvez pas définir les commandes supérieures au montant et le code de promotion.
Mettre à jour: Optionnel. Vous ne pouvez pas définir les commandes supérieures au montant et le code de promotion. 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 « 0 » (zéro), le paramètre précédent est supprimé.
Supprimer: En lecture seule
Parent Id
Identificateur généré par le système du compte qui contient l’extension d’annonce.
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
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
Pourcentage désactivé
Pourcentage de la valeur de promotion en tant que valeur double.
Par exemple, 10.0 représente une remise de 10 %.
Ajouter: Obligatoire. Vous devez définir Money Amount Off ou Percent Off, mais vous ne pouvez pas définir les deux.
Mettre à jour: Optionnel. Vous pouvez définir money amount off ou percent off, mais vous ne pouvez pas définir les deux. Si vous définissez ce champ, le paramètre Code monétaire n’est plus applicable et sera supprimé s’il a été précédemment défini.
Supprimer: En lecture seule
Promotion Code
Code de promotion ajouté à la cible de promotion.
Par exemple, pour promouvoir « 20 $ de remise des chaussures - Promocode SAVE20 », définissez la cible de promotion sur « chaussures », définissez Code monétaire sur « USD », définissez Money Amount Off sur 20 et définissez Code de promotion sur « SAVE20 ».
La chaîne peut contenir un maximum de 15 caractères.
Ajouter: Optionnel. Vous ne pouvez pas définir les commandes supérieures au montant et le code de promotion.
Mettre à jour: Optionnel. Vous ne pouvez pas définir les commandes supérieures au montant et le code de promotion. 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é. Si vous définissez ce champ, le paramètre Code monétaire n’est plus applicable et sera supprimé s’il a été précédemment défini.
Supprimer: En lecture seule
Fin de la promotion
La date de fin permet d’informer la ou les dates de promotion qui seront affichées dans l’annonce.
Par exemple, si les dates de début de la promotion et de fin de la promotion sont toutes deux définies sur le 14 février, le texte « Valide le 14 février » peut être inclus dans la promotion affichée.
La date de début de la promotion doit être antérieure ou égale à la date de fin de la promotion .
Cette propriété ne remplace pas la plage de remise inhérente pour une promotion. Les champs Occasion de la promotion et Planification (Planification des annonces, Date de fin, Date de début et Utiliser le fuseau horaire de la recherche) déterminent quand la promotion est éligible pour être affichée dans les annonces.
Si la date de fin est déjà dépassée pour l’année en cours, chaque date de début et de fin doit être définie pour les dates de l’année suivante.
Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer la date de fin actuelle et ne définir aucune date de fin, définissez ce champ sur la chaîne delete_value . Lorsque vous récupérez l’extension d’annonce de promotion la prochaine fois, ce champ n’est pas défini.
Supprimer: En lecture seule
Démarrage de la promotion
La date de début permet d’indiquer la ou les dates de promotion qui seront affichées dans l’annonce.
Par exemple, si les dates de début de la promotion et de fin de la promotion sont toutes deux définies sur le 14 février, le texte « Valide le 14 février » peut être inclus dans la promotion affichée.
La date de début de la promotion doit être antérieure ou égale à la date de fin de la promotion .
Cette propriété ne remplace pas la plage de remise inhérente pour une promotion. Les champs Occasion de la promotion et Planification (Planification des annonces, Date de fin, Date de début et Utiliser le fuseau horaire de la recherche) déterminent quand la promotion est éligible pour être affichée dans les annonces.
Si la date de fin est déjà dépassée pour l’année en cours, chaque date de début et de fin doit être définie pour les dates de l’année suivante.
Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer la date de fin actuelle et ne définir aucune date de fin, définissez ce champ sur la chaîne delete_value . Lorsque vous récupérez l’extension d’annonce de promotion la prochaine fois, ce champ n’est pas défini.
Supprimer: En lecture seule
Cible de promotion
La cible ou l’élément de promotion.
Par exemple, vous pouvez exécuter une promotion pour les « chaussures » avec une remise de 20 $ ou de 20 %. Pour exécuter une promotion pour « Jusqu’à 20 $ sur les chaussures », définissez la cible de la promotion sur « chaussures », définissez le modificateur de remise sur « UpTo », définissez Code monétaire sur « USD » et définissez Money Amount Off sur 20.
La chaîne peut contenir un maximum de 20 caractères.
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
Date de début
Chaîne de date de début planifiée de l’extension d’annonce au format MM/JJ/AAAA.
La date de début est incluse. Par exemple, si vous définissez StartDate sur 5/5/2020, les extensions publicitaires commenceront à s’afficher à 12 :00 le 5/5/2020.
Ajouter: Optionnel. Si vous ne spécifiez pas de date de début, l’extension d’annonce est immédiatement éligible pour être planifiée.
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’extension d’annonce est immédiatement éligible pour être planifiée. 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’extension d’annonce.
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é.
Modèle de suivi
Modèle de suivi à utiliser pour vos URL de promotion.
Les règles de validation suivantes s’appliquent aux modèles de suivi. Pour plus d’informations sur les modèles et paramètres pris en charge, consultez l’article d’aide Microsoft Advertising Quels paramètres de suivi ou d’URL puis-je utiliser ?
Les modèles de suivi définis pour les entités de niveau inférieur, par exemple, les publicités remplacent ceux définis pour les entités de niveau supérieur, par exemple la campagne. Pour plus d’informations, consultez Limites d’entité.
La longueur du modèle de suivi est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.
Le modèle de suivi doit être une URL bien formée commençant par l’une des suivantes : http://, https://, {lpurl} ou {unscapedlpurl}.
Microsoft Advertising ne vérifie pas s’il existe des paramètres personnalisés. Si vous utilisez des paramètres personnalisés dans votre modèle de suivi et qu’ils n’existent pas, l’URL de la page d’accueil inclut les espaces réservés de clé et de valeur de vos paramètres personnalisés sans substitution. Par exemple, si votre modèle de suivi est
https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}et que ni {_season} ni {_promocode} n’est défini au niveau de la campagne, du groupe d’annonces, du critère, du mot clé ou de la publicité, l’URL de la page d’accueil sera la même.
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
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 extensions publicitaires s’affichent 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 fois où le contenu de l’extension d’annonce a été mis à jour. La version est définie sur 1 lorsque vous ajoutez l’extension 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