Google Ads API version 20 maintenant disponible

Google a publié la version 20 de l'API Google ADS, il s'agit d'une version majeure, et nous nous attendons à deux autres versions majeures en 2025. Google a mis à jour la mise à jour de son calendrier de version API, il y a une nouvelle demande de demande AD_NETWORK_TYPE, des conversions comparables à la plate-forme et des mots clés négatifs au niveau de la campagne pour PMAX – plus plus.

Google a écrit:

Aujourd'hui, nous annonçons la version V20 de l'API Google ADS. Pour utiliser certaines des fonctionnalités V20, vous devez mettre à niveau vos bibliothèques clients et votre code client. Les bibliothèques clients et les exemples de code mis à jour seront publiés la semaine prochaine.

Avant cette version, la version 19.1 en avril 2025, puis 19 en février 2025, puis la version 18 en octobre 2024. Avant cela, 17.1 en août 2024, puis avant cela, la version 17.0 en juin 2024, puis avant cela, la version 16.1 puis la version 16 était publiée 2024. Avant cela, la version 15 en août. La version 13.1 a précédé cette nouvelle version, publiée en avril 2023. La version 12.0 a été publiée en octobre 2022, la version 11.0 de l'API Google Ads a été publiée en juin et la version 11.1 était en août. La version 10.1 a également été publiée le 27 avril 2022 et la version 10.0 a été publiée le 9 février 2022. Et Google a Sunset the AdWords API le 27 avril qui cessera complètement de travailler fin juillet.

Voici le calendrier de sortie:

Horaire de version de l'API Google ADS

Voici un résumé vidéo de ces changements:

https://www.youtube.com/watch?v=t1lbupgyrdm

Voici le journal de changement complet:

Actifs:

Ajout de plusieurs nouvelles métriques et colonnes de segment pour le rapport Asset_Group.

Nouvelles colonnes de métriques

Nouvelles colonnes de segment

Campagnes:

Ajout de la prise en charge de l'ajout et de la mise à jour des mots clés négatifs au niveau de la campagne pour les campagnes de performance maximum.

Conversions:

Vous pouvez désormais mettre à jour le champ Google_ADS_Conversion_Customer sur un client existant pour s'inscrire au suivi de conversion croisé, ou pour modifier son parent de suivi de conversion existant en un compte de gestionnaire différent.

Ajout du champ ClickConversion.User_IP_Address. Google ADS ne prend pas en charge la correspondance d'adresses IP pour les utilisateurs finaux dans le domaine économique européen (EEE), le Royaume-Uni (Royaume-Uni) ou la Suisse (CH). Veuillez ajouter une logique pour exclure conditionnellement le partage des adresses IP des utilisateurs de ces régions. Assurez-vous que vous fournissez aux utilisateurs des informations claires et complètes sur les données que vous collectez sur vos sites, applications et autres propriétés et obtenez le consentement, lorsque la loi ou les politiques Google applicables. Voir la page des importations de conversion hors ligne pour plus de détails.

Demande Gen:

Ajout de nouvelles valeurs au segment AD_NETWORK_TYPE qui permettent la segmentation des campagnes de Gen de la demande par canal: cartes, gmail, découvrir

Métriques ajoutées pour les conversions correspondant à la plate-forme

Recommandations:

Ajout du champ Merchant_ID à générateracomMendationsRequest pour indiquer quand des recommandations doivent être générées pour la vente au détail, plutôt que les campagnes de performance standard maximales.

Planification:

Ajout de l'auditoireInsightSDimension.youtube_lineup pour remplacer le publicInsightSdimension.youtube_dynamic_lineup dans AudityInsightsService et ContentCreatorinsightsService. Cette nouvelle dimension vous permet de récupérer les informations et les métadonnées pour les gammes YouTube Select (YTS). Remplacé des objets associés à YouTube_Dynamic_Lineup tels que DynamicLineUpAttributeMetAdata et le publicInsightSdynynamicLineup pour s'aligner sur la suppression plus large des gammes dynamiques à travers les publicités Google. Cette fonctionnalité n'est disponible que pour les comptes sur une liste d'autoroute.

Ajout d'une application supplémentaire enInfo et d'applicationInstance dans le publicInsightsService, ContentCreatorInSightsService et ReachPlanService. Cette fonctionnalité n'est disponible que pour les comptes sur une liste d'autoroute.

Mis à jour auditoireInsightsService et ContentCreatorInsightsService pour fournir des informations plus détaillées. Vous pouvez désormais segmenter des données de créateur de contenu par appareil à l'aide du nouveau publicInsightSdimension.device et d'audienceInsightSattribute.Device dans les deux services. Cette fonctionnalité n'est disponible que pour les comptes sur une liste d'autoroute.

Ajout de mesures vidéo agrégées supplémentaires à GenerateCreatOrsighTSResponse pour une analyse de créateur de contenu plus complète: Engagement_rate, moyen_views_per_video, moyen_likes_per_video, moyen_shares_per_video, moyen_comments_per_video, shorts_views_count, shorts_video_count, et est_brand_connect. Cette fonctionnalité n'est disponible que pour les comptes sur une liste d'autoroute.

Ajout de Sub_country_Locations à GenerateCreatorInsightSrequest pour le contenuCreatorinsightsService. Cela permet de spécifier les emplacements géographiques du sous-pays pour affiner les recherches pour les informations du créateur. Le champ Sub_country_locations n'est pris en charge que lors de l'utilisation de la recherche de recherche_attributes dans le champ des critères. Si sub_country_locations sont fournies avec d'autres types de critères, la demande ne sera pas valide. Cela permet un ciblage et une analyse géographiques plus granulaires pour les informations sur le créateur de contenu. Cette fonctionnalité n'est disponible que pour les comptes sur une liste d'autoroute.

Ajout de ReachPlanService.ListPlannableUserlists, qui renvoie les listes d'utilisateurs de premier parti appartenant à un client, et a ajouté UserListInfo aux options de ciblage de l'audience dans GeneraterEachForCastRequest. Cela vous permet de récupérer des listes d'utilisateurs planifiables pour un client donné, puis de générer des prévisions de portée pour les campagnes ciblant ces publics spécifiques. Ces améliorations améliorent la planification de la portée sur la taille en incorporant directement vos données d'audience de premier parti dans les prévisions. La prévision de réalisation est disponible pour autoriser les comptes en liste uniquement.

Vidéos:

Ajout des annonces AdformatType.Pause a servi sur des vidéos YouTube organiques sur les écrans de télévision, qui est inclus dans les rapports. Ces annonces sont affichées directement à côté de la trame vidéo statique sur l'écran de pause. Cela n'inclut pas les annonces vidéo de la demande GEN affichées sur le panneau de publicité ci-dessous ou au-dessus d'une vidéo organique interrompue, qui sont signalées sous Adformattype.infeed.

Discussion de forum à X.