Notes de version

Cette page fournit les notes de version de l'API Display & Video 360.

Dernière version de l'API: v3

17 juin 2024

Nouvelles fonctionnalités

Il est désormais possible de gérer le ciblage par mots clés attribué au niveau de l'annonceur.

Ajout d'un nouveau champ optimizationObjective à la ressource d'ordre d'insertion. optimizationObjective n'est disponible que pour les clients figurant sur la liste d'autorisation.

v3

v2

30 mai 2024

Nouvelles fonctionnalités

Ajout de la compatibilité avec les fichiers de données structurées (SDF) version 7.1.

v3

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    SdfVersion

    SDF_VERSION_7_1

v2

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    SdfVersion

    SDF_VERSION_7_1

23 avril 2024

Nouvelles fonctionnalités

Ajout de la prise en charge de nouveaux types de KPI, places de marché et plates-formes applicatives.

v3

  • Les champs suivants ont été ajoutés:

    RessourceChamp(s)
    KPI

    kpiAlgorithmId

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV

    Place de marché

    EXCHANGE_DRAX

    KpiType

    KPI_TYPE_CPCL

    KPI_TYPE_CPCV

    KPI_TYPE_CPV

    KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST

    KPI_TYPE_MAXIMIZE_PACING

    KPI_TYPE_TOS10

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

28 février 2024

Nouvelles fonctionnalités

Il est désormais possible de supprimer explicitement des membres des audiences de ciblage par liste de clients.

Ajout de la possibilité de cibler de nouvelles places de marché.

v3

v2

29 janvier 2024

Nouvelles fonctionnalités

Ajout de la possibilité de récupérer des activités Floodlight via un nouveau service floodlightGroups.floodlightActivities.

Ajout d'un champ indiquant si un élément de campagne YouTube et partenaires inclut l'inventaire Google TV dans son ciblage.

Ajout d'un champ permettant de relayer la dernière heure de connexion d'un utilisateur de Display & Video 360.

v3

v2

14 novembre 2023

Nouvelles fonctionnalités

Ajout de la possibilité de transmettre le consentement de l'utilisateur final lors de l'importation de membres de l'audience de ciblage par liste de clients dans toutes les versions actives.

v3

v2

31 octobre 2023

Nouvelles fonctionnalités

Abandon de la version v3 de la version bêta publique pour la mettre en disponibilité générale.

Valeur d'énumération AdGroupFormat renommée dans la version 3 pour refléter plus précisément le format approprié.

Ajout de la compatibilité avec les fichiers de données structurées v7 avec l'ajout de la valeur d'énumération SDF_VERSION_7 dans les versions 2 et 3.

v3

  • Les valeurs d'énumération suivantes ont été supprimées:

    EnumValeur(s)
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    SdfVersion

    SDF_VERSION_7

2 octobre 2023

Nouvelles fonctionnalités

Publication de la v3 en version bêta publique, avec les modifications suivantes:

Suivez la procédure décrite dans notre guide de migration pour passer de la v2 à la v3.

Ajout de la prise en charge de trois nouvelles valeurs LineItemType, d'une nouvelle valeur YoutubeAndPartnersBiddingStrategyType et d'une nouvelle valeur PartnerCostType dans les versions 2 et 3.

v3

v2

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    LineItemType

    LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

    LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

    PartnerCostType

    PARTNER_COST_TYPE_SCIBIDS_FEE

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

15 août 2023

Nouvelles fonctionnalités

Ajout de la prise en charge de deux places de marché et de deux nouveaux types de stratégies d'enchères YouTube et partenaires.

Ajout d'un nouveau champ effectiveContentCategory aux éléments de campagne YouTube et partenaires pour afficher le YoutubeAndPartnersContentCategory utilisé par l'élément de campagne lorsque vous examinez les valeurs attribuées à la fois au niveau de l'annonceur et de l'élément de campagne.

v2

5 juin 2023

Nouvelles fonctionnalités

Ajout d'une valeur SdfVersion pour les fichiers de données structurées (SDF) v6 dans les versions 1 et 2.

v2

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    SdfVersion

    SDF_VERSION_6

v1

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    SdfVersion

    SDF_VERSION_6

9 mars 2023

Nouvelles fonctionnalités

Ajout d'une nouvelle valeur LineItemWarningMessage qui sera attribuée au champ warningMessages d'un élément de campagne si le champ obsolète excludeFirstPartyAudience est défini sur true. Le champ excludeFirstPartyAudience sera arrêté et défini sur false après le 25 mars 2023.

v2

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 février 2023

Nouvelles fonctionnalités

Ajout de la possibilité de récupérer les ressources YouTubeAdGroup et YouTubeAdGroupAd, ainsi que le ciblage des ressources du groupe d'annonces YouTube. Nous avons également ajouté de nouveaux types de ciblage récupérables, utilisés au niveau des groupes d'annonces YouTube. Pour en savoir plus, consultez notre nouveau guide sur la récupération de ressources YouTube et partenaires.

Ajout de la prise en charge de quatre places de marché supplémentaires dans les versions 1 et 2.

v2

v1

  • Les valeurs enum suivantes ont été ajoutées:

    EnumValeur(s)
    Place de marché

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 décembre 2022

Nouvelles fonctionnalités

Abandon de la version 2 de la version bêta publique pour la mettre en disponibilité générale.

Ajout d'un nouveau champ assignedTargetingOptionIdAlias à la ressource AssignedTargetingOption, qui peut être utilisé à la place de assignedTargetingOptionId lors de la récupération et de la suppression du ciblage. Ce champ n'est défini que pour les options de ciblage attribuées pour les types de ciblage attribués via une énumération. La valeur de l'alias est la valeur d'énumération correspondante sous forme de chaîne.

Ajout d'un nouveau champ billingConfig à la ressource Advertiser.

Il est désormais possible de récupérer les éléments de campagne de type "Service de distribution par contournement" YouTube et partenaires, identifiés par trois nouvelles valeurs LineItemType.

Augmentation de la taille de page maximale à 200 pour de nombreuses méthodes list dans les versions 1 et 2. La taille de page par défaut reste inchangée.

v2

v1

Problèmes connus

Cette mise à jour résout les problèmes connus suivants dans la v2:

27 octobre 2022

Ajout de la possibilité de dupliquer un élément de campagne existant dans le InsertionOrder parent.

Introduction de la prise en charge d'écriture pour le ciblage d'ordre d'insertion partiel pour un sous-ensemble de types de ciblage avec l'ajout des méthodes create et delete au service advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Nouvelles fonctionnalités

v2

v1

Aucune nouvelle fonctionnalité n'a été ajoutée à la v1.

20 septembre 2022

Publication de la v2 en version bêta publique, avec les modifications suivantes:

Suivez la procédure décrite dans notre guide de migration pour passer de la version 1 à la version 2.

Dans la version 1, trois nouvelles places de marché sont maintenant compatibles.

Nouvelles fonctionnalités

v2

Voici la liste des modifications apportées entre la v1 et la v2:

v1

  • Les valeurs d'énumération suivantes ont été ajoutées dans la version 1:

    EnumValeur(s)
    Place de marché

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 mai 2022

Ajout de la possibilité de créer des ressources InventorySource et de gérer des ressources GuaranteedOrder via de nouvelles méthodes d'écriture pour le service inventorySources et un nouveau service guaranteedOrders.

Introduction du champ modelReadiness dans la ressource CustomBiddingAlgorithm. Ce champ indique l'état de préparation du modèle de l'algorithme pour chaque annonceur qui peut y accéder.

Activation d'une nouvelle fonctionnalité de paramètre de requête filter pour la méthode advertisers.creatives.list, qui permet à l'utilisateur de ne récupérer que les créations avec une updateTime avant ou après un horodatage donné.

Ajout de la compatibilité avec la dernière version des fichiers SDF, v5.5, via l'ajout d'une valeur d'énumération SdfVersion.

Nouvelles fonctionnalités

31 mars 2022

Il est désormais possible de récupérer et de définir le ciblage en fonction de la durée du contenu, du type de flux et du genre.

Ajout du champ billableOutcome à l'objet InsertionOrder.

Introduction du champ raiseBidForDeals à l'objet MaximizeSpendBidStrategy, permettant aux utilisateurs de définir si la stratégie d'enchères applique des prix planchers d'annonceur aux accords ciblés.

Nouvelles fonctionnalités

2 février 2022

Ajout de la possibilité de créer, mettre à jour et modifier les membres de certaines ressources FirstAndThirdPartyAudience pour le ciblage par liste de clients. La page Importer des audiences de ciblage par liste de clients de notre nouveau guide Utiliser les audiences explique comment utiliser ces nouvelles fonctionnalités.

Introduction d'un nouveau champ reservationType dans les ressources InsertionOrder et LineItem qui détermine si une ressource est associée à un libellé "Tag garanti", "Programmatique garanti" ou "Non garanti".

Ajout de la possibilité de récupérer un élément de campagne et de définir si celui-ci cible automatiquement les nouvelles places de marché à l'aide d'un nouveau champ excludeNewExchanges.

En plus des nouvelles fonctionnalités, les limites de quota par défaut ont été doublées.

Nouvelles fonctionnalités

8 décembre 2021

Ajout de la prise en charge du ciblage par type de contenu audio sous le type de ciblage TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Nouvelles fonctionnalités

8 novembre 2021

Ajout d'une compatibilité totale avec la gestion des algorithmes d'enchères personnalisées et de leurs scripts. Par exemple :

Une nouvelle page Implémenter les enchères personnalisées a été ajoutée à notre guide Gérer les éléments de campagne. Il explique comment créer un algorithme d'enchères personnalisées, importer un script et définir l'algorithme d'enchères personnalisées comme stratégie d'enchères d'un élément de campagne.

Ajout de la compatibilité avec la dernière version des fichiers SDF, v5.4, via l'ajout d'une valeur d'énumération SdfVersion.

Nouvelles fonctionnalités

14 septembre 2021

Ajout de la prise en charge du ciblage de proximité sous les types de ciblage TARGETING_TYPE_BUSINESS_CHAIN et TARGETING_TYPE_POI.

Ajout de la possibilité de rechercher les options de ciblage TARGETING_TYPE_BUSINESS_CHAIN et TARGETING_TYPE_POI disponibles à l'aide de targetingTypes.targetingOptions.search, car elles ne peuvent pas être récupérées à l'aide des méthodes targetingTypes.targetingOptions.get ou targetingTypes.targetingOptions.list.

Introduction de nouveaux champs sharedAdvertiserIds et customBiddingAlgorithmState à la ressource Algorithme d'enchères personnalisées, et prise en charge du type d'algorithme d'enchères personnalisées GOAL_BUILDER_BASED.

Ajout de deux nouvelles valeurs à l'énumération Exchange.

Nouvelles fonctionnalités

4 août 2021

Ajout de la compatibilité avec le ciblage d'inventaire activé pour Open Measurement sous le type de ciblage TARGETING_TYPE_OMID.

Augmentation du nombre maximal d'options de ciblage attribuées pouvant être renvoyées sur une seule page pour différentes méthodes de liste d'options de ciblage attribuées à des annonceurs, des campagnes, des ordres d'insertion et des éléments de campagne à l'aide du paramètre de méthode pageSize.

Nouvelles fonctionnalités

26 mai 2021

Lancement du service advertisers.invoices, qui permet aux utilisateurs:

  • récupérer les factures émises à un annonceur au cours d'un mois donné.
  • rechercher le code de devise utilisé par un annonceur au cours d'un mois donné

Ajout du champ campaignBudgets à la ressource de campagne. Les segments de budget d'ordre d'insertion peuvent être associés à un budget de campagne, ce qui limite le budget total des segments associés au montant total du budget de la campagne.

Ajout de la compatibilité avec le ciblage de la position du contenu natif sous le nouveau type de ciblage TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Introduction d'un nouveau champ prismaEnabled à la ressource annonceur, permettant aux utilisateurs d'activer l'intégration à l'outil Prisma de Mediaocean.

Activation de la prise en charge de la valeur d'énumération ENTITY_STATUS_PAUSED dans le champ entityStatus de l'annonceur.

Nouvelles fonctionnalités

29 avril 2021

Ajout de champs aux ressources Canal et Liste de mots clés à exclure qui renvoient le nombre d'éléments de campagne utilisant cette ressource pour le ciblage. Activation de nouvelles propriétés filter pour la méthode de la liste d'éléments de campagne, qui permettent à l'utilisateur de ne récupérer que des éléments de campagne qui utilisent des critères ou des listes de mots clés à exclure spécifiques dans leur ciblage.

Nouvelles fonctionnalités

30 mars 2021

Ajout d'une méthode au service d'élément de campagne qui génère un élément de campagne avec des configurations par défaut. Ces valeurs par défaut sont basées sur le type d'élément de campagne donné, ainsi que sur les paramètres et le ciblage attribué de l'ordre d'insertion parent.

Permet de récupérer le ciblage des campagnes à l'aide d'un nouveau service de ciblage des campagnes et d'une méthode supplémentaire de listes groupées.

Ciblage des applications étendu pour permettre le ciblage d'applications sur un plus grand nombre de plates-formes.

Nous avons apporté plusieurs modifications aux services advertisers.channels.sites, partners.channels.sites et advertisers.negativeKeywordLists.negativeKeywords pour faciliter la gestion du contenu des chaînes et des listes de mots clés à exclure. Voici quelques-unes de ces modifications:

  • L'ajout des méthodes replace, qui permet à un utilisateur d'écraser complètement le contenu existant d'une chaîne ou d'une liste de mots clés à exclure
  • Suppression de l'obligation d'inclure aucun élément existant dans les champs createdSites ou createdNegativeKeywords des requêtes de modification groupée.
  • Augmentation du nombre maximal d'éléments pouvant être renvoyés sur une seule page d'une réponse sous forme de liste de sites ou de mots clés à exclure.

Nouvelles fonctionnalités

Abandons

24 février 2021

Introduction d'un nouveau service de ciblage des ordres d'insertion et d'une méthode supplémentaire de listes groupées permettant de récupérer le ciblage attribué aux ordres d'insertion. Extension de la ressource de création, en ajoutant des champs de création en sortie uniquement pour les créations audio tierces. Ajout de nouveaux types d'objectifs de performances à utiliser par les ressources d'ordre d'insertion et de campagne.

Nouvelles fonctionnalités

27 janvier 2021

Il est désormais possible de récupérer et de gérer les ordres d'insertion de type télévision et les éléments de campagne de type "Service de distribution par contournement" grâce à l'introduction d'un nouveau champ InsertionOrderType et d'une nouvelle valeur d'énumération LineItemType. Ajout de la compatibilité avec les éléments de campagne d'applications mobiles via un champ d'élément de campagne mobileApp. Prise en charge étendue de la place de marché, de l'audience Google et des SDF via des valeurs d'énumération supplémentaires. Introduction de la possibilité de filtrer et de classer les valeurs advertisers.list selon la dernière actualisation.

Nouvelles fonctionnalités

4 décembre 2020

Ajout de la possibilité de rechercher des options de ciblage par région géographique et de filtrer les résultats de plusieurs méthodes de liste de ressources par date de dernière mise à jour. Introduction d'un nouveau LineItemWarningMessage pour informer les utilisateurs lorsqu'un élément de campagne utilise un ciblage géographique obsolète.

Nouvelles fonctionnalités

5 novembre 2020

Ajout de la possibilité de créer, d'attribuer et d'activer des déclencheurs manuels qui déclenchent les dépenses des éléments de campagne associés. Introduction d'options d'élargissement du ciblage qui, lorsqu'elles sont définies, permettent d'étendre le ciblage d'un élément de campagne afin d'inclure des utilisateurs semblables à ceux des audiences ciblées. Ajout de champs d'ID de segment personnalisé aux objets DoubleVerify et Integral Ad Science utilisés dans le ciblage par validation tierce.

Nouvelles fonctionnalités

12 octobre 2020

Introduction de messages d'avertissement récupérables à la ressource d'élément de campagne et d'un type d'objectif de performances en termes de taux de clics (CTR). Ajout de warningMessages comme champ filtrable lors de la création d'une liste des éléments de campagne.

Outre les nouvelles fonctionnalités, de nouvelles limites de quota sont désormais en vigueur, et une nouvelle documentation sur l'utilisation des requêtes par lot est disponible.

Nouvelles fonctionnalités

28 août 2020

Ajout de champs à la réponse de la méthode d'audit des annonceurs et de nouveaux champs filtrables à différentes méthodes de liste.

Nouvelles fonctionnalités

4 août 2020

Lancement de nouveaux services de gestion des utilisateurs, de ciblage par les partenaires et de ciblage par les partenaires. Introduction d'outils pour aider les utilisateurs à éviter de manière proactive d'atteindre les limites d'entités de compte. Ajout de la compatibilité avec les éléments de campagne audio, et de l'utilisation d'algorithmes d'enchères personnalisées dans les stratégies d'enchères pour les éléments de campagne et les ordres d'insertion.

Nouvelles fonctionnalités

24 juin 2020

Lancement d'une petite mise à jour permettant d'ajouter une méthode de création pour les catégories partner et advertiser, de nouveaux champs FirstAndThirdPartyAudience et des valeurs d'énumération Exchange supplémentaires.

Nouvelles fonctionnalités

2 juin 2020

Ajout de la possibilité de créer, corriger et renseigner un sous-ensemble d'entités pouvant être ciblées, et possibilité de modifier le ciblage au niveau de l'annonceur pour trois types de ciblage: catégorie, exclusion de libellés de contenu numérique et exclusion de catégories sensibles.

Nouvelles fonctionnalités

27 avril 2020

Lancement d'un vaste ensemble de fonctionnalités, étendant le champ d'application de l'API au-delà des fichiers SDF. Ajout de la gestion des ressources principales, qui vous permet de créer, récupérer, mettre à jour et supprimer des entités telles que des annonceurs, des campagnes, des ordres d'insertion, des éléments de campagne et des créations. De nouvelles fonctionnalités permettent également de modifier le ciblage au niveau de l'élément de campagne.

Nouvelles fonctionnalités

Les services suivants ont été ajoutés:

ServiceMéthodes
annonceurs

créer

supprimer

get

liste

patch

advertisers.assets

importer

advertisers.campaigns

créer

supprimer

get

liste

patch

advertisers.channels

get

liste

advertisers.creatives

créer

supprimer

get

liste

patch

advertisers.insertionOrders

créer

supprimer

get

liste

patch

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

créer

supprimer

get

liste

patch

advertisers.lineItems.targetingTypes.assignedTargetingOptions

créer

supprimer

get

liste

advertisers.locationLists

get

liste

advertisers.negativeKeywordLists

get

liste

combinedAudiences

get

liste

customLists

get

liste

firstAndThirdPartyAudiences

get

liste

floodlightGroups

get

patch

googleAudiences

get

liste

inventorySourceGroups

get

liste

inventorySources

get

liste

partners.channels

get

liste

partners.channels

get

liste

9 mars 2020

Lancement de la version 1 de l'API Display & Video 360. Il s'agit de la version initiale de l'API.

Problèmes connus

Aucune