Les versions de l'API Display & Video 360 sont régulièrement publiées, obsolètes et abandonnées. Ces étapes sont définies comme suit :
Version : la version n'est plus en version alpha ou bêta, et est considérée comme stable. De nouvelles fonctionnalités pourront toujours être publiées pour cette version.
Abandon : la version est mise hors service et une date de fin de prise en charge est annoncée. Les utilisateurs doivent migrer vers une version plus récente avant la date d'arrêt. Aucune nouvelle fonctionnalité ne sera ajoutée à cette version.
Abandonnée : la version n'est plus compatible. Les requêtes envoyées à la version renvoient une erreur.
Ce tableau liste toutes les versions existantes de l'API Display & Video 360, leurs dates de sortie, ainsi que leurs dates d'arrêt et de fin de vie, le cas échéant.
Le tableau ci-dessous répertorie toutes les fonctionnalités dont l'abandon a été annoncé, en indiquant la date d'entrée en vigueur initiale et une description de l'abandon avec les actions recommandées et les liens vers la documentation pertinente :
Fonctionnalité
Date d'entrée en vigueur initiale
Description
Élargissement du ciblage
25 mars 2023
Remplacement de la fonctionnalité d'élargissement du ciblage par le ciblage optimisé, déployé progressivement du 25 mars 2023 à début mai 2023. Les modifications apportées au comportement de l'API Display & Video 360 et des fichiers de données structurées, ainsi que les actions recommandées, ont été annoncées dans un article de blog.
Déclencheurs manuels
17 mai 2023
Chronologie :
17 mai 2023 : les éléments de campagne utilisant des déclencheurs manuels ne seront plus diffusés dans Display & Video 360. Si vous activez un déclencheur manuel associé à un élément de campagne actif après cette date, l'élément de campagne ne diffusera pas d'annonces.
1er août 2023 : le service advertisers.manualTriggers dans les versions 1 et 2 de l'API DV360, la valeur d'énumération LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER dans la version 1 de l'API DV360 et le champ LineItemFlight.triggerId dans la version 1 de l'API DV360 seront abandonnés. Passé cette date, les requêtes envoyées à ces services ou à ces champs renverront une erreur.
Actions recommandées :
Arrêtez immédiatement d'utiliser les déclencheurs manuels pour démarrer et arrêter la diffusion des éléments de campagne.
Types d'événements GoogleAudience "Application installée" et "Nouveaux appareils mobiles"
20 mai 2023
Chronologie :
20 mai 2023 : vous ne pourrez plus attribuer de ressources GoogleAudience avec un GoogleAudienceType de GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS ou GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES au ciblage d'audience des éléments de campagne ou des ordres d'insertion. Les requêtes qui attribuent ces audiences au ciblage d'audience d'un élément de campagne renvoient une erreur. Cela inclut les requêtes advertisers.lineItems.duplicate et advertisers.lineItems.generateDefault si l'élément de campagne créé inclut des audiences obsolètes dans son ciblage d'audience.
8 juin 2023 : les audiences concernées seront supprimées du ciblage de tous les éléments de campagne et ordres d'insertion, ainsi que de toutes les audiences combinées. Si un élément de campagne n'est pas en mesure de diffuser des annonces lorsque ces audiences sont supprimées, il sera mis en veille. À cette date, ces audiences ne pourront plus être récupérées à l'aide du service googleAudiences.
Tâches recommandées :
Nous vous recommandons d'arrêter immédiatement d'utiliser les audiences concernées lorsque vous modifierez le ciblage de vos éléments de campagne.
Supprimez toutes les audiences concernées du ciblage des ordres d'insertion et des éléments de campagne existants. Pour savoir comment modifier le ciblage d'audience, consultez notre guide sur les audiences cibles.
20 mai 2023 : vous ne pourrez plus attribuer de ressources FirstAndThirdPartyAudience avec un AudienceType de ACTIVITY_BASED ou FREQUENCY_CAP au ciblage d'audience des éléments de campagne ou des ordres d'insertion. Les requêtes qui attribuent ces audiences au ciblage d'audience d'un élément de campagne renvoient une erreur. Cela inclut les requêtes advertisers.lineItems.duplicate et advertisers.lineItems.generateDefault si l'élément de campagne créé inclut des audiences obsolètes dans son ciblage d'audience.
8 juin 2023 : les audiences concernées seront supprimées du ciblage de tous les éléments de campagne et ordres d'insertion, ainsi que de toutes les audiences combinées. Si un élément de campagne n'est pas en mesure de diffuser des annonces lorsque ces audiences sont supprimées, il sera mis en veille. À cette date, ces audiences ne pourront plus être récupérées à l'aide du service firstAndThirdPartyAudiences.
Tâches recommandées :
Nous vous recommandons d'arrêter immédiatement d'utiliser les audiences concernées lorsque vous modifierez le ciblage de vos éléments de campagne.
Supprimez toutes les audiences concernées du ciblage des ordres d'insertion et des éléments de campagne existants. Pour savoir comment modifier le ciblage d'audience, consultez notre guide sur les audiences cibles.
Limites de quota d'API existantes
30 mai 2023
Le 30 mai 2023, les limites d'utilisation existantes seront remplacées par une structure de quotas hybride qui effectuera les actions suivantes :
Supprime le quota de requêtes par jour et par projet.
Établit un quota de requêtes par minute et par annonceur et par projet pour les méthodes éligibles.
Ces nouvelles limites permettront une plus grande flexibilité dans l'utilisation des API et la parallélisation des requêtes entre les annonceurs. Pour en savoir plus sur ce changement, consultez notre documentation existante sur les limites de quota.
Utilisation de l'opérateur OR entre les restrictions de différents champs dans les filtres LIST
21 juin 2023
Le 21 juin 2023, les paramètres de la requête LISTfilter ne permettront plus d'utiliser les opérateurs logiques OR entre les restrictions de différents champs.
Par exemple, les ressources identifiées avec la chaîne de filtre lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" doivent être récupérées à l'aide de deux requêtes LIST avec les chaînes de filtre suivantes :
Vérifiez les paramètres de requête filter de tous vos appels LIST existants et assurez-vous qu'ils utilisent correctement l'opérateur logique OR avant le 21 juin 2023 pour éviter toute interruption de service.
Supprimez toute la logique de filtrage à l'aide de ces quatre champs avant le 21 juin 2023 pour éviter une interruption de service.
Achats en fonction du résultat
1er août 2023
Le 1er août 2023, les ordres d'insertion utilisant l'achat basé sur les résultats, défini par une valeur de champ billableOutcome de BILLABLE_OUTCOME_PAY_PER_CLICK ou BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, et leurs éléments de campagne enfants seront archivés.
Cette modification affecte les demandes suivantes :
Toute tentative d'utilisation de advertisers.insertionOrders.create pour créer un ordre d'insertion avec des achats basés sur les résultats renverra une erreur 400.
Étant donné que les ressources archivées ne sont pas incluses dans les requêtes LIST par défaut, les ressources concernées ne seront plus renvoyées par les méthodes advertisers.insertionOrders.list et advertisers.lineItems.list par défaut.
À partir du 26 juin 2024, le champ publisherReviewStatuses sera supprimé et sera vide lors de la récupération des ressources Creative.
Ciblage de contenu pour les éléments de campagne YouTube et partenaires
30 septembre 2024
Le 30 septembre 2024, les valeurs suivantes pour les types de ciblage identifiés seront abandonnées pour les éléments de campagne YouTube et partenaires :
Les options de ciblage obsolètes seront automatiquement supprimées du ciblage des éléments de campagne existants. Ces valeurs pourront toujours être utilisées pour le ciblage au niveau de l'annonceur.
Pour éviter toute interruption du service, supprimez ce ciblage de tous les éléments de campagne YouTube et partenaires existants avant la date d'arrêt.
Audiences propriétaires et tierces Oracle
30 septembre 2024
Le 30 septembre 2024, les sources de ressources FirstAndThirdPartyAudience d'Oracle seront abandonnées. Une fois ces audiences abandonnées, elles seront supprimées de tout ciblage de ressources et d'audience combinée existants. Si un élément de campagne cible uniquement des audiences obsolètes ou exclut des audiences obsolètes, il sera automatiquement mis en veille.
Pour éviter toute interruption de service, identifiez et supprimez toutes les audiences Oracle du ciblage d'audience et des audiences combinées des lignes existantes avant la date d'arrêt.
Ciblage optimisé au niveau de l'élément de campagne pour un sous-ensemble de stratégies d'enchères
Pour éviter toute interruption de service, vérifiez que le ciblage optimisé n'est pas activé pour vos éléments de campagne utilisant ces stratégies d'enchères.
"Dès que possible + Période de diffusion" Pacing pour les ordres d'insertion
5 novembre 2024
Le 5 novembre 2024, PACING_TYPE_ASAP ne sera plus compatible avec PACING_PERIOD_FLIGHT lors de la définition du champ pacing de l'ordre d'insertion. Le pacingType de tous les ordres d'insertion existants avec cette configuration sera remplacé par PACING_TYPE_AHEAD.
Pour éviter toute interruption de service, mettez à jour le pacing de tous les ordres d'insertion existants à l'aide de PACING_TYPE_ASAP et PACING_PERIOD_FLIGHT.
Période de limitation de la fréquence d'exposition supérieure à 30 jours
28 février 2025
Le 28 février 2025 :
Les requêtes qui créent ou mettent à jour des ressources LineItem, InsertionOrder et Campaign pour utiliser un objet FrequencyCap avec un champ timeUnit défini sur TIME_UNIT_LIFETIME ou un champ timeUnit défini sur TIME_UNIT_MONTH et un champ timeUnitCount défini sur 2 renverront une erreur 400.
Les entrées des fichiers de données structurées Élément de campagne, Ordre d'insertion et Campagne dont la valeur de la colonne"Période de fréquence " est définie sur"Durée de vie " ou sur"Mois " et dont la valeur de la colonne"Nombre de fréquences " est définie sur"2 " ne pourront pas être créées ni mises à jour lors de l'importation du fichier.
Les campagnes, les ordres d'insertion et les éléments de campagne existants seront mis à jour pour utiliser une période de limitation de la fréquence d'exposition de 30 jours ou moins.
Pour éviter toute interruption de service :
Mettez à jour les ressources existantes de campagnes, d'ordres d'insertion et d'éléments de campagne qui utilisent une période de limitation de la fréquence d'exposition de plus de 30 jours pour qu'elle soit de 30 jours ou moins.
Vérifiez que votre intégration ne définit pas de période de capping de fréquence supérieure à 30 jours lorsque vous créez ou mettez à jour des ressources de campagne, d'ordre d'insertion ou d'élément de campagne à l'aide de l'API Display & Video 360 ou de fichiers de données structurées.
Ciblage optimisé pour les éléments de campagne utilisant des enchères fixes
Les entrées des fichiers de données structurées Line Item dont la valeur de la colonne "Bid Strategy Type" est "Fixed" et celle de la colonne "Optimized Targeting" est "True" ne pourront pas être créées ni mises à jour lors de l'importation du fichier.
Le ciblage optimisé sera désactivé pour les éléments de campagne existants utilisant des enchères fixes.
Pour éviter toute interruption de service :
Mettez à jour les ressources d'éléments de campagne existantes qui utilisent à la fois les enchères fixes et le ciblage optimisé.
Vérifiez que votre intégration ne définit pas de stratégie d'enchères fixe ni de ciblage optimisé lorsque vous créez ou mettez à jour des ressources d'éléments de campagne à l'aide de l'API Display & Video 360 ou de fichiers de données structurées.
Mise à jour de la taille de page par défaut de firstAndThirdPartyAudiences.list
Pour éviter toute interruption de service, mettez à jour votre intégration afin de définir le paramètre de requête pageSize de vos requêtes firstAndThirdPartyAudiences.list sur la taille de page de votre choix.
Nouvelle erreur de non-concordance entre le partenaire et l'annonceur sdfdownloadtasks.create
Restrictions concernant les éléments de campagne YouTube de type "Couverture" dans le fichier SDF
24 mars 2025
Le 24 mars 2025, les fichiers de données structurées nécessiteront l'utilisation de formats d'annonces plus larges lors de la création ou de la modification d'éléments de campagne. Cela entraîne le comportement suivant :
Les fichiers SDF v6 et v7 ne permettent plus de créer des entrées d'éléments de campagne avec la valeur Subtype "Couverture".
Les nouvelles entrées dans les fichiers Élément de campagne au format SDF avec la valeur Subtype "Couverture" doivent utiliser la valeur "Responsive" dans la colonne TrueView Video Ad Formats. Les entrées existantes dont la valeur Subtype est "Couverture" ne peuvent pas mettre à jour la valeur de leur colonne TrueView Video Ad Formats.
Les nouvelles entrées dans les fichiers de données structurées Élément de campagne avec la valeur Subtype "Couverture" nécessitent de renseigner la colonne TrueView Video Ad Inventory Control.
Incohérence entre l'algorithme d'enchères personnalisées et les activités Floodlight
Les entrées des fichiers de données structurées Élément de campagne qui tentent de mettre à jour la colonne "ID d'activité Floodlight de conversion" lorsque la colonne "ID d'algorithme" est définie ne seront pas mises à jour lors de l'importation du fichier.
Pour éviter toute interruption de service, mettez à jour votre intégration pour :
Vérifiez que les activités Floodlight pertinentes sont attribuées à un élément de campagne avant ou en même temps que l'algorithme d'enchères personnalisées.
Les algorithmes d'enchères personnalisées existants sont dissociés de tous les éléments de campagne avant toute tentative de mise à jour.
Le 7 avril 2025, les ressources FirstAndThirdPartyAudience ne permettront plus de définir une durée d'appartenance infinie aux audiences. Les requêtes firstAndThirdPartyAudiences.create et firstAndThirdPartyAudiences.patch qui définissent la valeur du champ membershipDurationDays sur 10 000 renvoient une erreur 400. La valeur du champ membershipDurationDays des audiences existantes sera remplacée par 540,et la nouvelle durée d'abonnement sera appliquée rétroactivement aux abonnements existants. Toutes les souscriptions datant de plus de 540 jours seront résiliées.
Pour éviter toute interruption de service :
Vérifiez que votre intégration ne définit pas la valeur du champ membershipDurationDays des audiences nouvelles ou existantes sur 10 000.
Actualisez régulièrement les membres de vos audiences de ciblage par liste de clients pour vous assurer que la taille de vos listes d'audience ne diminue pas involontairement.
Campagnes vidéo pour l'action dans les fichiers de données structurées
22 avril 2025
Le 22 avril 2025, vous ne pourrez plus créer d'éléments de campagne pour les campagnes vidéo pour l'action à l'aide de fichiers de données structurées, car ils seront migrés vers la génération de la demande. Les entrées d'éléments de campagne qui tentent d'être importées avec une valeur de colonne Subtype définie sur "Action" et une valeur de colonne Type définie sur "TrueView" échoueront.
Pour éviter toute interruption de service, mettez à jour votre intégration afin d'utiliser des campagnes de génération de la demande plutôt que des campagnes vidéo pour l'action.
Exiger une source d'inventaire de partenaires vidéo pour les éléments de campagne de génération de la demande dans les fichiers de données structurées
22 avril 2025
À partir du 22 avril 2025, vous devrez inclure la valeur "Partenaires vidéo" dans la colonne TrueView Inventory Source Targeting des entrées d'éléments de campagne dont la valeur de la colonne Type est "Génération de la demande". Une fois cette application commencée, la valeur sera renseignée pour les éléments de campagne existants et incluse lors du téléchargement de nouveaux fichiers de données structurées.
Pour éviter toute interruption de service :
Mettez à jour votre intégration pour inclure la valeur "Partenaires vidéo" dans toutes les entrées d'éléments de campagne de génération de la demande.
Mettez à jour votre intégration pour gérer les sources d'inventaire de génération de la demande au niveau du groupe d'annonces à l'aide des colonnes Groupe d'annonces SDF v8.1Demand Gen Inventory Source Strategy et Demand Gen Enabled Inventory Sources.
Colonne "Multiplicateurs d'enchères" dans les fichiers de données structurées des lignes d'insertion
1er mai 2025
Le 1er mai 2025, les entrées des fichiers de données structurées Élément de campagne qui tentent de définir la colonne "Multiplicateurs d'enchères" ne permettront pas de créer ni de mettre à jour la ressource lors de l'importation du fichier.
Paramètres de catégorie de contenu pour les éléments de campagne YouTube et partenaires
12 juin 2025
Le 12 juin 2025, les configurations de catégorie de contenu pour les éléments de campagne YouTube et partenaires individuels ne seront plus modifiables. Cette modification s'inscrit dans le cadre d'une mise à jour de l'expérience de brand suitability. Les paramètres de catégorie de contenu seront désormais contrôlés uniquement au niveau de l'annonceur. Pour tenir compte de ce changement, les modifications suivantes seront apportées à l'API Display & Video 360 et aux fichiers de données structurées :
La colonne TrueView Content Filter des fichiers SDF Line Item ne sera plus modifiable.
Pour éviter toute interruption de service :
Récupérez le champ effectiveContentCategory à la place du champ contentCategory lorsque vous examinez les éléments de campagne YouTube et partenaires dans l'API.
Arrêtez de modifier la colonne TrueView Content Filter lorsque vous mettez à jour les entrées d'éléments de campagne SDF. Laissez la colonne vide lorsque vous créez des éléments de campagne.
Mises à jour du budget des éléments de campagne avec l'optimisation des ordres d'insertion
12 juin 2025
À partir du 12 juin 2025, vous ne pourrez plus modifier les paramètres de budget des éléments de campagne dont les ordres d'insertion parents sont définis sur l'optimisation à l'aide de stratégies d'enchères automatiques.
Dans le fichier SDF : vérifiez si l'entrée SDF de l'ordre d'insertion parent de l'élément de campagne a la valeur TRUE dans la colonne Insertion Order Optimization. Si c'est le cas, n'essayez pas de modifier les colonnes Budget Type ou Budget Amount pour l'entrée SDF de l'élément de campagne.
Restrictions concernant les fichiers de données structurées
12 juin 2025
À partir du 12 juin 2025, nous supprimerons une restriction existante pour les URL ciblées dans les entrées SDF, qui empêchait l'inclusion de sites plus récents. Au lieu de cela, le fichier SDF correspondra au comportement de l'API et de l'UI, et permettra le ciblage des URL à condition qu'elles soient correctement mises en forme.
Indiquer si les éléments de campagne diffusent des annonces à caractère politique dans l'UE
8 septembre 2025
À partir du 8 septembre 2025, lorsque vous créerez un élément de campagne à l'aide de l'API Display & Video 360 ou de fichiers de données structurées, vous devrez indiquer s'il diffusera des annonces à caractère politique dans l'Union européenne. Vous pouvez effectuer ces déclarations de différentes manières :
Utilisez la colonne Contains EU Political Ads dans le type de fichier Élément de campagne du fichier SDF version 9.
Si votre annonceur parent ne contient aucun élément de campagne diffusant des annonces à caractère politique dans l'UE, vous pouvez effectuer la déclaration au niveau de l'annonceur à l'aide du champ containsEuPoliticalAds dans la ressource Advertiser de l'API Display & Video 360. Si ce champ est défini sur DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, la même valeur sera attribuée à tous les nouveaux éléments de campagne de l'annonceur, sauf indication contraire. De plus, tous les éléments de campagne existants de l'annonceur seront mis à jour pour utiliser la même valeur si aucune valeur n'est déjà définie. Vous pouvez modifier la déclaration d'un article à tout moment après sa création à l'aide de l'UI, de l'API ou du fichier SDF.
Si vous ne pouvez pas effectuer de déclaration au niveau de l'annonceur ou si vous avez déclaré que des annonces politiques dans l'UE peuvent être diffusées sous votre annonceur, mettez à jour votre intégration de l'API Display & Video 360 et du fichier SDF avant le 8 septembre 2025 pour éviter toute interruption de service :
Migrez vers la version 9 des fichiers de données structurées et définissez la colonne Contains EU Political Ads de tous les nouveaux éléments de campagne sur Yes ou No lors de l'importation. Consultez notre guide de migration vers la version 9 pour obtenir des instructions détaillées.
Avant de modifier le ciblage géographique d'un élément de campagne existant à l'aide de l'API Display & Video 360 ou d'un fichier de données structurées, mettez à jour l'élément de campagne pour fournir une déclaration.
Gestion du ciblage des ordres d'insertion et des campagnes dans l'API Display & Video 360 et les fichiers de données structurées
Février 2026
En février 2026, Display & Video 360 abandonnera le ciblage des ordres d'insertion et des campagnes. Des modifications seront apportées à l'API Display & Video 360 et aux fichiers de données structurées (SDF) pour tenir compte de ce changement. Dans l'API Display & Video 360, un sous-ensemble de méthodes sera abandonné et renverra une erreur s'il est appelé. Dans le SDF, les colonnes de ciblage des fichiers Ordre d'insertion et Campagne ne seront plus renseignées lors du téléchargement et devront être vides lors de l'importation. Nous recommandons aux utilisateurs d'attribuer le ciblage directement aux éléments de campagne lors de leur création.
Les méthodes de l'API Display & Video 360 suivantes renverront une erreur 404 si elles sont appelées :
Les entrées SDF Insertion Order (Ordre d'insertion) auxquelles des valeurs sont attribuées dans les colonnes suivantes échoueront lors de l'importation :
Cette entrée sera mise à jour ultérieurement avec une date exacte.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/11/24 (UTC).
[null,null,["Dernière mise à jour le 2025/11/24 (UTC)."],[],[]]
