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
Les champs suivants ont été ajoutés:
Ressource Champ(s) InsertionOrder Les méthodes suivantes sont désormais compatibles avec les types de ciblage suivants:
Type de ciblage Méthodes TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
v2
Les méthodes suivantes sont désormais compatibles avec les types de ciblage suivants:
Type de ciblage Méthodes TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
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:
Enum Valeur(s) SdfVersion SDF_VERSION_7_1
v2
Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(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:
Ressource Champ(s) KPI Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(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
Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Place de marché EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
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
Les champs suivants ont été ajoutés:
Ressource Champ(s) firstAndThirdPartyAudiences.editCustomerMatchMembers Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) Place de marché EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Les champs suivants ont été ajoutés:
Ressource Champ(s) firstAndThirdPartyAudiences.editCustomerMatchMembers Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) Place de marché EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
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
Les méthodes suivantes ont été ajoutées:
Service Méthodes floodlightGroups.floodlightActivities Les champs suivants ont été ajoutés:
Ressource Champ(s) Utilisateur YoutubeAndPartnersInventorySourceConfig
v2
Les méthodes suivantes ont été ajoutées:
Service Méthodes floodlightGroups.floodlightActivities Les champs suivants ont été ajoutés:
Ressource Champ(s) Utilisateur YoutubeAndPartnersInventorySourceConfig
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
Les champs suivants ont été ajoutés:
Ressource Champ(s) ContactInfoList MobileDeviceIdList
v2
Les champs suivants ont été ajoutés:
Ressource Champ(s) ContactInfoList MobileDeviceIdList
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:
Enum Valeur(s) AdGroupFormat AD_GROUP_FORMAT_ACTION
Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) SdfVersion SDF_VERSION_7
2 octobre 2023
Nouvelles fonctionnalités
Publication de la v3 en version bêta publique, avec les modifications suivantes:
- Possibilité de gérer entièrement les listes d'emplacements de proximité, permettant d'utiliser le service
advertisers.locationLists.assignedLocations
pour créer et supprimer des emplacements attribués aux ressourcesTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
. - Un nouveau champ booléen
enableOptimizedTargeting
, qui remplace le champtargetingExpansionLevel
dans l'objetTargetingExpansionConfig
. - L'exigence du champ
billingConfig
dans la ressourceAdvertiser
, qui doit être inclus lorsque vous effectuez des requêtesadvertisers.create
, et un nouveau champbillingConfig
dans la ressourcePartner
. - Nouvelles ressources
AdGroup
etAdGroupAd
qui remplacent les ressourcesYoutubeAdGroup
etYoutubeAdGroupAd
dans la version 2.
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
Les méthodes suivantes ont été ajoutées:
Service Méthodes advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules Les méthodes suivantes ont été supprimées:
Service Méthodes advertisers.manualTriggers activer
créer
désactiver
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
Le comportement de la méthode suivante a changé:
Méthode Changement(s) advertisers.locationLists.create Permet désormais de créer des ressources LocationList
TARGETING_LOCATION_TYPE_PROXIMITY
.advertisers.locationLists.patch Prise en charge de la mise à jour des ressources LocationList
TARGETING_LOCATION_TYPE_PROXIMITY
.advertisers.locationLists.assignedLocations.bulkEdit Prise en charge de la modification groupée des ressources AssignedLocation
dans les ressourcesLocationList
TARGETING_LOCATION_TYPE_PROXIMITY
.advertisers.locationLists.assignedLocations.create Permet désormais de créer des ressources AssignedLocation
dansTARGETING_LOCATION_TYPE_PROXIMITY
ressourcesLocationList
.Les paramètres de requête suivants ont été ajoutés:
Méthode Paramètre(s) inventorySources.get Les champs suivants sont désormais obligatoires:
Ressource Champ(s) Annonceur Les champs suivants ont été ajoutés:
Ressource Champ(s) BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Les champs suivants ont été supprimés :
Ressource Champ(s) InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) CustomBiddingAlgorithmType RULE_BASED
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
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Les valeurs d'énumération suivantes ont été supprimées:
Enum Valeur(s) LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(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
Les champs suivants ont été ajoutés:
Ressource Champ(s) YoutubeAndPartnersSettings Les champs suivants ont été supprimés :
Ressource Champ(s) InventorySource subSitePropertyId
Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) Place de marché EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
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:
Enum Valeur(s) SdfVersion SDF_VERSION_6
v1
Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(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:
Enum Valeur(s) LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(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
Les méthodes suivantes ont été ajoutées:
Service Méthodes advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Les champs suivants ont été ajoutés:
Service Méthodes AssignedTargetingOption YoutubeAndPartnersSettings Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) Place de marché EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(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
Les champs suivants ont été ajoutés:
Ressource Champ(s) Annonceur AssignedTargetingOption Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
La taille maximale de page a été augmentée pour les méthodes de liste suivantes:
v1
La taille maximale de page a été augmentée pour les méthodes de liste suivantes:
Problèmes connus
Cette mise à jour résout les problèmes connus suivants dans la v2:
- Les options de ciblage des types de ciblage attribuées à l'aide de valeurs d'énumération dans la version 2 n'ont pas pu être supprimées ni récupérées à l'aide de leur
assignedTargetingOptionId
. À la place, les utilisateurs devaient utiliser la valeur d'énumération. Avec cette mise à jour, ces options de ciblage attribuées peuvent être supprimées ou récupérées à l'aide de la valeurassignedTargetingOptionId
ou de la valeur d'énumération, identifiée par le nouveau champassignedTargetingOptionIdAlias
dans la ressourceAssignedTargetingOption
. - La requête d'élément de campagne
bulkUpdate
n'utilisait pas correctement le paramètre de requêteadvertisersId
, ce qui a renvoyé une erreur. Avec cette mise à jour, la méthode a été corrigée et le paramètre de requêteadvertisersId
a été renomméadvertiserId
.
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
Les méthodes suivantes ont été ajoutées:
Service Méthodes advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
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:
- Possibilité de récupérer des éléments de campagne YouTube et partenaires et leurs paramètres de ciblage à l'aide des méthodes
get
etlist
dans les servicesadvertisers.lineItems
etadvertisers.lineItems.targetingTypes.assignedTargetingOptions
. - Deux nouvelles méthodes de ciblage groupé dans le service
advertisers.lineItems
qui permettent de modifier et de récupérer le ciblage attribué pour plusieurs éléments de campagne avec une seule demande. - Nouvelle méthode
bulkUpdate
qui permet aux utilisateurs de mettre à jour leentityStatus
de plusieurs éléments de campagne en une seule requête. - Nouvelle logique de ciblage qui nécessite l'attribution et la récupération des ressources
AssignedTargetingOption
d'un sous-ensemble de types de ciblage à l'aide de valeurs d'énumération au lieu des ID d'option de ciblage récupérés à l'aide du servicetargetingTypes.targetingOptions
.
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:
Les méthodes suivantes ont été ajoutées dans la version 2:
Service Méthodes advertisers.lineItems bulkEditAssignedTargetingOptions
Les méthodes suivantes ont été supprimées dans la version 2:
Service Méthodes advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Les méthodes suivantes ont été renommées dans la version 2:
Service Ancien nom de la méthode Nom de la nouvelle méthode advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Dans la version 2, les ressources
AssignedTargetingOption
des types de ciblage suivants utilisent des énumérations pour l'attribution du ciblage. Le champassignedTargetingOptionId
pour les ressourcesAssignedTargetingOption
de ces types de ciblage a également été mis à jour dans la version 2 afin d'utiliser des versions de chaîne des valeurs enum:Type de ciblage Type d'énumération TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT Environment TARGETING_TYPE_EXCHANGE Place de marché TARGETING_TYPE_GENDER Genre TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY Visibilité Les champs suivants ont été ajoutés dans la version 2:
Les champs suivants ont été supprimés dans la version 2:
Les champs suivants sont désormais obligatoires dans la version 2:
Les valeurs d'énumération suivantes ont été ajoutées dans la version 2:
Enum Valeur(s) AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
Place de marché EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
Les valeurs d'énumération suivantes ont été supprimées dans la version 2:
Enum Valeur(s) LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
Les valeurs d'énumération suivantes ont été ajoutées dans la version 1:
Enum Valeur(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
Les méthodes suivantes ont été ajoutées:
Service Méthodes guaranteedOrders inventorySources Les champs suivants ont été ajoutés:
Ressource Champ(s) CustomBiddingAlgorithm InventorySource Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) SdfVersion Les méthodes de liste suivantes peuvent désormais être filtrées en fonction des propriétés suivantes:
Méthode Champ(s) advertisers.creatives.list
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
Les champs suivants ont été ajoutés:
Ressource Champ(s) AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) TargetingType
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
Les méthodes suivantes ont été ajoutées:
Service Méthodes firstAndThirdPartyAudiences Les champs suivants ont été ajoutés:
Ressource Champ(s) FirstAndThirdPartyAudience InsertionOrder LineItem
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
Les champs suivants ont été ajoutés:
Ressource Champ(s) AssignedTargetingOption TargetingOption Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) TargetingType
8 novembre 2021
Ajout d'une compatibilité totale avec la gestion des algorithmes d'enchères personnalisées et de leurs scripts. Par exemple :
- Fonctions permettant de créer et de mettre à jour des
customBiddingAlgorithms
existants. - Possibilité d'importer des scripts via le processus de récupération d'un emplacement de ressource disponible, puis d'importation du fichier vers cet emplacement
- Un nouveau service
customBiddingAlgorithms.scripts
pour récupérer et créercustomBiddingScripts
.
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
Les méthodes suivantes ont été ajoutées:
Service Méthodes customBiddingAlgorithms customBiddingAlgorithms.scripts media Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) SdfVersion
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
Les champs suivants ont été ajoutés:
Ressource Champ(s) AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Corps de la requêteTargetingOptions.search Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) CustomBiddingAlgorithmType Place de marché TargetingType Les méthodes de liste suivantes peuvent désormais être filtrées en fonction des propriétés suivantes:
Méthode Champ(s) customBiddingAlgorithms.list
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
Les champs suivants ont été ajoutés:
Ressource Champ(s) AssignedTargetingOption TargetingOption Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) TargetingType La taille maximale de page a été augmentée pour les méthodes de liste suivantes:
Méthode Nouvelle taille maximale de page advertisers.campaigns.targetingTypes.assignedTargetingOptions.list 5 000 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list 5 000 advertisers.lineItems.targetingTypes.assignedTargetingOptions.list 5 000 advertisers.targetingTypes.assignedTargetingOptions.list 5 000
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
Les méthodes suivantes ont été ajoutées:
Service Méthodes advertisers.invoices Les champs suivants ont été ajoutés:
Ressource Champ(s) Annonceur AssignedTargetingOption TargetingOption Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) AssignedTargetingOption.Recency Échange TargetingType Les valeurs d'énumération suivantes sont désormais valides pour les champs suivants:
Ressource Champ Valeur(s) Annonceur entityStatus ENTITY_STATUS_PAUSED
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
Les champs suivants ont été ajoutés:
Ressource Champ(s) Canal Les méthodes de liste suivantes peuvent désormais être filtrées en fonction des propriétés suivantes:
Méthode Champ(s) advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
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
oucreatedNegativeKeywords
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
Les méthodes suivantes ont été ajoutées:
Les champs suivants ont été ajoutés:
Ressource Champ(s) AssignedTargetingOption.AppAssignedTargetingOptionDetails La taille maximale de page a été augmentée pour les méthodes de liste suivantes:
Méthode Ancienne taille maximale de page Nouvelle taille maximale de page advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1 000 partners.channels.sites.list 100 10000
Abandons
Les valeurs d'énumération suivantes ne peuvent plus être attribuées à des ressources nouvelles ou existantes:
Enum Valeur(s) PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
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
Les méthodes suivantes ont été ajoutées:
Service Méthodes advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Les champs suivants ont été ajoutés:
Ressource Champ(s) Création Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
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
Les champs suivants ont été ajoutés:
Ressource Champ(s) InsertionOrder LineItem Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) Échange GoogleAudienceType LineItemType SdfVersion Les méthodes de liste suivantes peuvent désormais être triées et filtrées selon les champs suivants:
Méthode Champ(s) annonceurs
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
Les méthodes suivantes ont été ajoutées:
Service Méthodes targetingTypes.targetingOptions Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) Échange LineItemWarningMessage Les méthodes de liste suivantes peuvent désormais être triées et filtrées selon les champs suivants:
Méthode Champ(s) advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
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
Les services suivants ont été ajoutés:
Service Méthodes advertisers.manualTriggers Les champs suivants ont été ajoutés:
Ressource Champ(s) AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) LineItemFlightDateType Les méthodes de liste suivantes peuvent désormais être filtrées selon les champs suivants:
Méthode Champ(s) advertisers.lineItems.list
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
Les champs suivants ont été ajoutés:
Ressource Champ(s) LineItem Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) PerformanceGoalType Les méthodes de liste suivantes peuvent désormais être filtrées selon les champs suivants:
Méthode Champ(s) advertisers.lineItems.list
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
Les champs suivants ont été ajoutés:
Ressource Champ(s) Corps de la réponse Advertisers.Audit Les méthodes de liste suivantes peuvent désormais être filtrées selon les champs suivants:
Méthode Champ(s) advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
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
Les services suivants ont été ajoutés:
Service Méthodes customBiddingAlgorithms partenaires partners.targetingTypes.assignedTargetingOptions utilisateurs Les méthodes suivantes ont été ajoutées:
Service Méthodes annonceurs Les champs suivants ont été ajoutés:
Ressource Champ(s) MaximizeSpendBidStrategy PerformanceGoalBidStrategy Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) BiddingStrategyPerformanceGoalType LineItemType Les méthodes de liste suivantes peuvent désormais être triées et filtrées selon les champs suivants:
Méthode Champ(s) advertisers.lineItems.list Les niveaux d'accès suivants ont été ajoutés pour être utilisés avec les services suivants:
Champ d'application Service(s) https://www.googleapis.com/auth/display-video-user-management
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
Les services suivants ont été ajoutés:
Service Méthodes advertisers.channels partners.channels Les champs suivants ont été ajoutés:
Ressource Champ(s) FirstAndThirdPartyAudience Les valeurs enum suivantes ont été ajoutées:
Enum Valeur(s) Échange Les méthodes de liste suivantes peuvent désormais être filtrées selon les champs suivants:
Méthode Champ(s) advertisers.creatives.list
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
Les services suivants ont été ajoutés:
Les méthodes suivantes ont été ajoutées:
Service Méthodes annonceurs advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Les champs suivants ont été ajoutés:
Ressource Champ(s) annonceur création insertionOrder.insertionOrderBudgetSegment
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:
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