Partager via


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

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.

Valeur Description
Actif L’extension d’annonce a fait l’objet d’une révision éditoriale.
ActiveLimited L’extension d’annonce a fait l’objet d’une révision éditoriale dans un ou plusieurs marchés, et un ou plusieurs champs de l’extension publicitaire font l’objet d’une révision éditoriale dans un autre marché. Par exemple, la prolongation de la publicité a passé l’examen éditorial pour le Canada et est toujours en attente d’examen dans le États-Unis.
Désapprouvé L’extension d’annonce a échoué à la révision éditoriale.
Inactif Un ou plusieurs champs de l’extension de publicité font l’objet d’une révision éditoriale.

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.

Valeur d’occasion Description
BackToSchool La promotion « Retour à l’école » peut s’exécuter à tout moment en fonction de la planification de votre extension publicitaire.
BlackFriday La promotion « Black Friday » peut s’exécuter du 15 octobre au 15 décembre.
BoxingDay La promotion « Boxing Day » peut s’exécuter du 15 décembre au 15 janvier.
Carnaval La promotion « Carnaval » peut se présenter du 1er février au 31 mars.
ChinoisNewYear La promotion « Nouvel An chinois » peut s’exécuter du 15 janvier au 1er mars.
Noël La promotion « Noël » peut s’exécuter du 1er novembre au 15 janvier.
CyberMonday La promotion « Cyber Monday » peut s’exécuter du 15 octobre au 15 décembre.
Diwali La promotion « Diwali » peut s’exécuter du 1er septembre au 1er décembre.
Pâques La promotion « Pâques » peut s’exécuter du 1er mars au 30 avril.
EidAlAdha La promotion « Aïd al-Adha » peut s’exécuter à tout moment en fonction de la planification de votre extension publicitaire.
EidAlFitr La promotion « Aïd al-Fitr » peut s’exécuter à tout moment en fonction de la planification de votre extension publicitaire.
EndOfSeason La promotion « Fin de saison » peut s’exécuter à tout moment en fonction de la planification de votre extension publicitaire.
Épiphanie La promotion « Epiphany » peut s’exécuter du 15 décembre au 31 janvier.
FallSale La promotion « Vente d’automne » peut s’exécuter à tout moment en fonction de la planification de votre extension publicitaire.
FathersDay La promotion « Fête des Pères » peut être exécutée à tout moment en fonction de la planification de votre extension publicitaire.
Halloween La promotion « Halloween » peut se présenter du 1er octobre au 15 novembre.
Hanoukka La promotion « Hanukka » peut s’exécuter du 15 novembre au 31 janvier.
Holi La promotion « Holi » peut s’exécuter du 1er février au 31 mars.
IndependenceDay La promotion « Jour de l’Indépendance » peut s’exécuter à tout moment en fonction de la planification de votre extension publicitaire.
LaborDay La promotion de la fête du Travail peut avoir lieu du 15 avril au 15 septembre.
MotherDay La promotion « Fête des mères » peut être exécutée à tout moment en fonction de la planification de votre extension publicitaire.
Journée nationale La promotion de la « Fête nationale » peut être exécutée à tout moment en fonction de la planification de votre extension publicitaire.
Navratri La promotion « Navratri » peut s’exécuter du 15 septembre au 31 octobre.
NewYears La promotion « Nouvel An » peut s’exécuter du 1er décembre au 28 février.
Aucun La promotion peut s’exécuter à tout moment en fonction de la planification de votre extension publicitaire.
ParentsDay La promotion « Fête des parents » peut avoir lieu du 15 avril au 1er août.
Pâque La promotion « Pâques » peut s’exécuter du 15 février au 1er mai.
Ramadan La promotion « Ramadan » peut être exécutée à tout moment en fonction de la planification de votre extension publicitaire.
RoshHashanah La promotion « Rosh Hashanah » peut s’exécuter du 15 août au 1er novembre.
SinglesDay La promotion « Single’s Day » peut s’exécuter du 15 octobre au 30 novembre.
Songkran La promotion « Songkran » peut s’exécuter à tout moment en fonction de la planification de votre extension publicitaire.
SpringSale La promotion « Spring Sale » peut s’exécuter à tout moment en fonction de la planification de votre extension publicitaire.
StNicholasDay La promotion de la « Saint-Nicolas » peut s’exécuter du 1er novembre au 31 décembre.
SummerSale La promotion « Vente d’été » peut s’exécuter à tout moment en fonction de la planification de votre extension publicitaire.
Inconnu Réservé à une utilisation future.
ValentinesDay La promotion de la Saint-Valentin peut s’exécuter du 15 janvier au 28 février.
WinterSale La promotion « Vente d’hiver » peut être exécutée à tout moment en fonction de la planification de votre extension publicitaire.
WomensDay La promotion de la Journée de la femme peut s’exécuter du 15 février au 31 mars.
YearEndGift La promotion « Cadeau de fin d’année » peut être exécutée à tout moment en fonction de la planification de votre extension publicitaire.

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