Partager via

Notes de publication pour les scripts Microsoft Advertising

Pour plus d’informations sur les modifications incluses dans chaque version, consultez les sections suivantes.

31 mars 2021

La position moyenne n’est plus disponible dans Microsoft Advertising.

La méthode getAveragePosition est supprimée de l’objet Stats .

La colonne AveragePosition est supprimée en tant que condition avec les sélecteurs suivants.

5 mars 2021

Ajout de la prise en charge du taux d’impression maximal absolu et du taux d’impression supérieur sous forme de pourcentage de vos impressions totales.

Ajout des méthodes suivantes à l’objet Stats .

Ajout AbsoluteTopImpressionRate de colonnes et TopImpressionRate si possible que vous pouvez spécifier avec les sélecteurs suivants.

23 février 2021

Ajout de la prise en charge des annonces de recherche réactives.

  • Ajout de l’objet ResponsiveSearchAd , qui définit une annonce de recherche réactive.

  • Ajout de l’objet ResponsiveSearchAdBuilder , que vous utilisez pour ajouter une annonce de texte développé au groupe d’annonces.

  • Ajout de la responsiveSearchAdBuilder méthode à l’objet AdBuilderSpace . Si vous souhaitez créer une annonce de recherche réactive, vous devez appeler la responsiveSearchAdBuilder méthode pour obtenir l’objet ResponsiveSearchAdBuilder .

  • Ajout de l’objet AdTextAsset , qui contient des propriétés pour les descriptions d’annonces de recherche réactive et les titres.

  • Ajout de la responsiveSearchAd méthode à l’objet AdTypeSpace , qui contient les méthodes utilisées pour tester si une annonce est du type spécifié. Par exemple, pour tester si la publicité est une annonce de recherche réactive.

  • Ajout de la responsiveSearchAd méthode à l’objet AdViewSpace , qui est utilisé pour convertir une publicité en un type spécifique. Par exemple, caster l’objet d’annonce de base en annonce de recherche réactive.

21 janvier 2021

Ajout de la prise en charge des audiences ciblées et exclues.

Cette modification a ajouté les objets suivants :

10 décembre 2020

Ajout de la prise en charge des emplacements ciblés et exclus.

Cette modification a ajouté les objets suivants :

Ajout de l’objet ExcludedLocationOperation , que vous utilisez pour déterminer si Les scripts ont correctement ajouté l’emplacement exclu.

Ajout de l’objet TargetedLocationOperation , que vous utilisez pour déterminer si Les scripts ont correctement ajouté l’emplacement ciblé.

31 mars 2020

Ajout des objets suivants qui dérivent de ProductGroup :

Ajout des méthodes suivantes à ProductGroup :

  • asChannel()
  • asChannelExclusivity()

Suppression des appels à Logger.Log() de certains exemples de script. Étant donné que la journalisation est un appel coûteux en termes de performances, il est conseillé d’utiliser la journalisation avec parcimonie et probablement pas dans des boucles à volume élevé, sauf pour fournir une notification des problèmes. En outre, au lieu d’utiliser plusieurs Log() appels pour écrire plusieurs lignes, utilisez un seul appel et incluez des caractères de nouvelle ligne (« \n »).

16 janvier 2020

Ajout de la prise en charge des groupes de produits. La prise en charge est limitée à l’énumération des groupes de produits et à la mise à jour de leurs enchères. Pour obtenir des exemples, consultez exemples de scripts.

Cette modification a ajouté les objets suivants :

Ajout des objets suivants qui dérivent de ProductGroup :

Ajout des méthodes suivantes à AdsApp :

Ajout des méthodes suivantes à AdGroup :

Ajout de la méthode suivante à Cammpaign :

Ajout de CampaignType comme colonne possible à la méthode withCondition de l’objet AdGroupSelector.

Ajout de Type comme colonne possible à la méthode withCondition de l’objet CampaignSelector.

18 octobre 2019

Ajout de la Id colonne à la withCondition() méthode des objets AdSelector et KeywordSelector . Vous pouvez utiliser cette colonne pour case activée pour les annonces ou les mots clés dont les ID sont supérieurs à l’ID spécifié (par exemple, withCondition('Id > 1234')).

Ajout de la solution de script Vérifier les URL et mot clé, que vous pouvez utiliser pour case activée si les annonces ou mots clés de vos comptes contiennent des URL rompues.

7 octobre 2019

Ajout CombinedApprovalStatus en tant que colonne possible que vous pouvez spécifier lors de la sélection de mots clés. Par exemple, vous pouvez utiliser la colonne pour sélectionner des mots clés qui ont été désapprouvés pour des raisons éditoriales. Consultez KeywordSelector.withCondition.

13 septembre 2019

Ajout de l’objet ExecutionInfo , qui contient des informations sur l’environnement dans lequel le script est en cours d’exécution. Par exemple, si le script s’exécute en mode préversion ou si le script est autorisé à poursuivre son exécution.

Ajout de la getExecutionInfo méthode à l’objet AdsApp . Utilisez cette méthode pour obtenir l’objet ExecutionInfo .

Ajout de la getRemainingDailyQuota méthode à l’objet UrlFetchApp . Utilisez cette méthode pour obtenir le nombre restant d’appels fetch() que l’utilisateur peut effectuer aujourd’hui.

20 août 2019

Vous trouverez ci-dessous une modification de documentation uniquement.

  • Nous avons précisé que Scripts utilise le fuseau horaire du compte comme ailleurs dans Microsoft Advertising. Par exemple, si vous utilisez la méthode .forDateRange() d’un sélecteur, Scripts utilise le fuseau horaire du compte pour déterminer les données à retourner. En savoir plus
  • Nous avons précisé que la latence des données dans Scripts est la même qu’ailleurs dans Microsoft Advertising. En savoir plus

Voici les modifications d’API sans rupture pour prendre en charge les étiquettes.

  • Ajout des méthodes suivantes à l’objet AdsApp .
    • createLabel : crée une étiquette
    • labels : obtient un sélecteur utilisé pour filtrer la liste des étiquettes dans ce compte
  • Ajout des objets liés aux étiquettes suivants.
    • Label : définit une étiquette.
    • LabelSelector : obtient une liste d’étiquettes pour le compte.
    • LabelIterator : itère sur une liste d’étiquettes qui correspondent aux critères de sélection du sélecteur.
  • Ajout des méthodes suivantes à l’objet Keyword .
    • applyLabel : applique l’étiquette au mot clé
    • étiquettes : obtient un sélecteur utilisé pour filtrer la liste des étiquettes appliquées à cette mot clé
    • removeLabel : supprime l’étiquette de cette mot clé
  • Ajout de la colonne LabelNames à la méthode withCondition de l’objet KeywordSelector.
  • Ajout des méthodes suivantes aux objets Ad et ExpandedTextAd .
    • applyLabel : applique l’étiquette à l’annonce
    • étiquettes : obtient un sélecteur utilisé pour filtrer la liste des étiquettes appliquées à cette publicité
    • removeLabel : supprime l’étiquette de cette annonce
  • Ajout de la colonne LabelNames à la méthode withCondition de l’objet AdSelector.
  • Ajout des méthodes suivantes à l’objet AdGroup .
    • applyLabel : applique l’étiquette au groupe d’annonces
    • labels : obtient un sélecteur utilisé pour filtrer la liste des étiquettes appliquées à ce groupe d’annonces
    • removeLabel : supprime l’étiquette de ce groupe d’annonces
  • Ajout de la colonne LabelNames à la méthode withCondition de l’objet AdGroupSelector.
  • Ajout des méthodes suivantes à l’objet Campaign .
    • applyLabel : applique l’étiquette à la campagne
    • étiquettes : obtient un sélecteur utilisé pour filtrer la liste des étiquettes appliquées à cette campagne
    • removeLabel : supprime l’étiquette de cette campagne
  • Ajout de la colonne LabelNames à la méthode withCondition de l’objet CampaignSelector.

30 avril 2019

Vous trouverez ci-dessous une modification de documentation uniquement.

  • Bing Ads est désormais Microsoft Advertising. Notre nouveau nom reflète la façon dont nous développons nos solutions publicitaires pour vous aider à atteindre plus de clients. Toutes les références à la plateforme Bing Ads dans la documentation ont été remplacées par Microsoft Advertising.

Voici les modifications d’API sans rupture pour prendre en charge la mise à jour de la marque.

  • Ajout de l’objet AdsApp . Les scripts continueront à prendre en charge l’objet BingAdsApp pour la compatibilité descendante ; Toutefois, nous vous encourageons à mettre à jour vos scripts pour utiliser les nouveaux objets dès que vous le souhaitez.

25 mars 2019

Vous trouverez ci-dessous une modification de documentation uniquement.

11 février 2019

Ajout des méthodes suivantes à l’objet BingAdsAccountStats .

Remarque

Si vous utilisez les méthodes getClickConversionRate() et getConvertedClicks(), vous devez mettre à jour vos scripts pour utiliser les méthodes getConversionRate() et getConversions() à la place.

Ajout des méthodes suivantes à l’objet Stats .

Remarque

Si vous utilisez les méthodes getClickConversionRate() et getConvertedClicks(), vous devez mettre à jour vos scripts pour utiliser les méthodes getConversionRate() et getConversions() à la place.

27 novembre 2018

Vous trouverez ci-dessous une modification de documentation uniquement.

7 novembre 2018

Vous trouverez ci-dessous une modification de documentation uniquement.

  • Modification de la note d’aperçu pour indiquer que Scripts est désormais en version bêta ouverte et disponible pour tous les utilisateurs de Microsoft Advertising.

4 octobre 2018

Il s’agit de la version bêta de Scripts. Pour plus d’informations sur la participation au programme, contactez votre responsable de compte. Les classes et la documentation Scripts sont susceptibles d’être modifiées.

Ajout des objets suivants pour prendre en charge l’extraction d’URL.

  • Ajout de l’objet UrlFetchApp , qui est l’objet de niveau supérieur que vous utilisez pour extraire des ressources à partir du web.

  • Ajout de httpResponse, qui contient les méthodes permettant d’accéder au contenu de la ressource récupérée.

  • Ajout de la rubrique Limites UrlFetch , qui répertorie les limites pour l’extraction des ressources à partir du web.

Ajoutez les rubriques suivantes :

2 octobre 2018

Ajout des objets et méthodes suivants pour prendre en charge plusieurs comptes.

  • Ajout de la currentAccount méthode à BingAdsApp. Utilisez cette méthode pour obtenir l’objet Account , qui contient des informations sur le compte que le script traite actuellement.

  • Ajout de l’objet AccountsApp . Il s’agit de l’objet de niveau supérieur que vous utilisez si vous gérez des comptes pour d’autres personnes. Utilisez-le pour obtenir la liste des comptes auxquels vous avez accès et pour sélectionner le compte à gérer.

  • Ajout de l’objet BingAdsAccount . Utilisez-le pour obtenir des informations de compte pour un compte géré, telles que le nom, l’ID client et les données de performances au niveau du compte.

  • Ajout de l’objet BingAdsAccountIterator . Utilisez-le pour itérer dans la liste des comptes managés que vous avez sélectionnés.

  • Ajout de l’objet BingAdsAccountSelector . Utilisez-la pour sélectionner la liste des comptes gérés que vous souhaitez obtenir.

  • Ajout de l’objet BingAdsAccountStats . Utilisez-la pour accéder aux données de performances du compte managé.

  • Ajout de l’objet ExecutionResult . Utilisez-la pour obtenir les résultats et la valeur de retour de la fonction que vous spécifiez dans la executeInParallel méthode de sélecteur (voir BingAdsAccountSelector).

Ajout des champs suivants à l’objet Budget pour prendre en charge les budgets partagés.

  • campaigns : obtient un sélecteur qui retourne toutes les campagnes qui partagent ce budget.
  • getEntityType : obtient le type de l’objet.
  • getId : obtient l’ID qui identifie de façon unique le budget partagé.
  • getName : obtient le nom du budget partagé.
  • getStats : obtient les données de performances des campagnes qui partagent ce budget.
  • getType : obtient le type du budget (par exemple, DAILY).
  • isExplicitlyShared : obtient une valeur booléenne qui indique si ce budget est un budget partagé.

Les getIdméthodes , getNameet getStats retournent des données uniquement pour les budgets partagés ; les getId méthodes et getName retournent null pour les budgets non partagés (campagnes individuelles).

Ajout du champ suivant à l’objet BingAdsApp .

  • budgets : obtient tous les budgets partagés dans le compte. Utilisez le sélecteur pour filtrer la liste des budgets partagés.

Ajout des objets suivants que vous utilisez pour filtrer et parcourir en boucle une liste de budgets partagés.

  • BudgetSelector : contient les méthodes de filtrage et de classement de la liste des budgets partagés.

  • BudgetIterator : contient les méthodes permettant de parcourir en boucle la liste des budgets partagés. La méthode du get sélecteur retourne l’itérateur.

Le sélecteur retourne uniquement les budgets partagés, il n’inclut pas les budgets non partagés (campagnes individuelles). Pour déterminer si une campagne utilise un budget individuel, obtenez le budget en appelant la méthode de getBudget la campagne. Ensuite, appelez la méthode du isExplicitlyShared budget pour déterminer si le budget est partagé. Le budget est partagé si isExplicitlyShared retourne true.

lundi 1 octobre 2018

Ajout de la méthode suivante à l’objet Keyword .

  • getQualityScore : obtient le score de qualité de l’mot clé. Le score se situe entre 1 et 10 (le plus élevé). Le score vous montre à quel point vos annonces sont compétitives sur la place de marché en mesurant la pertinence de vos mots clés et pages d’accueil par rapport aux termes de recherche des clients.

12 septembre 2018

Ajout des méthodes suivantes pour obtenir les entités parent et enfant d’une entité.

  • AdGroup.getCampaign : obtient la campagne à laquelle appartient le groupe d’annonces.
  • AdGroup.keywords : obtient un sélecteur utilisé pour filtrer la liste de mots clés du groupe d’annonces.
  • AdParam.getAdGroup : obtient le groupe d’annonces auquel appartient le mot clé associé à ce paramètre de substitution.
  • AdParam.getKeyword : obtient le mot clé auquel s’applique le paramètre de substitution.
  • Campaign.adGroups : obtient un sélecteur utilisé pour filtrer la liste des groupes d’annonces de la campagne.
  • Campaign.keywords : obtient un sélecteur utilisé pour filtrer la liste de mots clés de la campagne.
  • Keyword.getCampaign : obtient la campagne à laquelle appartient le mot clé.
  • Keyword.getAdGroup : obtient le groupe d’annonces auquel appartient le mot clé.
  • NegativeKeywordList.campaigns : obtient un sélecteur utilisé pour filtrer la liste des campagnes auxquelles la liste de mot clé négatives est associée.

9 septembre 2018

Ajout de la prise en charge des publicités.

  • Ajout de la newAd méthode à AdGroup. La méthode renvoie un objet AdBuilderSpace , que vous utilisez pour obtenir un générateur d’annonces.

  • Ajout de l’objet AdBuilderSpace . L’objet contient des méthodes permettant d’obtenir des générateurs d’annonces. Par exemple, si vous souhaitez créer une annonce de texte développé, vous devez appeler la méthode de expandedTextAdBuilder l’objet pour obtenir l’objet ExpandedTextAdBuilder .

  • Ajout de l’objet ExpandedTextAdBuilder , que vous utilisez pour ajouter une annonce de texte développé au groupe d’annonces.

  • Ajout de l’objet AdOperation , que vous utilisez pour déterminer si Scripts a correctement ajouté l’annonce.

  • Ajout de l’objet AdViewSpace , qui contient les méthodes utilisées pour convertir une publicité en un type spécifique. Par exemple, caster l’objet d’annonce de base en une annonce de texte développée.

  • Ajout de l’objet AdTypeSpace , qui contient les méthodes utilisées pour tester si une annonce est du type spécifié. Par exemple, pour tester si l’annonce est une annonce de texte développée.

  • Ajout de l’objet Ad , qui est le type d’annonce de base. Il définit également une annonce de texte.

  • Ajout de l’objet AdUrls , qui contient les méthodes permettant d’obtenir les URL, le modèle de suivi et les paramètres personnalisés de l’annonce.

  • Ajout de l’objet ExpandedTextAd , qui définit une annonce de texte développé.

  • Ajout de l’objet AdSelector , que vous utilisez pour spécifier les critères de filtre pour la sélection des publicités.

  • Ajout de l’objet AdIterator , que vous utilisez pour itérer dans la liste filtrée des annonces.

  • Ajout de la ads méthode à BingAdsApp. La méthode renvoie l’objet AdSelector , que vous utilisez pour spécifier les critères de filtre pour sélectionner des publicités dans le compte.

  • Ajout de la ads méthode à AdGroup. La méthode renvoie l’objet AdSelector , que vous utilisez pour spécifier les critères de filtre pour la sélection des annonces dans le groupe d’annonces.

  • Ajout de la ads méthode à Campaign. La méthode renvoie l’objet AdSelector , que vous utilisez pour spécifier les critères de filtre permettant de sélectionner des publicités dans la campagne.

15 juin 2018

Version bêta fermée. Cette version de Microsoft Advertising Scripts est disponible uniquement pour certains participants. Pour plus d’informations sur la participation au programme de mise en production en préversion, contactez votre responsable de compte. Les classes et la documentation Scripts sont susceptibles d’être modifiées.

Cette version initiale comprend les fonctionnalités suivantes :

  • Gestion des campagnes principales (campagnes, groupes d’annonces, mots clés)
  • Données de performances au niveau de l’entité (campagnes, groupes d’annonces, mots clés)
  • Listes de mots clés négatifs partagés