Version 17 (05/06/2024)
Les fonctionnalités et modifications suivantes ont été ajoutées dans la v17.
Annonces
- Suppression de
AdService.getAd
. Cela permet d'alignerAdService
sur les autres services de l'API Google Ads. Consultez la section Récupérer des objets pour connaître la méthode recommandée pour récupérer des annonces et d'autres types de ressources. - Ajout d'autres validations pour
ImageAdInfo.image_asset
concernant les dimensions et le format. Les erreurs suivantes peuvent être générées si l'image n'est pas valide :
Assets
- Ajout d'une énumération:
ClickType.AD_IMAGE
- Ajout des rapports suivants, incluant de nouvelles métriques pour les campagnes Performance Max et sur le Réseau de Recherche :
Audiences
Jobs Batch
- Ajout de
BatchJobError.REQUEST_TOO_LARGE
, qui sera généré lorsque la valeurAddBatchJobOperationsRequest
envoyée dépassera 10 484 504 octets. - Ajout de la possibilité de définir
MutateOperation.asset_group_operation
lors de l'utilisation deBatchJobService
. Cela vous permet d'utiliser le traitement par lot pour créer et gérer des campagnes Performance Max entières. Consultez notre nouveau guide dédié.
Campagnes
- Discovery a été renommé "Génération de la demande" pour tous les champs, énumérations et erreurs de toutes les ressources dans l'API Google Ads (campagnes, annonces et composants, par exemple). Par exemple,
AdvertisingChannelType.DISCOVERY
est désormaisAdvertisingChannelType.DEMAND_GEN
. - Ajout de
Campaign.keyword_match_type
pour vous permettre de définir le type de correspondance des mots clés pour tous les mots clés d'une campagne.
Conversions
- Pour les conversions SKAdNetwork,
- Remplacement du nom de
segments.sk_ad_network_conversion_value
parsegments.sk_ad_network_fine_conversion_value
. - Ajout de
segments.sk_ad_network_redistributed_fine_conversion_value
.
- Remplacement du nom de
- Les métriques suivantes sont désormais renvoyées avec la réponse, même lorsqu'elles sont égales à zéro. Ils sont ainsi cohérents avec les autres métriques.
Critères
- Ajout aux champs suivants dans
AdGroupCriterion
pour indiquer si le critère du groupe d'annonces est diffusé ou pourquoi il ne l'est pas :primary_status
primary_status_reasons
- Ajout de la prise en charge de
metrics.search_impression_share
pourgender_view
. - Ajout de la prise en charge de
metrics.phone_calls
pourkeyword_view
.
Local Services
- Ajout de
LocalServicesLeadService.AppendLeadConversation()
pour ajouter un nouveauLocalServicesLeadConversation
àLocalServicesLead
, qui envoie les messages aux utilisateurs via les canaux appropriés tels que les SMS en fonction de la façon dont le prospect a été créé.- La taille de
AppendLeadConversationRequest.conversations
est limitée à 1 000. - Seul
LocalServicesLead
aveclead_type
défini surLeadType.MESSAGE
peut être spécifié dansConversation.local_services_lead
.
- La taille de
- Ajout de nouvelles valeurs d'énumération à
ConversationType
:WHATSAPP
pour représenter une conversation introduite dans WhatsApp.ADS_API
pour représenter une conversation introduite à l'aide de la nouvelle méthodeLocalServicesLeadService.AppendLeadConversation()
.
- Ajout des champs suivants à
local_services_verification_artifact
:local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
local_services_verification_artifact.license_verification_artifact.expiration_date_time
Fréquence
- Vous ne pouvez désormais sélectionner que les champs associés à un produit associé lorsque vous interrogez
product_link
. La sélection de plusieurs champs de plusieurs produits associés génère une erreurQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
. Par exemple,product_link.advertising_partner.customer
etproduct_link.data_partner.data_partner_id
ne peuvent pas être sélectionnés dans la même requête. - La transmission d'un
page_size
àGoogleAdsService.Search
entraîne une erreurRequestError.PAGE_SIZE_NOT_SUPPORTED
.
Shopping
- Ajout d'un rapport
shopping_product
, qui correspond à la page Produits de l'interface utilisateur Google Ads. Il permet d'afficher les données liées à l'état actuel des produits à partir de comptes Google Merchant Center associés à un compte Google Ads.- Vous pouvez filtrer les métriques du rapport
shopping_product
à l'aide desegments.date
lorsque vous utilisezGoogleAdsService.Search
ouGoogleAdsService.SearchStream
. La segmentation par date n'est pas autorisée et renverra une erreurShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Vous pouvez filtrer les métriques du rapport
Objectifs unifiés
- Ajout de
UserListCustomerTypeService.MutateUserListCustomerTypes()
pour configurer les types de clients de l'audience. - Suppression de
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
. Pour configurer les paramètres d'audience des objectifs de cycle de vie des clients, utilisez plutôtUserListCustomerTypeService.MutateUserListCustomerTypes()
.- Associez ou dissociez une liste d'utilisateurs en définissant
UserListCustomerType.customer_type_category
surUserListCustomerTypeCategory.PURCHASERS
pour l'inclure ou l'exclure respectivement d'une définition de client existante pour les objectifs de cycle de vie des clients. Pour en savoir plus, consultez Segmenter vos audiences.
- Associez ou dissociez une liste d'utilisateurs en définissant
Vidéos
- Ajout des valeurs suivantes à
ContentLabelType
. Vous pouvez exclure cesContentLabelTypes
au niveau du client :BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
BRAND_SUITABILITY_GAMES_FIGHTING
BRAND_SUITABILITY_GAMES_MATURE
BRAND_SUITABILITY_HEALTH_SENSITIVE
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
BRAND_SUITABILITY_NEWS_RECENT
BRAND_SUITABILITY_NEWS_SENSITIVE
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
BRAND_SUITABILITY_POLITICS
BRAND_SUITABILITY_RELIGION
- Ajout de
AdVideoAsset.ad_video_asset_info
pour prendre en charge les préférences d'inventaire pour les éléments vidéo lors de la création deDemandGenVideoResponsiveAdInfo
. - (Comptes ajoutés à la liste d'autorisation uniquement) Modification de
Campaign.video_brand_safety_suitability
effectuée.
Version 16.1.0 (24/04/2024)
Les fonctionnalités et modifications suivantes ont été ajoutées dans la version 16.1.
Gestion du compte
CustomerNegativeCriterion.ip_block
, qui permet d'ajouter une adresse IP comme critère négatif au niveau du client.- Nouvelle valeur d'énumération :
ProductLinkError.LINK_EXISTS
. - Nouvelle valeur d'énumération :
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
Assets
- Compatibilité avec les composants liés à la génération de la demande pour
ad_group_ad_asset_view
etasset_field_type_view
. - Nouvelle valeur d'énumération :
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
Audiences
- Nouvelle valeur d'énumération:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
, qui limite à 1 000 le nombre de listes d'utilisateurs similaires qu'un client peut avoir.
Campagnes
- Prise en charge des simulations d'enchères de campagne au ROAS cible pour les campagnes pour applications à l'aide du rapport
campaign_simulation
. - Nouvelle valeur d'énumération :
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
. - Nouvelle valeur d'énumération :
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
. - Nouvelle valeur d'énumération :
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
.
Conversions
SkAdNetworkConversionValueSchema.postback_mappings
, qui est compatible avec les fonctionnalités de SKAdNetwork 4.0.- Ajout de la prise en charge des avertissements pour
CustomerSkAdNetworkConversionValueSchemaService
en tant queMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. Si défini surtrue
, toutes les erreurs non bloquantes liées aux échecs d'opération sont renvoyées sous la formeMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
. - Nouvelles valeurs d'énumération dans
CustomerSkAdNetworkConversionValueSchemaError
:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
Critères
- Nouveaux champs dans
BrandInfo
:display_name
primary_url
rejection_reason
status
- Nouvelle énumération :
BrandRequestRejectionReason
. - Nouvelle valeur d'énumération :
CriterionType.LIFE_EVENT
.
Tests
- Nouvelle valeur d'énumération:
ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT
.
Local Services
local_services_lead.credit_details.credit_state
etlocal_services_lead.credit_details.credit_state_last_update_date_time
, qui renvoient respectivement l'état du crédit et le code temporel correspondant à la mise à jour de l'état du crédit.local_services_lead_conversation.message_details.attachment_urls
, qui renvoie les URL permettant de télécharger le contenu de la pièce jointe.
Vidéos
customer.video_brand_safety_suitability
etBrandSafetySuitability
, qui permettent de récupérer la brand safety vidéo au niveau du client.- Nouvelle valeur d'énumération:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
Version 16 (21/02/2024)
Les fonctionnalités et modifications suivantes ont été ajoutées dans la v16.
Gestion du compte
- Migration de
advertising_partner
deAccountLink
versProductLink
etProductLinkInvitation
. - Suppression de
data_partner
etgoogle_ads
deAccountLink
. - Ajout de
IdentityVerificationService
pour gérer la validation des annonceurs.StartIdentityVerification()
permet de démarrer une session de validation à l'aide duverification_program
fourni. Il crée une session de validation et renvoie une réponse vide si la validation a bien été créée.GetIdentityVerification()
peut être utilisé pour récupérer les informations de validation, ce qui renvoie plusieurs objets deIdentityVerification
. ChaqueIdentityVerification
inclut les éléments suivants :verification_program
, qui est le type de programme de validation de l'identitéidentity_verification_requirement
, qui contient des informations sur le délai avant lequel l'annonceur doit terminer la validationverification_progress
contenant des informations sur la session de validation, y compris :program_status
représente l'état actuel de cette session de validation.action_url
redirige le client vers une URL pour terminer la validation.invitation_link_expiration_time
représente la date d'expiration de l'élémentaction_url
.
- Énumérations :
- Erreurs :
- Ajout de
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
.
Assets
- Modifications apportées à
asset_group
:- Ajout de la prise en charge des segments liés au temps, tels que
segments.year
etsegments.month
. - Conversion de
campaign
en ressource attribuée au lieu de segmenter la ressource.
- Ajout de la prise en charge des segments liés au temps, tels que
Campagnes
- Modifications apportées aux campagnes de génération de la demande :
- Ajout de la possibilité de définir
Campaign.shopping_setting
dans une campagne de génération de la demande existante. - Ajout de
ShoppingSetting.disable_product_feed
pour désactiver le flux de produits facultatif des campagnes de génération de la demande. - Ajout de
Ad.demand_gen_product_ad
et duDemandGenProductAdInfo
correspondant, disponible pour les campagnes de génération de la demande avec unCampaign.shopping_setting
non nul.
- Ajout de la possibilité de définir
- Ajout aux champs suivants dans
AdGroup
pour indiquer si le groupe d'annonces est diffusé ou pourquoi il ne l'est pas :primary_status
primary_status_reasons
- Ajout aux champs suivants dans
AdGroupAd
pour indiquer si l'annonce du groupe d'annonces est diffusée ou pourquoi elle ne l'est pas :primary_status
primary_status_reasons
- Ajout des valeurs suivantes à
AdGroupError
:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Test
- Ajout de
Experiment.sync_enabled
pour indiquer si la synchronisation doit être activée dans le test. Lorsque la synchronisation est activée, les modifications apportées à la campagne d'origine pendant l'exécution du test sont automatiquement copiées dans la campagne test. - Ajout de
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
. - Ajout de
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
.
Hôtel et voyage
- Ajout des champs suivants à
ListingDimensionInfo
pour une annonce Activités à découvrir afin de permettre la création de groupes de fiches en fonction de l'État et de la ville où l'activité de voyage est disponible : - Ajout de la prise en charge des segments suivants dans
travel_activity_performance_view
:
Local Services
- Ajout de
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
etBusinessRegistrationCheckArtifact
pour permettre aux annonceurs de surveiller la progression de la procédure de validation de l'immatriculation de l'entreprise. - Ajout d'une nouvelle ressource
local_services_employee
pour permettre aux annonceurs de récupérer les informations sur les employés qu'ils ont ajoutées.
Planifier
- Suppression de
score
deAudienceInsightsAttributeMetadata
.
Recommandations
- Ajout de
RecommendationService.GenerateRecommendations()
, qui renvoie des recommandations en fonction des paramètres spécifiés, tels que les types de recommandations et de canaux publicitaires. Cela est particulièrement utile lorsque vous créez une campagne. - Ajout de
RecommendationMetrics.conversions_value
. - Pour les mots clés recommandés dont le type de correspondance des mots clés n'est pas défini,
recommended_match_type
est désormais défini surUNSPECIFIED
au lieu deUNKNOWN
. - Ajout des types de recommandations suivants :
MAXIMIZE_CONVERSION_VALUE_OPT_IN
, qui recommande d'activer la stratégie d'enchères "Maximiser la valeur de conversion"IMPROVE_GOOGLE_TAG_COVERAGE
, qui recommande de déployer la balise Google sur plus de pagesPERFORMANCE_MAX_FINAL_URL_OPT_IN
, qui recommande d'activer l'extension d'URL finale pour vos campagnes Performance MaxREFRESH_CUSTOMER_MATCH_LIST
, qui recommande de mettre à jour une liste de clients qui n'a pas été mise à jour au cours des 90 derniers joursCUSTOM_AUDIENCE_OPT_IN
, qui recommande de créer une audience personnaliséeLEAD_FORM_ASSET
, qui recommande d'ajouter des composants Formulaire pour prospects au niveau de la campagne ou du clientIMPROVE_DEMAND_GEN_AD_STRENGTH
, qui recommande d'améliorer l'efficacité des annonces dans les campagnes de génération de la demande
Shopping
- Ajout de
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
etCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
afin de fournir des informations plus détaillées sur les erreurs des campagnes Shopping associées à un compte Comparison Shopping Service Center. - Ajout des valeurs suivantes à
AssetGroupListingGroupFilterError
:DIMENSION_TYPE_NOT_ALLOWED
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
FILTER_EXCLUSION_NOT_ALLOWED
LISTING_SOURCE_NOT_ALLOWED
MULTIPLE_LISTING_SOURCES
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
PAGE_FEED_FILTER_HAS_PARENT
Objectifs du cycle de vie
- Ajout de
update
àCustomerLifecycleGoalOperation
etCampaignLifecycleGoalOperation
pour rendre ces types d'opérations cohérents avec les autres types d'opérations dans l'API.
Version 15 (18/10/2023)
Les nouvelles fonctionnalités et mises à jour suivantes ont été introduites dans la v15.
Gestion du compte
- Si votre compte est suspendu en raison d'une activité non autorisée,
customer.status
etcustomer_client.status
sont désormais renvoyés en tant queSUSPENDED
. Auparavant, ils étaient renvoyés en tant queENABLED
. - Il est désormais possible d'ajouter et de supprimer une association entre un compte Google Ads et un compte Merchant Center :
- Ajout de
ProductLink.merchant_center
etMerchantCenterIdentifier
. - Ajout de
LinkedProductType.MERCHANT_CENTER
.
- Ajout de
- Ajout de
ProductLinkInvitationService
etProductLinkInvitation
pour permettre la mise à jour d'une invitation d'association envoyée depuis d'autres produits, disponible pour les comptes Hotel Center et Merchant Center. - Suppression de
MerchantCenterLinkService
.- Pour associer des comptes Google Ads à des comptes Merchant Center, utilisez
ProductLinkInvitationService
etProductLinkService
.
- Pour associer des comptes Google Ads à des comptes Merchant Center, utilisez
- Suppression de
AccountLink.hotel_center
et de la prise en charge de la mise à jour des invitations d'association dans les comptes Hotel Center à l'aide deAccountLinkService
.- Pour mettre à jour une demande d'association à partir d'un compte Hotel Center, utilisez
ProductLinkInvitationService
.
- Pour mettre à jour une demande d'association à partir d'un compte Hotel Center, utilisez
Assets
- Remplacement de
ImageAdInfo.media_file
parImageAdInfo.image_asset
pour permettre l'ajout et la suppression d'images à l'aide des assets. Par conséquent, nous avons également suppriméMediaFileService
, qui n'est plus nécessaire. - Ajout de
ListingGroupFilterDimension.webpage
pour permettre la création d'un filtre de groupe de fiches basé sur des étiquettes personnalisées et des sous-chaînes d'URL.- Remplacement également de
AssetGroupListingGroupFilter.vertical
parAssetGroupListingGroupFilter.listing_source
etListingGroupFilterListingSource
- Remplacement également de
- Ajout de
asset_group_asset.source
pour afficher la source de l'élément du groupe d'assets. - Ajout de
ad_group_ad_asset_view.source
pour afficher la source du composant d'annonce du groupe d'annonces.
Audiences
- Pour le ciblage par liste de clients, ajout de
CustomerMatchUserListMetadata.consent
afin de permettre de fournir un consentement. À compter du 6 mars 2024, si le consentement est manquant pour les utilisateurs de l'EEE, sa valeur sera déterminée comme n'ayant pas donné son consentement. Les données provenant d'utilisateurs de l'EEE n'ayant pas donné leur consentement ne seront pas traitées et ne peuvent pas servir à personnaliser des annonces à l'aide du ciblage par liste de clients. Pour en savoir plus, consultez notre guide sur le ciblage par liste de clients. - Pour les ventes en magasin, ajout de
UserData.consent
pour permettre de fournir un consentement. Pour en savoir plus, consultez notre guide sur les ventes en magasin. Si vous utilisez le ciblage par liste de clients avec les ventes en magasin, consultez les questions fréquentes pour en savoir plus. - Ajout de
UserList.lookalike_user_list
pour permettre la création d'un segment similaire, une audience créée à partir de l'audience source existante fournie. Les segments similaires ne peuvent être utilisés que dans une campagne de génération de la demande.
Campagnes
Modifications apportées aux campagnes Performance Max:
AssetGroupSignal
est désormais compatible avec deux types de signaux qui peuvent être associés à un groupe d'assets pour le ciblage amélioré :AssetGroupSignal.audience
- Ajout de
Audience.scope
etAudience.asset_group
pour limiter l'utilisation de l'audience à un groupe d'assets spécifique.Audience.asset_group
doit être défini si et seulement siAudience.scope
est défini surASSET_GROUP
.
- Ajout de
AssetGroupSignal.search_theme
- Ajout de
CriterionType.SEARCH_THEME
pour prendre en charge ce nouveau type de critère. Ce nouveau type de critère ne peut être utilisé que dans les campagnes Performance Max pour créer unAssetGroupSignal
en ajoutant un critèreSearchThemeInfo
àAssetGroupSignal.search_theme
.
- Ajout de
- Ajout de
AssetGroupSignalOperation.exempt_policy_violation_keys
pour permettre de demander une exception lors de l'ajout de signaux de groupe d'assets. - Ajout d'un
asset_group_top_combination_view
pour générer des rapports sur les assets les plus performants au niveau du groupe d'assets. asset_group
peut désormais être interrogé avec des champs de métriques afin de permettre de récupérer les performances d'une campagne Performance Max.- Dans
PerformanceMaxUpgradeStatus
,UPGRADE_ELIGIBLE
a été renomméUPGRADE_ELIGIBLE
.
Pour les campagnes au CPA cible Discovery et de génération de la demande, les simulations d'enchères au CPA cible au niveau de la campagne (
campaign_simulation.target_cpa_point_list.points
) renvoient désormaisTargetCpaSimulationPoint.interactions
au lieu deTargetCpaSimulationPoint.clicks
.Ajout de
BrandSuggestionService
, qui peut suggérer des marques en fonction du préfixe de marque fourni et de la liste de marques exclues. Ces marques peuvent être utilisées pour créer un critèreBRAND
, l'ajouter à un ensemble partagéBRANDS
, puis l'associer à une campagne en créant unCampaignCriterion
avec le paramètrebrand_list
défini sur l'ensemble partagé. Les critères de campagne peuvent être ciblés dans les campagnes sur le Réseau de Recherche et exclus dans les campagnes Performance Max.- Champs :
- Énumérations :
Ajout de
Campaign.asset_automation_settings[]
pour afficher l'état d'automatisation de chaque type d'asset.Ajout des valeurs suivantes à l'énumération
CampaignPrimaryStatusReason
:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversions
- Ajout de
CallConversion.consent
etClickConversion.consent
pour permettre l'envoi d'un consentement. Pour en savoir plus, consultez notre guide des conversions par appel et le guide des conversions par clic. - Ajout des champs suivants liés aux conversions SKAdNetwork, disponibles lorsque vous les interrogez avec
customer
oucampaign
: - Remplacement de
metrics.sk_ad_network_conversions
parmetrics.sk_ad_network_installs
. - Il est désormais possible de diagnostiquer l'importation des conversions hors connexion.
- Déplacement de
offline_conversion_upload_client_summary
d'un champ de la ressourcecustomer
vers un rapport de niveau supérieur. Utilisez ce rapport pour obtenir des informations utiles sur l'état de l'importation des conversions, tels que le nombre d'événements réussis, le taux de réussite et le pourcentage d'erreur.- Mise en garde: une conversion importée qui génère une erreur
ConversionUploadError.CLICK_NOT_FOUND
est toujours comptabilisée comme réussie, mais elle est également signalée commeOfflineConversionAlert
.
- Mise en garde: une conversion importée qui génère une erreur
- Ajout de
job_id
en tant que paramètre facultatif pour les types de requêtes suivants afin que vous puissiez regrouper logiquement plusieurs requêtes d'importation dans une seule tâche conceptuelle : - Ajout de
INVALID_JOB_ID
aux erreurs suivantes : - Remplacement de
INVALID_CONVERSION_ACTION
parNO_CONVERSION_ACTION_FOUND
etINVALID_CONVERSION_ACTION_TYPE
dans les erreurs suivantes :
- Déplacement de
- Ajout de trois rapports pour prendre en charge l'attribution multiréseau sans redirection de la Privacy Sandbox sur Android :
android_privacy_shared_key_google_campaign
, qui contientshared_campaign_key
et des champs permettant d'encoder la clé.android_privacy_shared_key_google_ad_group
, qui contientshared_ad_group_key
et des champs permettant d'encoder la clé.android_privacy_shared_key_google_network_type
, qui contientshared_network_type_key
et des champs permettant d'encoder la clé.
- Ajout de
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
. UnConversionActionOperation
qui tente d'utiliser l'un des modèles d'attribution basés sur des règles obsolètes échoue désormais avec cette erreur. Auparavant, l'opération échouait avec une erreurUNKNOWN
.
Hôtel et voyage
- Ajout de la prise en charge des champs suivants dans
travel_activity_group_view
ettravel_activity_performance_view
:- Segments:
- Métriques :
metrics.search_absolute_top_impression_share
metrics.search_budget_lost_absolute_top_impression_share
metrics.search_budget_lost_impression_share
metrics.search_budget_lost_top_impression_share
metrics.search_impression_share
metrics.search_rank_lost_absolute_top_impression_share
metrics.search_rank_lost_impression_share
metrics.search_rank_lost_top_impression_share
metrics.search_top_impression_share
Annonces Local Services
- Ajout de
LocalServicesSettings
et de ses champs au rapportcustomer
pour afficher les états précis des licences et des assurances d'un annonceur Local Services. - Ajout des nouveaux rapports suivants pour les services de proximité :
local_services_lead
contient toutes les informations concernant les prospects Annonces Local Services, telles quelead_charged
,lead_type
etlead_status
.- Énumérations :
local_services_lead_conversation
contient les détails du message et de la conversation téléphonique, tels queconversation_channel
,call_duration_millis
oucall_recording_url
.- L'URL d'enregistrement des appels téléphoniques est authentifiée par rapport au compte client cible et à ses comptes administrateur.
local_services_verification_artifact
renvoie les artefacts d'un annonceur Local Services, tels que la vérification des antécédents, les licences professionnelles et les données d'assurance professionnelle. Tous les documents associés à la licence et à l'assurance sont accessibles via une URL.
Planifier
- Ajout de la possibilité de renvoyer
Forecast.views
etPlannedProductForecast.views
pourReachPlanService.ListPlannableProducts
pour les types de produits applicables. - Ajout de la possibilité de renvoyer
PlannableTargeting.surface_targeting
pourReachPlanService.ListPlannableProducts
, qui décrit les surfaces disponibles pour un produit. - Ajout d'une nouvelle énumération
ReachPlanSurface
. - Ajout de la possibilité de cibler la fréquence cible à l'aide de
AdvancedProductTargeting.target_frequency_settings
, qui renvoiePlannedProductForecast.average_frequency
. - Ajout de
AudienceInsightsService.GenerateSuggestedTargetingInsights
pour renvoyer des suggestions d'audiences pouvant être ciblées. - Ajout des valeurs suivantes à
ReachPlanError
:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Recommandations
- Ajout de
RecommendationSubscriptionService
, qui gère les abonnements aux recommandations : - Ajout des types de recommandations suivants :
FORECASTING_SET_TARGET_CPA
, qui recommande de définir un CPA cible pour les campagnes pour lesquelles aucun CPA n'est spécifié, avant un événement saisonnier susceptible d'augmenter le trafic, selon les prévisions.SET_TARGET_CPA
, qui recommande de définir un CPA cible pour les campagnes sans en spécifier unSET_TARGET_ROAS
, qui recommande de définir un ROAS cible pour les campagnes pour lesquelles aucun ROAS cible n'est spécifié.
Fréquence
- Ajout des nouvelles métriques suivantes, qui peuvent être interrogées avec
campaign
(disponible pour les campagnes display, vidéo, Discovery et pour applications) etsegments.device
:
Shopping
- Suppression de
ShoppingSetting.sales_country
, dont les valeurs sont désormais renvoyées en tant queShoppingSetting.feed_label
.- Vous pouvez continuer à utiliser un flux Merchant Center spécifique pour une campagne à l'aide du champ
ShoppingSetting.feed_label
. Il doit être défini sur la valeur du libellé du flux ou sur le code pays à deux lettres précédemment utilisé pourShoppingSetting.sales_country
. Pour en savoir plus, consultez l'article d'aide concernant les libellés de flux.
- Vous pouvez continuer à utiliser un flux Merchant Center spécifique pour une campagne à l'aide du champ
- Suppression de la dépendance des catégories de produits à un code pays dans les rapports.
L'ensemble des ID de catégorie acceptés n'a pas changé.
- Remplacement des champs suivants, utilisés dans
shopping_performance_view
:segments.product_bidding_category_level1
avecsegments.product_category_level1
segments.product_bidding_category_level2
avecsegments.product_category_level2
segments.product_bidding_category_level3
avecsegments.product_category_level3
segments.product_bidding_category_level4
avecsegments.product_category_level4
segments.product_bidding_category_level5
avecsegments.product_category_level5
- Remplacement de
product_bidding_category_constant
parproduct_category_constant
, qui renvoie toutes les localisations disponibles d'une catégorie dans un champ répété. - Remplacement de
ListingDimensionInfo.product_bidding_category
parListingDimensionInfo.product_category
. - Remplacement de
ListingGroupFilterDimension.product_bidding_category
parListingGroupFilterDimension.product_category
.
- Remplacement des champs suivants, utilisés dans
- Il n'est plus possible d'ajouter
Campaign.shopping_setting
aux campagnes sur le Réseau de Recherche. Si vous essayez de créer une campagne sur le Réseau de Recherche avecCampaign.shopping_setting
ou d'ajouterCampaign.shopping_setting
à une campagne sur le Réseau de Recherche existante, vous obtiendrez désormaisOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Il n'est plus possible d'ajouter
CampaignCriterion.listing_scope
aux campagnes sur le Réseau de Recherche. Si vous essayez d'ajouterCampaignCriterion.listing_scope
à une campagne existante sur le Réseau de Recherche, vous obtenez désormaisOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Ajout des métriques de conversions avec les données du panier suivantes :
metrics.orders
metrics.average_order_value_micros
metrics.average_cart_size
metrics.cost_of_goods_sold_micros
metrics.gross_profit_micros
metrics.gross_profit_margin
metrics.revenue_micros
metrics.units_sold
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
- Vous pouvez sélectionner toutes ces métriques dans les rapports suivants :
Objectifs unifiés
- Ajout de
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
pour configurer les objectifs d'acquisition de clients au niveau du client.- Rapport:
customer_lifecycle_goal
- Rapport:
- Ajout de
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
pour configurer les objectifs d'acquisition de clients au niveau de la campagne.- Rapport:
campaign_lifecycle_goal
- Rapport:
- Ajout de
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
. - Ajout des valeurs suivantes à
ConversionGoalCampaignConfigError
:EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
Vidéos
- Il est désormais possible de cibler Google TV au niveau de la campagne :
- Ajout de
NetworkSettings.target_google_tv_network
- Ajout de
AdNetworkType.GOOGLE_TV
.
- Ajout de
- Il est désormais possible de cibler YouTube au niveau de la campagne :
- Ajout de
NetworkSettings.target_youtube
- Dans
AdNetworkType
, nous avons fusionnéYOUTUBE_WATCH
etYOUTUBE_SEARCH
avecYOUTUBE
. - Ajout de
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
.
- Ajout de
Notes de version archivées
Vous trouverez les notes de version archivées dans la section Versions abandonnées.