API Google Ads version 8.0

Google a publié la version 8.0 de l’API Google Ads qui comprend une tonne de nouvelles fonctionnalités, notamment des stratégies d’enchères entre comptes, la récupération d’étiquettes, la prise en charge de CallAdInfo, la prise en charge des données de panier pour les conversions, la prise en charge des campagnes intelligentes et bien plus encore. La version 7.0 de l’API Google Ads a été publiée le 28 avril 2021, il y a seulement 6 semaines. Google a même publié une vidéo sur les nouveautés de la version 8 de l’API Google Ads  :Voici toutes les nouveautés de la version 8.0  :Gestion de compte

  • Ajout de CustomerClient.applied_labels pour afficher les étiquettes appliquées aux clients gérés par le client gestionnaire demandeur

Les publicités

  • CallOnlyAdInfo est remplacé par CallAdInfo
  • Ajout de CANNOT_UPDATE_DEPRECATED_ADS à AdGroupAdError

Actif

  • Définissez response_content_type sur MUTABLE_RESOURCE en tant que paramètre de demande pour renvoyer tous les champs mutés dans une demande de mutation pour CustomerAssetService, CampaignAssetService et AdGroupAssetService
  • Ajout de la prise en charge des métriques suivantes pour CustomerAsset, CampaignAsset et AdGroupAsset  : Absolute_top_impression_percentage, all_conversions, all_conversions_from_interactions_rate, all_conversions_value, average_cost, average_cpc, average_cpe, average_cpm, average_cpv, clicks, conversions_interactions_value, cost_interactions_con, engagement_conversions, moyenne_cpc, average_cpe, average_cpm, average_cpv, clicks, conversions_interactions_con, engagements, interactions, interaction_event_types, interaction_rate, impressions, top_impression_percentage, value_per_all_conversions, value_per_conversion, video_view_rate, video_views
  • Segments.asset_interaction_target ajoutés pour CustomerAsset, CampaignAsset et AdGroupAsset pour indiquer si les interactions concernent l’actif lui-même
  • Ajout de pour prendre en charge la récupération des métriques pour chaque type de champ d’actif lorsque l’actif est utilisé comme extension
  • Mise à jour des valeurs suivantes de   : remplacement de GIVEN_NAME par FIRST_NAME et remplacement de FAMILY_NAME par LAST_NAME
  • Les extensions basées sur les actifs  : SitelinkAsset, CalloutAsset, , qui étaient disponibles pour les comptes de test dans la version 7, seront activées pour les comptes de production deux semaines après cette version

Publics

  • Ajout de TransactionAttribute.item_attribute pour prendre en charge les informations d’association sur un article vendu avec une transaction
  • Ajout des champs suivants à UserAttribute  : last_purchase_date_time, average_purchase_count, average_purchase_value_micros, acquisition_date_time
  • Ajout des valeurs suivantes à   : FUTURE_TIME_NOT_ALLOWED et LAST_PURCHASE_TIME_LESS_THAN_ACQUISITION_TIME

Enchère

  • Mise à jour de Maximize_conversion_value.target_roas pour prendre en charge un paramètre ROAS cible facultatif sur le portefeuille Maximiser la valeur de conversion et des stratégies d’enchères standard pour les campagnes sur le Réseau de Recherche. Ce champ deviendra modifiable pour tous les clients à une date ultérieure. Nous publierons une notification sur le blog des développeurs Google Ads lorsque les développeurs pourront mettre à jour ce champ
  • Mise à jour de Maximize_conversions.target_cpa pour prendre en charge un paramètre de CPA cible facultatif sur le portefeuille Maximize Conversions et des stratégies d’enchères standard pour les campagnes sur le Réseau de Recherche. Ce champ deviendra modifiable pour tous les clients à une date ultérieure. Nous publierons une notification sur le blog des développeurs Google Ads lorsque les développeurs pourront mettre à jour ce champ
  • Ajout de la prise en charge de [creating and managing cross-account bidding strategies]/google-ads/api/docs/campaigns/bidding/cross-account-strategies) dans les comptes administrateur, et la possibilité de les associer à des campagnes dans les comptes clients  :
    • Ajout de BiddingStrategy.currency_code pour les stratégies d’enchères dans les clients gestionnaires, qui peut être défini lors de la création et par défaut la devise du client gestionnaire. Pour servir les clients, ce champ ne peut pas être défini ; toutes les stratégies d’un client de service utilisent implicitement la devise du client de service. Dans tous les cas, le champ effective_currency_code renvoie la devise utilisée par la stratégie
    • Ajout de pour représenter une vue de toutes les stratégies d’enchères détenues et partagées avec le client
    • Ajout de pour lire les stratégies d’enchères accessibles
    • Ajout de Campaign.accessible_bidding_strategy pour récupérer les champs de la stratégie d’enchères de portefeuille identifiés par bidding_strategy. Lorsqu’une campagne utilise une stratégie d’enchères entre comptes, il s’agit d’un sous-ensemble des propriétés normalement définies pour une stratégie d’enchères, car certaines propriétés ne sont accessibles que par propriétaire d’une stratégie d’enchères

Campagnes

    Remplacement de CampaignError.PAYMENT_MODE_NOT_COMPATIBLE_WITH_VIEW_THROUGH_CONVERSION par CampaignError.NOT_COMPATIBLE_WITH_VIEW_THROUGH_CONVERSION_OPTIMIZATION. Signale les incompatibilités avec la configuration de l’affichage via les conversions.
  • Ajout de la prise en charge des campagnes intelligentes  :
    • Ajout de nouvelles valeurs d’énumération pour prendre en charge les campagnes intelligentes  : BudgetTypeEnum.SMART_CAMPAIGN

      AdGroupTypeEnum.SMART_CAMPAIGN_ADS et ajout de SmartCampaignSetting et pour configurer les campagnes intelligentes

    • Ajout de et pour récupérer des suggestions de budgets de campagne Smart et de thèmes de mots clés
    • Ajout de smart_campaign_search_term_view pour récupérer les métriques de performances des campagnes intelligentes

Conversions

  • Ajout de ClickConversion.cart_data pour prendre en charge le téléchargement des conversions avec les informations du panier
  • Ajout de CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY à ConversionUploadError

Critères

  • Ajout de pour récupérer UserInterest avec DetailDemographic comme TaxonomyType

Flux

  • Ajout de DYNAMIC_FILTER_INVALID_CHAIN_IDS à FeedItemSetError

Recommandations

  • Ajout de la prise en charge des champs suivants pour les ressources Client et Campagne. segments.recommendation_type, metrics.optimization_score_url et metrics.optimization_score_uplift

Forum de discussion sur Twitter.