La version 12.0 de l'API Google Ads est désormais disponible

Google a publié la version 12.0 de l’API Google Ads. La version 11.0 de l’API Google Ads est sortie en juin et la version 11.1 en août. La version 12.0 est une mise à jour majeure. La version 10.1 est également sortie le 27 avril 2022 et la version 10.0 est sortie le 9 février 2022. Et Google a mis fin à l’API AdWords le 27 avril, qui cessera complètement de fonctionner à la fin du mois de juillet. Google a publié une vidéo des principaux changements. en 12.0 :Voici tout ce qui est annoncé en version 12.0 :Gestion des comptes

  • Ajout d’un nouveau type de lien de compte, ADVERTISING_PARTNER pour lier un compte client à un autre. Il s’agit de la préparation d’une fonctionnalité à venir dans une prochaine version
  • Ajout de AccountLinkError.PERMISSION_DENIED pour le cas où un utilisateur non administrateur essaie de créer un lien de compte

Les publicités

/li>

Les atouts

  • Ajout de la prise en charge de la récupération de via à l’aide de GoogleAdsService.SearchStream ou GoogleAdsService.Search
  • Ajout de la prise en charge de l’ajout, de la mise à jour et de la suppression de CampaignAsset et AdGroupAsset avec le field_type comme AD_IMAGE (pour les clients autorisés uniquement)
  • Vous pouvez récupérer les statistiques des ressources Image (asset_field_type_view.field_type = AD_IMAGE) à l’aide du rapport asset_field_type_view
  • Le rapport asset_set_asset prend désormais en charge les métriques et les segments
  • Ajout de ad_group_ad_asset_view.pinned_field pour permettre le filtrage par un actif épinglé
  • Ajout de la prise en charge de segment.conversion_action au rapport ad_group_ad_asset_view
  • Ajout de la prise en charge de la liaison des clients et des groupes d’annonces avec des ensembles d’actifs pour les comptes de test uniquement
  • pour ajouter/mettre à jour/supprimer CustomerAssetSet, qui représente un lien entre un client et un AssetSet
  • pour ajouter/mettre à jour/supprimer AdGroupAssetSet, qui représente un lien entre un AdGroup et un AssetSet
  • Ajout de la prise en charge de la mutation et de la récupération des actifs de localisation pour les comptes de test uniquement.

  • Des champs:
  • Ajout de Asset.location_asset dont le type est LocationAsset
  • Ajout des champs suivants à AssetSet  :
  • location_group_parent_asset_set_id
  • asset_set_source (un des champs)
  • location_set (à utiliser avec CustomerAssetSet)
  • business_profile_location_group (à utiliser avec CampaignAssetSet et AdGroupAssetSet)
  • chain_location_group (à utiliser avec CampaignAssetSet et AdGroupAssetSet)
  • Ajout de exclude_parent_asset_set_types à la campagne et au groupe d’annonces
  • Énumérations  :
  • Ajout de AssetType.LOCATION
  • Ajout des valeurs suivantes à AssetSetType  :
  • LOCATION_SYNC
  • BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP
  • CHAIN_DYNAMIC_LOCATION_GROUP
  • STATIC_LOCATION_GROUP
  • Rapports (disponibles pour tous les comptes)  :
  • per_store_view renvoie des statistiques au niveau de l’ID de lieu
  • asset_set_type_view renvoie des statistiques au niveau AssetSetType, qui ne prend actuellement en charge que l’ensemble d’actifs d’emplacement

Publics

  • Ajout des valeurs suivantes à   : HIGH_AVERAGE_TRANSACTION_VALUE, LOW_AVERAGE_TRANSACTION_VALUE, NEWLY_OBSERVED_CURRENCY_CODE

Enchère

  • Ajout de la prise en charge des stratégies d’enchères de portefeuille liées et du budget de campagne. Les stratégies d’enchères et les budgets de campagne peuvent modifier ces liens à l’aide de mutations groupées  :
  • BiddingStrategy.aligned_campaign_budget_id
  • CampaignBudget.aligned_bidding_strategy_id

Facturation

  • Ajout de AccountSummary en tant que Invoice.account_summaries[] pour le rapprochement des rapports (pour les clients sur liste d’autorisation uniquement)
  • Ajout de BillingSetupError.TOO_MANY_BILLING_SETUPS_FOR_PAYMENTS_ACCOUNT
  • Ajout de.INVALID_MASTER_SERVICE_AGREEMENT

Campagnes

  • Modifications apportées aux campagnes intelligentes  :
  • Mise à jour de.SuggestKeywordThemes pour générer davantage de suggestions de thèmes de mots clés pour les campagnes intelligentes et peut suggérer des thèmes de mots clés de forme libre dans certains cas
  • Amélioration de la gestion des erreurs et ajout de codes d’erreur supplémentaires pour.SuggestKeywordThemes
  • Suppression de la prise en charge de la création de nouvelles campagnes Smart Display. Les campagnes Smart Display existantes sont toujours diffusées comme d’habitude
  • CREATE_OPERATION_NOT_PERMITTED est renvoyé si vous essayez de créer une nouvelle campagne Smart Display
  • Ajout des champs suivants à Campaign  :
  • primary_status pour fournir des informations sur les raisons pour lesquelles une campagne n’est pas diffusée ou n’est pas diffusée de manière optimale
  • primary_status_reasons pour expliquer pourquoi une campagne n’est pas diffusée ou n’est pas diffusée de manière optimale. Ces raisons sont agrégées pour déterminer primary_status
  • Activation de l’ajout et de la suppression du ciblage géographique dans les campagnes Local Services, à l’exception du ciblage de proximité
  • Ajout des erreurs suivantes à pour les campagnes de service local  :
  • AT_LEAST_ONE_POSITIVE_LOCATION_REQUIRED_FOR_LOCAL_SERVICES_CAMPAIGN
  • CANNOT_ADD_OR_REMOVE_LOCATION_FOR_LOCAL_SERVICES_CAMPAIGN
  • CANNOT_TARGET_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN
  • LOCATION_INVALID_FOR_LOCAL_SERVICES_CAMPAIGN
  • LOCATION_NOT_IN_HOME_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN
  • LOCATION_NOT_LAUNCHED_FOR_LOCAL_SERVICES_CAMPAIGN

Conversions

  • conversion_tracking_id sera toujours > 0 pour tous les clients. Auparavant, ce champ pouvait être 0 pour les clients qui n’avaient jamais créé d’actions de conversion auparavant
  • Ajout de debug_enabled pour effectuer toutes les vérifications et renvoyer les erreurs si elles sont trouvées lors du téléchargement des conversions améliorées

Critère

  • Ajout des champs d’ensemble d’actifs suivants à LocationGroupInfo pour les comptes de test  :
  • enable_customer_level_location_asset_set
  • location_group_asset_sets
  • Ajout des valeurs suivantes à CriterionError  :
  • CANNOT_SET_ASSET_SET_FIELD_FOR_CUSTOMER
  • CANNOT_SET_ASSET_SETS_WITH_FEED_ITEM_SETS
  • CANNOT_SET_BOTH_ASSET_SET_AND_FEED
  • CANNOT_SET_FEED_OR_FEED_ITEM_SETS_FOR_CUSTOMER
  • CANNOT_SET_GEO_TARGET_CONSTANTS_WITH_ASSET_SETS
  • INVALID_LOCATION_GROUP_ASSET_SETS

les erreurs

  • Les codes d’erreur renvoyés pour certaines opérations non valides ont changé pour les champs suivants
  • BiddingStrategy.currency_code
  • BiddingStrategy.schemeBiddingStrategy.scheme
  • Type de stratégie d’enchères
  • TargetCpa.target_cpa_micros
  • TargetImpressionShare.cpc_bid_ceiling_micros
  • TargetSpend.target_spend_micros (obsolète)

Expériences

  • Suppression de au profit des nouvelles expériences précédemment ajoutées. Renommé ExperimentArm.trial en ExperimentArm.experiment
  • Lorsque vous créez un nouveau bras de test à l’aide de MutateExperimentArms et que vous définissez response_content_type de votre demande de mutation sur MUTABLE_RESOURCE, il remplit désormais également des valeurs dans ExperimentArm.in_design_campaigns

Flux

  • Ajout de LEGACY_FEED_TYPE_READ_ONLY aux énumérations suivantes  : CampaignFeedError, FeedItemError, FeedMappingError

Planification

  • accepte désormais.GEO_TARGET_COUNTRY et.SUB_COUNTRY_LOCATION, permettant aux clients de découvrir les critères de localisation pouvant être utilisés dans
  • Ajout de. (disponible uniquement pour les comptes autorisés), permettant aux clients de découvrir l’ensemble des plages de dates pouvant être utilisées dans
  • Suppression de de ReachPlanService
  • Ajout de Targeting.plannable_location_ids, qui prend en charge le ciblage de plusieurs emplacements géographiques au sein du même emplacement parent dans une seule prévision d’audience

Recommandations

  • Ajout de qui identifie les ajustements de CPA cible pour aider les campagnes à commencer à être diffusées
  • Ajout de qui identifie les ajustements du ROAS cible pour capturer une valeur de conversion supplémentaire à partir des augmentations de trafic prévues

Rapports

  • Ajout de la prise en charge du renvoi du nombre de clics pour les liens annexes (lorsque segments.click_type = SITELINKS) dans le rapport landing_page_view
  • Ajout des métriques de trafic acheté suivantes  : metrics.publisher_purchased_clicks, metrics.publisher_organic_clicks, metrics.publisher_unknown_clicks

Forum de discussion sur Twitter.