Notes de version

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

Dernière version de l'API: v3

4 décembre 2024

Nouvelles fonctionnalités

Compatibilité avec les valeurs Exchange Core et Tubi.

Augmentation de la taille de page maximale autorisée pour firstAndThirdPartyAudiences.list de 200 à 5000. Modifiez le paramètre pageSize de vos requêtes firstAndThirdPartyAudiences.list pour optimiser davantage l'utilisation de votre quota.

v3

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

    ÉnumérationValeur(s)
    Exchange

    EXCHANGE_CORE

    EXCHANGE_TUBI

  • La taille maximale de page a été augmentée pour les méthodes de liste suivantes:

    MéthodeNouvelle taille maximale de page
    firstAndThirdPartyAudiences.list 5000

22 octobre 2024

Nouvelles fonctionnalités

Ajout de la prise en charge de l'objectif de performances "Coût par vue".

Possibilité de définir et de récupérer le ciblage des appareils connectés.

Ajout de nouveaux paramètres de brand safety Adloox sous Ciblage de vérificateurs tiers.

Ajout de la possibilité de télécharger des fichiers de données structurées v8, qui sont actuellement en version bêta fermée.

v3

Valeurs obsolètes

Suppression de la compatibilité avec la version 5.5 de SDF, car elle sera abandonnée le 3 octobre 2024.

v3

  • Les valeurs d'énumération suivantes sont obsolètes:

    ÉnumérationValeur(s)
    SdfVersion

    SDF_VERSION_5_5

15 août 2024

Nouvelles fonctionnalités

Ajout de la compatibilité avec le type Exchange de Netflix.

v3

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

    ÉnumérationValeur(s)
    Place de marché

    EXCHANGE_NETFLIX

v2

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

    ÉnumérationValeur(s)
    Place de marché

    EXCHANGE_NETFLIX

15 juillet 2024

Nouvelles fonctionnalités

Ajout de la possibilité de télécharger des fichiers de données structurées pour les éléments de campagne et les groupes d'annonces au format QA dans la version 3.

v3

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

    RessourceChamp(s)
    IdFilter

    adGroupQaIds

    lineItemQaIds

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

    ÉnumérationValeur(s)
    FileType

    FILE_TYPE_AD_GROUP_QA

    FILE_TYPE_LINE_ITEM_QA

17 juin 2024

Nouvelles fonctionnalités

Vous pouvez désormais 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 la version 7.1 des fichiers de données structurées (SDF).

v3

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

    ÉnumérationValeur(s)
    SdfVersion

    SDF_VERSION_7_1

v2

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

    ÉnumérationValeur(s)
    SdfVersion

    SDF_VERSION_7_1

23 avril 2024

Nouvelles fonctionnalités

Ajout de la compatibilité avec de nouveaux types de KPI, de places de marché et de plates-formes d'applications.

v3

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

    RessourceChamp(s)
    KPI

    kpiAlgorithmId

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

    ÉnumérationValeur(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

Vous pouvez désormais supprimer explicitement des membres des audiences de ciblage par liste de clients.

Possibilité de cibler de nouvelles places de marché.

v3

v2

29 janvier 2024

Nouvelles fonctionnalités

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

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

Ajout d'un champ pour transmettre 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 en ligne.

v3

v2

31 octobre 2023

Nouvelles fonctionnalités

La version 3 est passée de la version bêta publique à la disponibilité générale.

Modification du nom d'une valeur d'énumération AdGroupFormat dans la version 3 afin de refléter plus précisément le format approprié.

Ajout de la compatibilité avec la version 7 des fichiers de données structurées 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:

    ÉnumérationValeur(s)
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

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

    ÉnumérationValeur(s)
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE
    SdfVersion

    SDF_VERSION_7

v2

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

    ÉnumérationValeur(s)
    SdfVersion

    SDF_VERSION_7

2 octobre 2023

Nouvelles fonctionnalités

Version 3 publiée 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 2 à la version 3.

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

v3

v2

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

    ÉnumérationValeur(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

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 les YoutubeAndPartnersContentCategory utilisés par l'élément de campagne lorsque vous tenez compte des 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 nouvelle 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:

    ÉnumérationValeur(s)
    SdfVersion

    SDF_VERSION_6

v1

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

    ÉnumérationValeur(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 article de ligne 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 enum suivantes ont été ajoutées:

    ÉnumérationValeur(s)
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

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

    ÉnumérationValeur(s)
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 février 2023

Nouvelles fonctionnalités

Possibilité de récupérer des ressources YouTubeAdGroup et YouTubeAdGroupAd, ainsi que le ciblage des ressources de groupe d'annonces YouTube. De plus, nous avons 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 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:

    ÉnumérationValeur(s)
    Place de marché

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 décembre 2022

Nouvelles fonctionnalités

La version 2 est passée de la version bêta publique à 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 des types de ciblage attribués via un énumération. La valeur de l'alias correspond à la valeur de l'énumération appropriée sous forme de chaîne.

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

Prise en charge de la récupération des éléments de campagne YouTube et partenaires OTT, 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 résout les problèmes connus suivants dans la version 2:

27 octobre 2022

Possibilité de dupliquer un élément de campagne existant dans l'élément parent InsertionOrder.

Prise en charge de l'écriture du ciblage par 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 version 1.

20 septembre 2022

Version 2 publiée 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 trois nouvelles places de marché dans la version 1.

Nouvelles fonctionnalités

v2

Vous trouverez ci-dessous la liste des modifications apportées entre la version 1 et la version 2:

v1

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

    ÉnumérationValeur(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 de service inventorySources et un nouveau service guaranteedOrders.

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

Activation de la 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 code temporel donné.

Prise en charge de la dernière version de SDF, la v5.5, grâce à l'ajout d'une valeur d'énumération SdfVersion.

Nouvelles fonctionnalités

31 mars 2022

Prise en charge de la récupération et de la définition du ciblage sur la durée du contenu, le type de flux et le genre.

Ajout du champ billableOutcome à l'objet InsertionOrder.

Ajout du champ raiseBidForDeals à l'objet MaximizeSpendBidStrategy, ce qui permet aux utilisateurs de définir si la stratégie d'enchères applique les prix planchers de l'annonceur aux accords ciblés.

Nouvelles fonctionnalités

2 février 2022

Ajout de la possibilité de créer, de mettre à jour et de 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.

Ajout d'un nouveau champ reservationType dans les ressources InsertionOrder et LineItem qui indique si une ressource est Tag Guaranteed, Programmatic Guaranteed ou non garantie.

Ajout de la possibilité de récupérer et de définir si un élément de campagne cible automatiquement les nouvelles places de marché via 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

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

Prise en charge complète de 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 d'un élément de campagne.

Prise en charge de la dernière version de SDF, la v5.4, grâce à l'ajout d'une valeur d'énumération SdfVersion.

Nouvelles fonctionnalités

14 septembre 2021

Ajout de la compatibilité avec le ciblage de proximité dans 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.

Ajout 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 de l'inventaire avec Open Measurement activé 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 les différentes méthodes de liste d'options de ciblage attribuées à l'annonceur, à la campagne, à l'ordre d'insertion et à l'é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 à 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 la campagne. Les segments de budget de l'ordre d'insertion peuvent être associés à un budget de campagne, ce qui limite la somme du budget des segments associés au montant total du budget de la campagne.

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

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

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 nouveaux champs aux ressources Chaîne et Liste de mots clés à exclure qui renvoient le nombre d'éléments de ligne 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 ou des listes de mots clés à exclure spécifiques dans leur ciblage.

Nouvelles fonctionnalités

30 mars 2021

Ajout d'une nouvelle méthode au service d'article qui génère un article 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és à l'ordre d'insertion parent.

Nous avons activé la récupération du ciblage de la campagne via un nouveau service de ciblage de campagne et une méthode de liste groupée supplémentaire.

Élargissement du ciblage des applications pour permettre de cibler 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 afin de faciliter la gestion du contenu des listes de chaînes et de mots clés à exclure. Voici quelques exemples de ces modifications:

  • Ajout de méthodes replace, qui permettent à un utilisateur de remplacer entièrement le contenu existant d'une chaîne ou d'une liste de mots clés à exclure.
  • Suppression de l'exigence selon laquelle aucun élément existant ne doit être inclus 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 list sites (Liste des sites) ou list negative keywords (Liste des mots clés à exclure).

Nouvelles fonctionnalités

Abandons

24 février 2021

Ajout 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. Nous avons développé la ressource de création en ajoutant des champs de création en sortie uniquement à utiliser par les créations audio tierces. Ajout de nouveaux types d'objectifs de performances à utiliser par les ressources ordre d'insertion et campagne.

Nouvelles fonctionnalités

27 janvier 2021

Possibilité de récupérer et de gérer les ordres d'insertion pour la télévision et les éléments de campagne pour les services de distribution par contournement (OTT) grâce à l'introduction d'un nouveau champ InsertionOrderType et d'une nouvelle valeur d'énumération LineItemType. Ajout de la prise en charge des éléments de campagne pour les applications mobiles via un champ d'élément de campagne mobileApp. Compatibilité étendue avec les places de marché, les audiences Google et les SDF grâce à des valeurs d'énumération supplémentaires. Ajout de la possibilité de filtrer et d'organiser les valeurs advertisers.list en fonction de 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 zone géographique et de filtrer les résultats de plusieurs méthodes de liste de ressources en fonction de leur dernière modification. Ajout 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

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. Ajout de options d'élargissement du ciblage qui, lorsqu'elles sont définies, peuvent élargir le ciblage d'un élément de campagne pour inclure les utilisateurs semblables à ceux des audiences cibles. Ajout de champs d'ID de segment personnalisé aux objets DoubleVerify et Integral Ad Science utilisés dans le ciblage de validation tierce.

Nouvelles fonctionnalités

12 octobre 2020

Ajout de messages d'avertissement récupérables à 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 désormais en vigueur et de nouvelles documentations sur l'utilisation des requêtes par lot sont disponibles.

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 à diverses méthodes de liste.

Nouvelles fonctionnalités

4 août 2020

Lancement de nouveaux services de gestion des utilisateurs, de partenariat et de ciblage des partenaires. Ajout d'outils pour aider les utilisateurs à éviter de dépasser les limites d'entités de compte de manière proactive. Prise en charge des éléments de campagne audio et utilisation des algorithmes d'enchères personnalisées dans les stratégies d'enchères élément de campagne et ordre d'insertion.

Nouvelles fonctionnalités

24 juin 2020

Lancement d'une petite mise à jour ajoutant une méthode de création pour les chaînes de partenaires et d'annonceurs, de nouveaux champs FirstAndThirdPartyAudience et des valeurs d'énumération place de marché supplémentaires.

Nouvelles fonctionnalités

2 juin 2020

Vous pouvez désormais créer, corriger et renseigner un sous-ensemble d'entités ciblables. Vous pouvez également modifier le ciblage au niveau de l'annonceur pour trois types de ciblage: canal, exclusion de libellé de contenu numérique et exclusion de catégorie sensible.

Nouvelles fonctionnalités

27 avril 2020

Lancement d'un grand ensemble de fonctionnalités, qui élargit le champ d'application de l'API au-delà de SDF. Ajout d'une gestion de ressources de base qui vous permet de créer, de récupérer, de mettre à jour et de 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 des éléments de campagne.

Nouvelles fonctionnalités

Les services suivants ont été ajoutés:

ServiceMéthode(s)
Annonceurs

create

delete

get

liste

correctif
advertisers.assets

uploaded
advertisers.campaigns

create

delete

get

liste

correctif
advertisers.channels

get

liste
advertisers.creatives

create

delete

get

liste

correctif
advertisers.insertionOrders

create

delete

get

liste

correctif
advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

create

delete

get

liste

correctif
advertisers.lineItems.targetingTypes.assignedTargetingOptions

create

delete

get

liste
advertisers.locationLists

get

liste
advertisers.negativeKeywordLists

get

liste
combinedAudiences

get

liste
customLists

get

liste
firstAndThirdPartyAudiences

get

liste
floodlightGroups

get

correctif
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.