Vous trouverez sur cette page les notes de version l'API Video 360.
Dernière version de l'API: v3
15 août 2024
Nouvelles fonctionnalités
Ajout de la prise en charge du type Netflix Exchange
.
v3
Les valeurs enum suivantes ont été ajoutées:
Énumération Valeur(s) Place de marché EXCHANGE_NETFLIX
v2
Les valeurs enum suivantes ont été ajoutées:
Énumération Valeur(s) Place de marché EXCHANGE_NETFLIX
15 juillet 2024
Nouvelles fonctionnalités
Il est désormais possible de télécharger des fichiers de données structurées d'éléments de campagne et de groupes d'annonces dans Format de contrôle qualité dans la version 3.
v3
Les champs suivants ont été ajoutés:
Ressource Champ(s) IdFilter Les valeurs enum suivantes ont été ajoutées:
Énumération Valeur(s) FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
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.
Un nouveau champ optimizationObjective
a été ajouté à l'ordre d'insertion.
ressource. 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:
Énumération Valeur(s) SdfVersion SDF_VERSION_7_1
v2
Les valeurs enum suivantes ont été ajoutées:
Énumération 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:
Énumération 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:
Énumération 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:
Énumération 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:
Énumération 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 les activités Floodlight via une nouvelle
Service floodlightGroups.floodlightActivities
.
Ajout d'un nouveau champ indiquant si un compte YouTube et Élément de campagne Partners inclut l'inventaire Google TV dans son ciblage.
Ajout d'un nouveau champ pour relayer la dernière heure de connexion d'une session Display & Video 360 utilisateur.
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 du ciblage par liste de clients les membres du public dans toutes les versions en ligne.
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.
Changement de nom plus précis d'une valeur d'énumération AdGroupFormat
dans la version 3
reflètent le format approprié.
Les fichiers de données structurées v7 sont désormais pris en charge par l'ajout de l'élément
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ération Valeur(s) AdGroupFormat AD_GROUP_FORMAT_ACTION
Les valeurs enum suivantes ont été ajoutées:
Énumération Valeur(s) AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Les valeurs enum suivantes ont été ajoutées:
Énumération 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:
- La possibilité de gérer entièrement les listes d'emplacements de proximité, ce qui permet d'utiliser
advertisers.locationLists.assignedLocations
pour créer et supprimer les zones géographiques attribuées àTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
ressources. - Un nouveau champ booléen
enableOptimizedTargeting
, qui remplace le champtargetingExpansionLevel
dansTargetingExpansionConfig
. - L'exigence du champ
billingConfig
dans le la ressourceAdvertiser
, qui doit être incluse lors de la créationadvertisers.create
et une nouvelle ChampbillingConfig
dansPartner
ressource. - Nouvelles ressources
AdGroup
etAdGroupAd
remplacez les ressourcesYoutubeAdGroup
etYoutubeAdGroupAd
dans la version 2.
Suivez les étapes de notre guide de migration pour passer de la version 2 à v3.
Trois nouvelles valeurs LineItemType
, dont une
YoutubeAndPartnersBiddingStrategyType
et une nouvelle
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
create
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:
Énumération 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:
Énumération Valeur(s) LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Les valeurs enum suivantes ont été ajoutées:
Énumération 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 nouvelles plates-formes YouTube et Partenaires types de stratégies d'enchères.
Ajout d'un nouveau champ effectiveContentCategory
à YouTube et
d'éléments de campagne de partenaire
YoutubeAndPartnersContentCategory
utilisé par l'élément de campagne lorsque
en tenant compte des valeurs attribuées
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:
Énumération 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 v1 et v2.
v2
Les valeurs enum suivantes ont été ajoutées:
Énumération Valeur(s) SdfVersion SDF_VERSION_6
v1
Les valeurs enum suivantes ont été ajoutées:
Énumération Valeur(s) SdfVersion SDF_VERSION_6
9 mars 2023
Nouvelles fonctionnalités
Ajout d'une valeur LineItemWarningMessage
qui sera
est attribué au champ warningMessages
d'un élément de campagne
le champ obsolète excludeFirstPartyAudience
défini sur
true
Le champ excludeFirstPartyAudience
ne sera plus disponible
et défini sur false
après le 25 mars 2023.
v2
Les valeurs enum suivantes ont été ajoutées:
Énumération Valeur(s) LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Les valeurs enum suivantes ont été ajoutées:
Énumération Valeur(s) LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 février 2023
Nouvelles fonctionnalités
Ajout de la possibilité de récupérer YouTubeAdGroup
et
Ressources sur YouTubeAdGroupAd
et groupe d'annonces YouTube
le ciblage des ressources. En outre, nous avons ajouté de nouvelles
Types de ciblage récupérables utilisés dans les groupes d'annonces YouTube
à l'échelle du projet. Lisez notre nouvelle page de guide sur la récupération des comptes YouTube et Partenaires
ressources.
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:
Énumération 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:
Énumération 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
au
La ressource AssignedTargetingOption
, qui peut être utilisée à la place de la
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 qui
sont attribuées 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
au
Ressource Advertiser
.
Ajout de la compatibilité avec la récupération de contenus YouTube et les éléments de campagne de type "Service de distribution par contournement"
identifié 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
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:
Énumération 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 sont attribuées à l'aide d'énumération.
valeurs dans la version 2 n'ont pas pu être supprimées ni récupérées
à l'aide de leur
assignedTargetingOptionId
, alors qu'ils s'attendaient aux utilisateurs d'utiliser la valeur d'énumération. Avec cette mise à jour, ces critères de ciblage peuvent être supprimées ou récupérées à l'aide de laassignedTargetingOptionId
ou la valeur d'énumération, identifiée par le nouveau champassignedTargetingOptionIdAlias
dansAssignedTargetingOption
. - La demande d'élément de campagne
bulkUpdate
n'a pas été correctement utilisée le paramètre de requêteadvertisersId
et renvoyant une erreur. Avec cette mise à jour, la méthode a été corrigée et le paramètre de requête a été renommé DeadvertisersId
àadvertiserId
.
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 d'écriture pour le ciblage d'ordre d'insertion partiel pour un sous-ensemble des
types de ciblage, en ajoutant create
et
delete
à la
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
Google Cloud.
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:
- La possibilité de récupérer Les éléments de campagne de partenaire et leur ciblage
à l'aide des méthodes
get
etlist
dansadvertisers.lineItems
etadvertisers.lineItems.targetingTypes.assignedTargetingOptions
. - Deux nouvelles méthodes de ciblage groupé dans le service
advertisers.lineItems
qui permettent de modifier et récupérer pour plusieurs éléments de campagne avec une demande simple. - Une nouvelle méthode
bulkUpdate
qui permet aux utilisateurs de mettre à jour leentityStatus
de plusieurs éléments de campagne dans une même demande. - Nouvelle logique de ciblage qui nécessite
AssignedTargetingOption
ressources d'un sous-ensemble de types de ciblage attribuées et récupérées à l'aide de valeurs d'énumération au lieu des ID d'option de ciblage récupérées à l'aide du servicetargetingTypes.targetingOptions
.
Suivez les étapes de notre guide de migration pour passer de la version v1 à 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 partenaires 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:
Énumération 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:
Énumération 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:
Énumération 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
gérer les ressources GuaranteedOrder
via de nouvelles
les méthodes d'écriture du service inventorySources
et une nouvelle
guaranteedOrders
.
Introduction du champ modelReadiness
dans le
Ressource CustomBiddingAlgorithm
. Ce champ indique l'état de préparation
le modèle de l'algorithme pour chaque annonceur qui peut 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
afin de ne récupérer que les créations avec un updateTime
avant ou après un horodatage donné.
Ajout de la compatibilité avec la dernière version des fichiers SDF, v5.5, via le
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:
Énumération 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
Ajout de la possibilité de récupérer et de définir le ciblage sur la durée du contenu, le type de flux, et genre.
Ajout du champ billableOutcome
au InsertionOrder
.
Introduction du champ raiseBidForDeals
au
MaximizeSpendBidStrategy
, ce qui permet aux utilisateurs de définir si les enchères
applique les prix planchers de l'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:
Énumération Valeur(s) TargetingType
2 février 2022
Ajout de la compatibilité avec les fonctionnalités de création, de mise à jour et
modifier les membres de certains ciblages par liste de clients ;
Ressources : FirstAndThirdPartyAudience
La
la page Importer des audiences de ciblage par liste de clients dans la nouvelle
Le guide Utiliser les audiences explique en détail comment utiliser ces nouvelles fonctionnalités.
Introduction d'un nouveau champ reservationType
dans
InsertionOrder
et LineItem
Ressources qui identifient si une ressource est associée à un accord de tags garantis ou à un programmatique
Garanti ou non garanti.
Il est maintenant possible de récupérer un élément de campagne et de définir si celui-ci cible automatiquement ou non.
nouvelles places de marché via une nouvelle 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:
Énumération 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 éléments existants
customBiddingAlgorithms
- La possibilité d'importer des scripts via récupérer un emplacement de ressource disponible, puis importez le fichier à 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 qui décrit le processus de création d'un algorithme d'enchères personnalisées, d'importation d'un script et Attribuer 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 le
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:
Énumération 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
Il est maintenant possible de rechercher des
TARGETING_TYPE_BUSINESS_CHAIN
et
Options de ciblage de TARGETING_TYPE_POI
avec
targetingTypes.targetingOptions.search
, car elles ne peuvent pas
récupéré via targetingTypes.targetingOptions.get
ou
targetingTypes.targetingOptions.list
.
Introduction de sharedAdvertiserIds
et
customBiddingAlgorithmState
aux enchères personnalisées
Ressource d'algorithme et prise en charge supplémentaire de
GOAL_BUILDER_BASED
Type d'algorithme d'enchères personnalisées.
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:
Énumération 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 Open Measurement activé
le ciblage de l'inventaire sous le type de ciblage
TARGETING_TYPE_OMID
Augmentation du nombre maximal d'options de ciblage attribuées pouvant être renvoyées
sur une même page de plusieurs annonceurs, campagnes
Ciblage attribué à l'ordre d'insertion et à l'élément de campagne
de la liste d'options à 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:
Énumération Valeur(s) TargetingType La taille maximale de page a été augmentée pour les méthodes de liste suivantes:
26 mai 2021
Lancement du service advertisers.invoices
, qui permet
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 campagne
ressource. Vous pouvez associer des segments de budget d'ordre d'insertion
Un budget de campagne, ce qui limite le budget total
les segments associés au montant total du budget de la campagne.
Ajout de la prise en charge de
ciblage par position du contenu natif sous le nouveau
type de ciblage TARGETING_TYPE_NATIVE_CONTENT_POSITION
.
Introduction d'un nouveau champ prismaEnabled
à l'annonceur
qui permet aux utilisateurs d'activer l'intégration avec 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:
Énumération Valeur(s) AssignedTargetingOption.Recency Place de marché 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 dans Channel (Chaîne) et
Ressources de la liste de mots clés à exclure qui renvoient le nombre de lignes
qui utilisent cette ressource pour le ciblage. Nouveau filter
activé
de la méthode de création d'une liste d'éléments de campagne permettant à l'utilisateur
récupérer uniquement les éléments de campagne qui utilisent des critères ou des 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 avec les configurations par défaut. Ces valeurs par défaut sont basées sur type d'élément de campagne, ainsi que les paramètres et les rôles le ciblage de l'ordre d'insertion parent.
Il a permis de récupérer les données ciblées de la campagne à l'aide d'un nouveau service de ciblage des campagnes et méthode supplémentaire de listes groupées.
Élargissement du ciblage des applications afin de permettre le ciblage des applications sur d'autres plates-formes.
J'ai apporté plusieurs modifications à advertisers.channels.sites
.
partners.channels.sites
et
advertisers.negativeKeywordLists.negativeKeywords
services pour
Elles facilitent la gestion du contenu des chaînes et des listes de mots clés à exclure. Ces
les modifications suivantes sont apportées:
- L'ajout des méthodes
replace
, qui permet à un utilisateur d'écraser complètement le le contenu existant d'une chaîne ou d'une liste de mots clés à exclure. - La suppression de l'exigence selon laquelle
éléments doivent être inclus dans le
createdSites
oucreatedNegativeKeywords
champs de modification groupée requêtes. - Augmentation du nombre maximal d'articles pouvant être retournés pour un même article d'une liste de sites ou liste des 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 1000 partners.channels.sites.list 100 10000
Abandons
Les valeurs d'énumération suivantes ne peuvent plus être attribuées à des ressources nouvelles ou existantes:
Énumération Valeur(s) PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
24 février 2021
Lancement d'un nouveau service de ciblage des ordres d'insertion méthode supplémentaire de gestion groupée, qui permet de récupérer est attribué aux ordres d'insertion. La ressource de création a été développée, en ajoutant champs de création dédiés uniquement au rendu devant être utilisés par des créations audio tierces. Ajout de types d'objectifs de performances à utiliser par l'ordre d'insertion et la campagne ressources.
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:
Énumération Valeur(s) ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 janvier 2021
A permis de récupérer et de gérer les ordres d'insertion de type télévision et les services de distribution par contournement
via l'introduction
nouveau champ "InsertionOrderType" et
nouvelle valeur d'énumération LineItemType. Ajout de la prise en charge de l'application mobile
via un champ d'élément de campagne mobileApp
.
Développement de la place de marché, de l'audience Google et
la prise en charge de SDF via des valeurs d'énumération supplémentaires ; Introduction des
Possibilité de filtrer et d'organiser des advertisers.list
selon la date et l'heure de la dernière mise à jour.
Nouvelles fonctionnalités
Les champs suivants ont été ajoutés:
Ressource Champ(s) InsertionOrder LineItem Les valeurs enum suivantes ont été ajoutées:
Énumération Valeur(s) Place de marché 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 les options de ciblage par région géographique et filtrer plusieurs ressources ; Lister les résultats des méthodes en fonction de leur date de dernière mise à jour. Introduction d'une nouveau LineItemWarningMessage pour informer les utilisateurs lorsqu'un l'élément de campagne utilise le 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:
Énumération Valeur(s) Place de marché 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 déclencheurs manuels qui déclenchent l'exécution des éléments de campagne associés dépenses. Nous avons introduit des options d'élargissement du ciblage qui, peut étendre le ciblage d'un élément de campagne pour inclure des utilisateurs semblables ceux des audiences ciblées. Champs d'ID de segment personnalisé ajoutés à DoubleVerify et Integral Ad Science objets utilisés dans 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:
Énumération 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 à l'élément de campagne
et un objectif de performances de taux de clics (CTR). Ajoutée(s)
warningMessages
en tant que champ filtrable lorsque vous répertoriez des éléments de campagne.
En plus de 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:
Énumération 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. de nouveaux champs filtrables pour différentes méthodes de liste.
Nouvelles fonctionnalités
Les champs suivants ont été ajoutés:
Ressource Champ(s) Corps de la réponse aux annonceurs.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:
Énumération 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:
Énumération Valeur(s) Place de marché 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éatif 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ée(s) la gestion des ressources de base qui 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 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 Display & API Video 360 version 1. Il s'agit de la version initiale de l'API.
Problèmes connus
Aucun