Notes de version

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

Dernière version de l'API: v3

23 avril 2024

Nouvelles fonctionnalités

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

v3

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

    RessourceChamp(s)
    Kpi

    kpiAlgorithmId

  • Les valeurs d'énumération 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.

Il est désormais possible 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 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 des 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 bêta publique de v3 vers la disponibilité générale.

Changement de nom pour une valeur d'énumération AdGroupFormat dans la version 3 pour refléter plus précisément le format concerné.

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 d'énumération suivantes ont été ajoutées:

    EnumValeur(s)
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

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

    EnumValeur(s)
    SdfVersion

    SDF_VERSION_7

2 octobre 2023

Nouvelles fonctionnalités

Lancement de la version 3 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 YoutubeAndPartnersBiddingStrategyType et d'une nouvelle PartnerCostType dans les versions 2 et 3.

v3

v2

  • Les valeurs d'énumération 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 compatibilité avec deux places de marché et deux nouveaux types de stratégies d'enchères YouTube et partenaires.

Ajout d'un champ effectiveContentCategory aux éléments de campagne YouTube et partenaires pour afficher la valeur YoutubeAndPartnersContentCategory utilisée par l'élément de campagne en ce qui concerne les valeurs attribuées 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 d'énumération suivantes ont été ajoutées:

    EnumValeur(s)
    SdfVersion

    SDF_VERSION_6

v1

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

    EnumValeur(s)
    SdfVersion

    SDF_VERSION_6

9 mars 2023

Nouvelles fonctionnalités

Ajout d'une 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 abandonné et défini sur false après le 25 mars 2023.

v2

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

    EnumValeur(s)
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • Les valeurs d'énumération 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 du 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 nouvelle page de guide sur la récupération des ressources YouTube et partenaires.

Ajout de la compatibilité avec quatre places de marché supplémentaires dans les versions 1 et 2.

v2

v1

  • Les valeurs d'énumération 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 bêta publique de v2 vers la 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 aux types de ciblage attribués via une énumération. La valeur alias est la valeur d'énumération pertinente sous forme de chaîne.

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

Ajout de la possibilité 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 maximale de page à 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 corrige les problèmes connus suivants dans la version 2:

27 octobre 2022

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

Introduction de la prise en charge partielle du ciblage par ordre d'insertion 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 version 1.

20 septembre 2022

Lancement de la version 2 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.

Ajout de la prise en charge de trois nouvelles places de marché dans la version 1.

Nouvelles fonctionnalités

v2

Voici une liste des modifications apportées entre les versions v1 et v2:

v1

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

    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 du service inventorySources et un nouveau service guaranteedOrders.

Introduction du champ modelReadiness dans la ressource CustomBiddingAlgorithm. Ce champ indique si le modèle d'algorithme est prêt 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 un updateTime avant ou après un horodatage donné.

Ajout de la prise en charge de 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

Ajout de la possibilité 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, ce qui permet aux utilisateurs de déterminer si la stratégie d'enchères applique les prix planchers de l'annonceur pour les 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 de 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 indique si une ressource est de type "Tag garanti", "Programmatique garanti" ou "Non garanti".

Un nouveau champ excludeNewExchanges permet désormais de récupérer et de déterminer si un élément de campagne cible automatiquement les nouvelles places de marché.

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. Elle décrit le processus de création d'un algorithme d'enchères personnalisées, d'importation d'un script et d'attribution de l'algorithme d'enchères personnalisées en tant que stratégie d'enchères pour un élément de campagne.

Ajout de la prise en charge de 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 via les méthodes targetingTypes.targetingOptions.get ou targetingTypes.targetingOptions.list.

Introduction de nouveaux champs sharedAdvertiserIds et customBiddingAlgorithmState dans la ressource d'algorithme d'enchères personnalisées, et compatibilité avec le type d'algorithme d'enchères personnalisées GOAL_BUILDER_BASED.

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

Nouvelles fonctionnalités

4 août 2021

Ajout de la compatibilité avec le ciblage de l'inventaire activé pour Open Measurement pour 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 de différentes méthodes de liste d'options de ciblage attribuées par annonceur, campagne, ordre d'insertion et élément 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 pour 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 par position du contenu natif sous le nouveau type de ciblage TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Introduction d'un champ prismaEnabled dans la ressource annonceur, ce qui permet 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 la ressource pour le ciblage. Activation de nouvelles propriétés filter pour la méthode de liste d'éléments de campagne, qui permettent à l'utilisateur de ne récupérer que les éléments de campagne qui utilisent des canaux spécifiques ou des listes de mots clés à exclure dans leur ciblage.

Nouvelles fonctionnalités

30 mars 2021

Ajout d'une nouvelle méthode au service d'éléments 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é à l'ordre d'insertion parent.

Activation de la récupération du ciblage des campagnes via un nouveau service de ciblage des campagnes et une méthode supplémentaire de liste groupée.

Développement du ciblage des applications pour permettre le ciblage des applications sur plus de plates-formes.

Plusieurs modifications ont été apportées aux services advertisers.channels.sites, partners.channels.sites et advertisers.negativeKeywordLists.negativeKeywords pour faciliter la gestion du contenu de la chaîne et des listes de mots clés à exclure. Ces modifications incluent:

  • Ajout de méthodes replace, qui permettent à un utilisateur d'écraser complètement le contenu existant d'un canal 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 demandes de modification groupée.
  • Augmentation du nombre maximal d'éléments pouvant être affichés sur une seule page d'une réponse 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 de liste groupée supplémentaire permettant de récupérer le ciblage attribué aux ordres d'insertion. Développement de la ressource de création, ajout de champs de création de 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

Activation de la récupération et de la gestion des ordres d'insertion TV et des é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 pour applications mobiles via un champ d'élément de campagne mobileApp. Prise en charge étendue de places de marché, d'audiences Google et de SDF grâce à des valeurs d'énumération supplémentaires. Introduction de la possibilité de filtrer et d'organiser les valeurs advertisers.list selon l'heure de la dernière mise à jour.

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 actualisation. 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 lancent 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'élargir 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 dans la ressource d'élément de campagne et d'un type d'objectif de performances basé sur le taux de clics (CTR). Ajout de warningMessages en tant que champ filtrable lors de la liste des éléments de campagne.

En plus des nouvelles fonctionnalités, de nouvelles limites de quota sont maintenant 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 des partenaires et de ciblage des partenaires Introduction d'outils pour aider les utilisateurs à éviter de manière proactive d'atteindre les limites d'entités de compte. Nous avons ajouté la compatibilité avec les éléments de campagne audio et l'utilisation d'algorithmes d'enchères personnalisées dans les stratégies d'enchères d'éléments de campagne et d'ordre d'insertion.

Nouvelles fonctionnalités

24 juin 2020

Lancement d'une petite mise à jour ajoutant une méthode de création pour les canaux partenaire et annonceur, de nouveaux champs FirstAndThirdPartyAudience et des valeurs d'énumération Exchange supplémentaires.

Nouvelles fonctionnalités

2 juin 2020

Vous pouvez désormais créer, corriger et renseigner un sous-ensemble d'entités pouvant être ciblées, et modifier le ciblage au niveau de l'annonceur pour trois types de ciblage: canal, 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, élargissant 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éthode(s)
annonceurs

Créer

supprimer

obtenir

liste

correctif

advertisers.assets

importer

advertisers.campaigns

Créer

supprimer

obtenir

liste

correctif

advertisers.channels

obtenir

liste

advertisers.creatives

Créer

supprimer

obtenir

liste

correctif

advertisers.insertionOrders

Créer

supprimer

obtenir

liste

correctif

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

Créer

supprimer

obtenir

liste

correctif

advertisers.lineItems.targetingTypes.assignedTargetingOptions

Créer

supprimer

obtenir

liste

advertisers.locationLists

obtenir

liste

advertisers.negativeKeywordLists

obtenir

liste

combinedAudiences

obtenir

liste

customLists

obtenir

liste

firstAndThirdPartyAudiences

obtenir

liste

floodlightGroups

obtenir

correctif

googleAudiences

obtenir

liste

inventorySourceGroups

obtenir

liste

inventorySources

obtenir

liste

partners.channels

obtenir

liste

partners.channels

obtenir

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