Version 17.1.0 (07/08/2024)
Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées dans la version v17_1.
Éléments
AdGroupAdService.RemoveAutomaticallyCreatedAssets()
vous permet de supprimer certains composants créés automatiquement associés à des annonces responsives sur le Réseau de Recherche.
Audiences
- Nouvelles valeurs d'énumération dans
UserListCustomerTypeCategory
:LOYALTY_TIER_1_MEMBERS
LOYALTY_TIER_2_MEMBERS
LOYALTY_TIER_3_MEMBERS
LOYALTY_TIER_4_MEMBERS
LOYALTY_TIER_5_MEMBERS
LOYALTY_TIER_6_MEMBERS
LOYALTY_TIER_7_MEMBERS
Campagnes
ShareablePreviewService.GenerateShareablePreviews()
génère les URL (shareable_preview_url
dans la réponse) des aperçus d'annonces partageables pour les groupes d'assets activés et mis en veille.- Le champ
expiration_date_time
indique la date d'expiration des URL dans la réponse. - Si une erreur se produit, la méthode renvoie
partial_failure_error
à la place des URL.
- Le champ
Historique des modifications
- Nouveau type de ressource d'état des modifications:
ASSET_GROUP
.
Conversions
- Nouveau champ de segment pour la version SKAdNetwork:
segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary
, qui expose les diagnostics d'importation des conversions au niveau de l'action de conversion.- Les métriques suivantes sont ajoutées aux rapports sur les diagnostics hors connexion pour indiquer le nombre de conversions importées qui sont encore traitées:
Planification
AudienceInsights.GenerateAudienceOverlapInsights()
, qui accepte un attribut principal d'entrée et un ensemble d'attributs d'audience, et renvoie les estimations du chevauchement de la couverture YouTube potentielle entre l'attribut principal et les attributs d'audience.
Rapports
- Compatibilité avec la segmentation
per_store_view
basée sursegments.date
Vidéos
- Prise en charge de la récupération d'informations liées aux stratégies d'enchères standards suivantes pour les campagnes vidéo utilisant des rapports tels que
ad_group
etcampaign
:Campaign.fixed_cpm
(CPM fixe (coût pour mille impressions))Campaign.target_cpv
(CPV (coût par vue) cible)
Campaign.video_campaign_settings
, qui vous permet de déterminer sur quels inventaires les annonces vidéo peuvent être diffusées, à l'aide des champs de rapport suivants:segments.ad_format_type
, qui vous permet de segmenter les rapports suivants en fonction du type de format d'annonce vidéo:
Version 17 (05/06/2024)
Les fonctionnalités et modifications suivantes ont été ajoutées dans la v17.
Annonces
- Suppression de
AdService.getAd
. Ainsi,AdService
conformément aux autres services du API Google Ads. Consultez la section Récupérer des objets pour la méthode recommandée pour récupérer les annonces et les autres types de ressources. - Ajout de validations supplémentaires pour
ImageAdInfo.image_asset
concernant les dimensions et le format. Les erreurs suivantes peuvent se produire si l'image est non valide: <ph type="x-smartling-placeholder">
Éléments
- Ajout d'une énumération:
ClickType.AD_IMAGE
- Ajout des rapports suivants avec de nouvelles métriques pour les campagnes Performance Max et sur le Réseau de Recherche: <ph type="x-smartling-placeholder">
Audiences
Jobs Batch
- Ajoutée(s)
BatchJobError.REQUEST_TOO_LARGE
, Cette erreur est générée lorsque la valeurAddBatchJobOperationsRequest
envoyée dépasse 10 484 504 octets. - Ajout de la compatibilité avec le paramètre
MutateOperation.asset_group_operation
lorsque vous utilisezBatchJobService
. Cela vous permet utiliser le traitement par lot pour créer gérer des campagnes Performance Max entières. Consultez notre nouveau guide dédié.
Campagnes
- Remplacement du nom Discovery par "Génération de la demande" pour tous les champs, énumérations et erreurs
ressources de l'API Google Ads, telles que les campagnes, les annonces et les composants. Pour
exemple,
AdvertisingChannelType.DISCOVERY
est désormaisAdvertisingChannelType.DEMAND_GEN
- Ajoutée(s)
Campaign.keyword_match_type
afin de définir le type de correspondance des mots clés pour tous les mots clés d'une campagne.
Conversions
- Pour SKAdNetwork
les conversions,
- Remplacement du nom
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
- Les métriques suivantes sont désormais renvoyées avec la réponse, même lorsque ils sont nuls. 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 inférence:primary_status
primary_status_reasons
- Ajout de la compatibilité avec
metrics.search_impression_share
pourgender_view
- Ajout de la compatibilité avec
metrics.phone_calls
pourkeyword_view
Local Services
- A ajouté
LocalServicesLeadService.AppendLeadConversation()
utilisée pour ajouterLocalServicesLeadConversation
àLocalServicesLead
, qui envoie des messages aux utilisateurs par le biais de canaux appropriés, tels que les SMS, en fonction de la manière dont prospect a été créé.- La taille de
AppendLeadConversationRequest.conversations
est limitée à 1 000. - Seulement
LocalServicesLead
aveclead_type
défini surLeadType.MESSAGE
peut être spécifiéConversation.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 du nouveauLocalServicesLeadService.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
Rapports
- Vous ne pouvez désormais sélectionner que les champs associés à un produit associé
lorsque vous interrogez
product_link
. Sélection de plusieurs éléments les champs de plusieurs produits associés génèrentQueryError.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. - Transmettre un
page_size
àGoogleAdsService.Search
se traduira par uneRequestError.PAGE_SIZE_NOT_SUPPORTED
.
Shopping
- Ajout d'un nouveau rapport
shopping_product
, qui correspond à la page Produits de l'interface utilisateur Google Ads. Il permet de renvoyer données liées à l'état actuel des produits de Google Merchant Center associés à un compte Google Ads.- Vous pouvez filtrer les métriques
shopping_product
rapportent en utilisantsegments.date
lors de l'utilisationGoogleAdsService.Search
ouGoogleAdsService.SearchStream
. La segmentation par date n'est pas autorisée et renverra unShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Vous pouvez filtrer les métriques
Objectifs unifiés
- A ajouté
UserListCustomerTypeService.MutateUserListCustomerTypes()
pour configurer l'audience, types. - Suppression de
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
. Pour configurer les paramètres d'audience des objectifs de cycle de vie des clients, utilisezUserListCustomerTypeService.MutateUserListCustomerTypes()
à la place.- Associez ou dissociez une liste d'utilisateurs en définissant
UserListCustomerType.customer_type_category
àUserListCustomerTypeCategory.PURCHASERS
pour l'inclure dans une définition de client existante ou l'en exclure pour les objectifs de cycle de vie client. Visiter segmenter votre audiences pour en savoir plus.
- 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
- A ajouté
AdVideoAsset.ad_video_asset_info
afin de prendre en charge les préférences d'inventaire pour les éléments vidéo lors de la créationDemandGenVideoResponsiveAdInfo
- (Comptes ajoutés à la liste d'autorisation uniquement) Créée
Campaign.video_brand_safety_suitability
modifiable.
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 prend en charge l’ajout d’une 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
Éléments
- 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
ce qui limite à 1 000 le nombre de listes d'utilisateurs similaires qu'un client peut avoir.
Campagnes
- Prise en charge du retour Target
de simulation d'enchères de campagne au ROAS
les campagnes pour applications qui utilisent les
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
compatible avec SKAdNetwork 4,0 caractéristiques.- Ajout de la prise en charge des avertissements pour
CustomerSkAdNetworkConversionValueSchemaService
en tant queMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
Si défini surtrue
, toute erreur non bloquante liée à des échecs d'opération est renvoyé 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 renvoie l'état du crédit et l'horodatage a été mis à jour, respectivement.local_services_lead_conversation.message_details.attachment_urls
qui renvoie les URL permettant de télécharger le contenu du en pièce jointe.
Vidéos
customer.video_brand_safety_suitability
etBrandSafetySuitability
qui permettent de récupérer la brand safety des vidéos chez le client d'application.- 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
depuis DeAccountLink
àProductLink
etProductLinkInvitation
. data_partner
etgoogle_ads
ont été retirés deAccountLink
- Ajoutée(s)
IdentityVerificationService
jusqu'à gérer la validation des annonceurs.StartIdentityVerification()
sert à démarrer une session de vérification à l'aide de la méthodeverification_program
Il crée une session de vérification et renvoie une réponse vide pour une la validation a bien été créée.GetIdentityVerification()
qui permet de 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
contenant des détails sur l'échéance à laquelle l'annonceur doit terminer la validationverification_progress
contenant des informations sur la session de validation, y compris:program_status
représente l'état actuel session de validationaction_url
redirige le client vers une URL pour effectuer la la validation.invitation_link_expiration_time
représente la date d'expiration pour leaction_url
- Énumérations: <ph type="x-smartling-placeholder">
- Erreurs: <ph type="x-smartling-placeholder">
- Ajoutée(s)
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
Éléments
- Modifications apportées à
asset_group
:- Ajout de la prise en charge des segments temporels, comme
segments.year
etsegments.month
campaign
a été défini comme ressource attribuée au lieu de segmenter la ressource.
- Ajout de la prise en charge des segments temporels, comme
Campagnes
- Modifications apportées aux campagnes de génération de la demande:
<ph type="x-smartling-placeholder">
- </ph>
- Ajout de la prise en charge du paramètre
Campaign.shopping_setting
jusqu'à une campagne de génération de la demande existante. - Ajoutée(s)
ShoppingSetting.disable_product_feed
pour désactiver le flux de produits facultatif des campagnes de génération de la demande. - A ajouté
Ad.demand_gen_product_ad
et les valeurs correspondantesDemandGenProductAdInfo
, disponible pour dans les campagnes de génération de la demandeCampaign.shopping_setting
- Ajout de la prise en charge du paramètre
- Ajouté aux champs suivants dans
AdGroup
pour indiquer si le groupe d'annonces est diffusé ou les raisons pour lesquelles il n'est pas diffusé:primary_status
primary_status_reasons
- Ajouté aux champs suivants dans
AdGroupAd
pour afficher si l'annonce du groupe d'annonces est diffusée ou pourquoi elle n'est pas diffusée: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
à indiquer si la synchronisation doit être activée pour le test. Avec synchronisation activée, les modifications apportées la campagne d'origine pendant l'exécution du test, sont automatiquement dans la campagne test. - Ajoutée(s)
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
- Ajoutée(s)
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
Hôtels et Voyages
- Ajout des champs suivants à
ListingDimensionInfo
pour une activité à découvrir l'annonce pour permettre la création de groupes de fiches en fonction de l'État et de la ville activité de voyage est disponible: - Ajout de la prise en charge des segments suivants dans
travel_activity_performance_view
:
Local Services
- Ajoutée(s)
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
etBusinessRegistrationCheckArtifact
pour permettre aux annonceurs de suivre la progression de l'immatriculation de leur entreprise procédure de validation. - Nouvelle ressource ajoutée
local_services_employee
pour autoriser aux annonceurs de récupérer les informations sur les employés qu'ils ont ajoutées.
Planification
score
a été supprimé deAudienceInsightsAttributeMetadata
Recommandations
- Ajoutée(s)
RecommendationService.GenerateRecommendations()
qui renvoie des recommandations basées sur les paramètres spécifiés, comme les types de recommandations et de canaux publicitaires. C'est particulièrement utile lorsque vous créez votre campagne. - Ajoutée(s)
RecommendationMetrics.conversions_value
- Les mots clés recommandés dont le type de correspondance des mots clés n'est pas défini comportent désormais
recommended_match_type
définie surUNSPECIFIED
au lieu deUNKNOWN
. - Ajout des types de recommandations suivants:
<ph type="x-smartling-placeholder">
- </ph>
MAXIMIZE_CONVERSION_VALUE_OPT_IN
qui recommande d'activer la stratégie d'enchères "Maximiser la valeur de conversion" stratégieIMPROVE_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 Max campagnesREFRESH_CUSTOMER_MATCH_LIST
qui recommande de mettre à jour une liste de clients qui n'a pas été mise à jour dans les 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 niveauIMPROVE_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ée(s)
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
etCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
afin de fournir plus de détails sur les erreurs des campagnes Shopping associées à un 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 de 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'un compte non autorisé
activité physique,
customer.status
etcustomer_client.status
sont désormais renvoyées sous la formeSUSPENDED
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:
<ph type="x-smartling-placeholder">
- </ph>
- Ajoutée(s)
ProductLink.merchant_center
etMerchantCenterIdentifier
- Ajoutée(s)
LinkedProductType.MERCHANT_CENTER
- Ajoutée(s)
- Ajoutée(s)
ProductLinkInvitationService
etProductLinkInvitation
pour l'assistance Mise à jour d'une invitation d'association envoyée depuis d'autres produits, disponible pour les hôtels Center et Merchant de Google. - 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 compatibilité avec la mise à jour des invitations d'association depuis des comptes Hotel CenterAccountLinkService
- 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
Éléments
- Remplacement de
ImageAdInfo.media_file
parImageAdInfo.image_asset
pour l'assistance en ajoutant et en supprimant des images à l'aide des assets. Par conséquent, nous avons également suppriméMediaFileService
, qui n'est plus nécessaire. - Ajoutée(s)
ListingGroupFilterDimension.webpage
pour permettre la création d'un filtre de groupe de fiches basé sur des étiquettes personnalisées et des URL sous-chaînes.- Également remplacé par
AssetGroupListingGroupFilter.vertical
parAssetGroupListingGroupFilter.listing_source
etListingGroupFilterListingSource
- Également remplacé par
- Ajout de
asset_group_asset.source
pour afficher la source de l'élément du groupe d'assets. - Ajoutée(s)
ad_group_ad_asset_view.source
jusqu'à affiche la source du composant d'annonce du groupe d'annonces.
Audiences
- Pour le ciblage par liste de clients,
CustomerMatchUserListMetadata.consent
pour autoriser l'utilisateur. À partir du 6 mars 2024, si le consentement est est manquante pour les utilisateurs de l'EEE, la valeur du consentement est 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 être utilisées pour la personnalisation à l'aide du ciblage par liste de clients. Consultez notre Guide sur le ciblage par liste de clients pour en savoir plus. - Pour les ventes en magasin,
UserData.consent
a été ajouté à permet de donner un consentement. Consultez notre Guide de vente en magasin pour plus de détails. Si vous utilisez le ciblage par liste de clients avec les ventes en magasin, consultez Questions fréquentes sur d'autres des informations. - Ajoutée(s)
UserList.lookalike_user_list
jusqu'à la création d'une campagne similaire segment, une audience créée en fonction de l'audience source existante fournie. Des segments similaires peuvent être utilisés dans une campagne de génération de la demande. uniquement.
Campagnes
Modifications apportées aux campagnes Performance Max:
AssetGroupSignal
prend désormais en charge 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. Vous devez définirAudience.asset_group
si et seulement siAudience.scope
estASSET_GROUP
- Ajout de
AssetGroupSignal.search_theme
- Ajoutée(s)
CriterionType.SEARCH_THEME
pour prendre en charge ce nouveau type de critère. Ce nouveau type de critère ne peut être utilisée dans les campagnes Performance Max pour créer unAssetGroupSignal
en insérantAssetGroupSignal.search_theme
avec un critèreSearchThemeInfo
.
- Ajoutée(s)
- Ajoutée(s)
AssetGroupSignalOperation.exempt_policy_violation_keys
pour pouvoir demander une exception lorsque vous ajoutez des signaux de groupes d'assets. - Ajout d'un nouvel élément
asset_group_top_combination_view
pour créer des rapports sur les composants les plus performants au niveau du groupe d'assets. asset_group
peut désormais être interrogé avec des champs de métriques pour récupérer les performances d'une campagne Performance Max.- Dans
PerformanceMaxUpgradeStatus
,UPGRADE_ELIGIBLE
a été renomméUPGRADE_ELIGIBLE
.
Pour les campagnes de génération de la demande Découverte campagnes au CPA cible, simulations d'enchères au CPA cible au niveau des campagnes (
campaign_simulation.target_cpa_point_list.points
) renvoie maintenantTargetCpaSimulationPoint.interactions
au lieu deTargetCpaSimulationPoint.clicks
Ajout de
BrandSuggestionService
, qui peut suggère des marques en fonction du préfixe de marque fourni et de la liste des marques exclues marques. Ces marques peuvent servir à créerBRAND
critère ajouté à un ensemble partagéBRANDS
, puis associées à une campagne en créantCampaignCriterion
avecbrand_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 Performance Max.- Champs: <ph type="x-smartling-placeholder">
- Énumérations: <ph type="x-smartling-placeholder">
Ajoutée(s)
Campaign.asset_automation_settings[]
pour afficher l'état d'automatisation de chaque type de composant.Ajout des valeurs suivantes au
CampaignPrimaryStatusReason
enum:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversions
- Ajout de
CallConversion.consent
etClickConversion.consent
pour l'assistance donner son consentement. Consultez notre guide des conversions par appel et le guide des conversions après clic pour en savoir plus plus de détails. - Ajout des champs suivants liés à
SKAdNetwork
disponibles lorsque vous les interrogez
customer
oucampaign
:- Segments: <ph type="x-smartling-placeholder">
- Métriques: <ph type="x-smartling-placeholder">
- Remplacement de
metrics.sk_ad_network_conversions
parmetrics.sk_ad_network_installs
- Ajout de la prise en charge du diagnostic de l'importation des conversions hors connexion
<ph type="x-smartling-placeholder">
- </ph>
- Déplacement du
offline_conversion_upload_client_summary
à partir d'un champ de la ressourcecustomer
vers un rapport de niveau supérieur. Utiliser ceci pour obtenir des informations utiles sur l'état de l'importation des conversions, par exemple le nombre d'événements réussis, le taux de réussite et le pourcentage d'erreur.- Mise en garde: conversion importée, mais qui génère un
ConversionUploadError.CLICK_NOT_FOUND
l'erreur est toujours comptabilisée comme réussie, mais elle est également signaléeOfflineConversionAlert
.
- Mise en garde: conversion importée, mais qui génère un
- Ajout de
job_id
en tant que paramètre facultatif pour les types de requêtes suivants. vous pouvez regrouper logiquement plusieurs requêtes d'importation dans un seul job: - 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 du
- Ajout de trois rapports pour prendre en charge l'analyse multiréseau de la Privacy Sandbox sur Android
l'attribution sans
redirections :
android_privacy_shared_key_google_campaign
, qui contientshared_campaign_key
et certains champs qui aident à encoder la clé.android_privacy_shared_key_google_ad_group
, qui contientshared_ad_group_key
et certains champs qui aident à encoder la clé.android_privacy_shared_key_google_network_type
, qui contientshared_network_type_key
et certains champs qui aident à encoder la clé.
- Ajoutée(s)
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
Un élémentConversionActionOperation
qui tente d'utiliser l'une des attributions basées sur des règles obsolètes modèles échoue à présent et renvoie cette erreur. Auparavant, l'opération échouaitUNKNOWN
erreur.
Hôtels et Voyages
- Ajout de la prise en charge des champs suivants dans
travel_activity_group_view
ettravel_activity_performance_view
:- Segments: <ph type="x-smartling-placeholder">
- Métriques:
<ph type="x-smartling-placeholder">
- </ph>
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 au rapportcustomer
pour renvoyer une valeur État précis des licences et des assurances de l'annonceur de services - Ajout des nouveaux rapports suivants pour les rapports Local
Services:
local_services_lead
contient toutes les les détails concernant Local Services Prospects Ads tels quelead_charged
,lead_type
,lead_status
.- Énumérations:
<ph type="x-smartling-placeholder">
- </ph>
LeadStatus
LeadType
- Énumérations:
<ph type="x-smartling-placeholder">
local_services_lead_conversation
contient des informations sur le message et la conversation téléphonique, telles queconversation_channel
,call_duration_millis
etcall_recording_url
.- L'URL d'enregistrement de l'appel téléphonique est authentifiée par rapport au 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 commerciales et les données d'assurance professionnelle. Tous les documents associés avec licence et assurance est accessible via une URL.- Énumérations: <ph type="x-smartling-placeholder">
Planification
- Ajout de la possibilité de renvoyer
Forecast.views
etPlannedProductForecast.views
pourReachPlanService.ListPlannableProducts
pour les types de produits applicables. - Ajout de la prise en charge des retours
PlannableTargeting.surface_targeting
pourReachPlanService.ListPlannableProducts
, qui décrit les surfaces disponibles pour un produit. - Ajout d'un nouvel élément
Énumération
ReachPlanSurface
. - Ajout de la prise en charge du ciblage Target
fréquence à l'aide de
AdvancedProductTargeting.target_frequency_settings
, qui renvoiePlannedProductForecast.average_frequency
. - Ajoutée(s)
AudienceInsightsService.GenerateSuggestedTargetingInsights
afin de 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ée(s)
RecommendationSubscriptionService
qui gère les abonnements aux recommandations:- Ressource:
RecommendationSubscription
- Champ:
MutateOperation.recommendation_subscription_operation
- Énumération:
ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
- Erreurs: <ph type="x-smartling-placeholder">
- Ressource:
- Ajout des types de recommandations suivants:
<ph type="x-smartling-placeholder">
- </ph>
FORECASTING_SET_TARGET_CPA
recommande de définir un CPA cible pour les campagnes qui n'en spécifié, avant un événement saisonnier susceptible d'augmenter du trafic.SET_TARGET_CPA
recommande de définir un CPA cible pour les campagnes qui n'en spécifié.SET_TARGET_ROAS
recommande de définir un ROAS cible pour les campagnes qui n'en comportent pas spécifié.
Rapports
- Ajout des métriques suivantes, qui peuvent être interrogées avec
campaign
(disponible pour les campagnes display, vidéo, Discovery et campagnes 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 compte Merchant Center
flux d'une campagne
la
ShoppingSetting.feed_label
. Il doit correspondre à la valeur du libellé du flux ou au pays à deux lettres code précédemment utilisé pourShoppingSetting.sales_country
. Pour en savoir plus, consultez l'article d'aide sur le flux étiquettes.
- Vous pouvez continuer à utiliser un compte Merchant Center
flux d'une campagne
la
- 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
pour effectuer une recherche campagnes. Vous essayez de créer une campagne sur le Réseau de Recherche avecCampaign.shopping_setting
ou ajouter deCampaign.shopping_setting
à un une campagne existante sur le Réseau de Recherche génèreOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Il n'est plus possible d'ajouter
CampaignCriterion.listing_scope
aux campagnes sur le Réseau de Recherche. Tentative d'ajout...CampaignCriterion.listing_scope
à une campagne sur le Réseau de Recherche existanteOPERATION_NOT_PERMITTED_FOR_CONTEXT
- Les conversions avec le panier suivantes ont été ajoutées
données:
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: <ph type="x-smartling-placeholder">
Objectifs unifiés
- Ajoutée(s)
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
pour configurer les objectifs d'acquisition de clients au niveau du client.- Rapport:
customer_lifecycle_goal
- Rapport:
- Ajoutée(s)
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
pour configurer les objectifs d'acquisition de clients au niveau de la campagne.- Rapport:
campaign_lifecycle_goal
- Rapport:
- Ajoutée(s)
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:
<ph type="x-smartling-placeholder">
- </ph>
- Ajoutée(s)
NetworkSettings.target_google_tv_network
- Ajoutée(s)
AdNetworkType.GOOGLE_TV
- Ajoutée(s)
- Il est désormais possible de cibler YouTube au niveau de la campagne:
<ph type="x-smartling-placeholder">
- </ph>
- Ajoutée(s)
NetworkSettings.target_youtube
- Fusionné dans
AdNetworkType
YOUTUBE_WATCH
etYOUTUBE_SEARCH
dansYOUTUBE
. - Ajoutée(s)
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
- Ajoutée(s)
Notes de version archivées
Vous trouverez les notes de version archivées dans la section Versions abandonnées.