Notes de version

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.

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:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

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 sur segments.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 et campaign:
  • 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:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type, qui vous permet de segmenter les rapports suivants en fonction du type de format d'annonce vidéo:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

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">
  </ph>
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

É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">
  </ph>
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Audiences

• A ajouté OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Jobs Batch

• Ajoutée(s) BatchJobError.REQUEST_TOO_LARGE, Cette erreur est générée lorsque la valeur AddBatchJobOperationsRequest envoyée dépasse 10 484 504 octets.
• Ajout de la compatibilité avec le paramètre MutateOperation.asset_group_operation lorsque vous utilisez BatchJobService. 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ésormais AdvertisingChannelType.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 par segments.sk_ad_network_fine_conversion_value
  • Ajout de segments.sk_ad_network_redistributed_fine_conversion_value.
• 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.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

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 pour gender_view
• Ajout de la compatibilité avec metrics.phone_calls pour keyword_view

Local Services

• A ajouté LocalServicesLeadService.AppendLeadConversation() utilisée pour ajouter LocalServicesLeadConversation à 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 avec lead_type défini sur LeadType.MESSAGE peut être spécifié Conversation.local_services_lead.
• 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 nouveau LocalServicesLeadService.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èrent QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Par exemple : product_link.advertising_partner.customer et product_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 une RequestError.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 utilisant segments.date lors de l'utilisation GoogleAdsService.Search ou GoogleAdsService.SearchStream. La segmentation par date n'est pas autorisée et renverra un ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION .

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, utilisez UserListCustomerTypeService.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.

Vidéos

• Ajout des valeurs suivantes à ContentLabelType Vous pouvez exclure ces ContentLabelTypes 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éation DemandGenVideoResponsiveAdInfo
• (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 et asset_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 que MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings Si défini sur true, toute erreur non bloquante liée à des échecs d'opération est renvoyé sous la forme MutateCustomerSkAdNetworkConversionValueSchemaResponse.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 et local_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 et BrandSafetySuitability 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 De AccountLink à ProductLink et ProductLinkInvitation.
• data_partner et google_ads ont été retirés de AccountLink
• 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éthode verification_program Il crée une session de vérification et renvoie une réponse vide pour une la validation a bien été créée.
    • Ajoutée(s) IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
  • GetIdentityVerification() qui permet de récupérer les informations de validation, ce qui renvoie plusieurs objets de IdentityVerification. Chaque IdentityVerification 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 validation
    • verification_progress contenant des informations sur la session de validation, y compris:
      • program_status représente l'état actuel session de validation
      • action_url redirige le client vers une URL pour effectuer la la validation.
      • invitation_link_expiration_time représente la date d'expiration pour le action_url
  • Énumérations: <ph type="x-smartling-placeholder">
    </ph>
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Erreurs: <ph type="x-smartling-placeholder">
    </ph>
    • IdentityVerificationError
• 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 et segments.month
  • campaign a été défini comme ressource attribuée au lieu de segmenter la ressource.

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 correspondantes DemandGenProductAdInfo, disponible pour dans les campagnes de génération de la demande Campaign.shopping_setting
• 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:
  • activity_state
  • activity_city
• Ajout de la prise en charge des segments suivants dans travel_activity_performance_view:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Local Services

• Ajoutée(s) LocalServicesVerificationArtifact.business_registration_check_verification_artifact et BusinessRegistrationCheckArtifact 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é de AudienceInsightsAttributeMetadata

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 sur UNSPECIFIED au lieu de UNKNOWN.
• 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égie
  • IMPROVE_GOOGLE_TAG_COVERAGE qui recommande de déployer la balise Google sur plus de pages
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN qui recommande d'activer l'extension d'URL finale pour vos campagnes Performance Max campagnes
  • REFRESH_CUSTOMER_MATCH_LIST qui recommande de mettre à jour une liste de clients qui n'a pas été mise à jour dans les 90 derniers jours
  • CUSTOM_AUDIENCE_OPT_IN qui recommande de créer une audience personnalisée
  • LEAD_FORM_ASSET qui recommande d'ajouter des composants Formulaire pour prospects au niveau de la campagne niveau
  • IMPROVE_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 et CampaignError.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 et CampaignLifecycleGoalOperation 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 et customer_client.status sont désormais renvoyées sous la forme SUSPENDED Auparavant, ils étaient renvoyés en tant que ENABLED
• 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 et MerchantCenterIdentifier
  • Ajoutée(s) LinkedProductType.MERCHANT_CENTER
• Ajoutée(s) ProductLinkInvitationService et ProductLinkInvitation 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 et ProductLinkService.
• Suppression de AccountLink.hotel_center et de la compatibilité avec la mise à jour des invitations d'association depuis des comptes Hotel Center AccountLinkService
  • Pour mettre à jour une demande d'association à partir d'un compte Hotel Center, utilisez ProductLinkInvitationService

Éléments

• Remplacement de ImageAdInfo.media_file par ImageAdInfo.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 par AssetGroupListingGroupFilter.listing_source et ListingGroupFilterListingSource
• 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 et Audience.asset_group pour limiter l'utilisation de l'audience à un groupe d'assets spécifique. Vous devez définir Audience.asset_group si et seulement si Audience.scope est ASSET_GROUP
    • 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 un AssetGroupSignal en insérant AssetGroupSignal.search_theme avec un critère SearchThemeInfo.
  • 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 maintenant TargetCpaSimulationPoint.interactions au lieu de TargetCpaSimulationPoint.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éer BRAND critère ajouté à un ensemble partagé BRANDS, puis associées à une campagne en créant CampaignCriterion avec brand_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">
    </ph>
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Énumérations: <ph type="x-smartling-placeholder">
    </ph>
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• 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 et ClickConversion.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 ou campaign:
  • Segments: <ph type="x-smartling-placeholder">
    </ph>
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • Métriques: <ph type="x-smartling-placeholder">
    </ph>
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• Remplacement de metrics.sk_ad_network_conversions par metrics.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 ressource customer 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ée OfflineConversionAlert.
  • 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:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • Ajout de INVALID_JOB_ID aux erreurs suivantes:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • Remplacement de INVALID_CONVERSION_ACTION par NO_CONVERSION_ACTION_FOUND et INVALID_CONVERSION_ACTION_TYPE dans les erreurs suivantes:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• 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 contient shared_campaign_key et certains champs qui aident à encoder la clé.
  • android_privacy_shared_key_google_ad_group, qui contient shared_ad_group_key et certains champs qui aident à encoder la clé.
  • android_privacy_shared_key_google_network_type, qui contient shared_network_type_key et certains champs qui aident à encoder la clé.
• Ajoutée(s) ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS Un élément ConversionActionOperation 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 échouait UNKNOWN erreur.

Hôtels et Voyages

• Ajout de la prise en charge des champs suivants dans travel_activity_group_view et travel_activity_performance_view:
  • Segments: <ph type="x-smartling-placeholder">
    </ph>
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • 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 rapport customer 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 que lead_charged, lead_type, lead_status.
    • Énumérations: <ph type="x-smartling-placeholder">
      </ph>
      • LeadStatus
      • LeadType
  • local_services_lead_conversation contient des informations sur le message et la conversation téléphonique, telles que conversation_channel, call_duration_millis et call_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">
      </ph>
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Planification

• Ajout de la possibilité de renvoyer Forecast.views et PlannedProductForecast.views pour ReachPlanService.ListPlannableProducts pour les types de produits applicables.
• Ajout de la prise en charge des retours PlannableTargeting.surface_targeting pour ReachPlanService.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 renvoie PlannedProductForecast.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">
    </ph>
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• 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) et segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Shopping

• Suppression de ShoppingSetting.sales_country, dont les valeurs sont désormais renvoyées en tant que ShoppingSetting.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é pour ShoppingSetting.sales_country. Pour en savoir plus, consultez l'article d'aide sur le flux étiquettes.
• 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 avec segments.product_category_level1
    • segments.product_bidding_category_level2 avec segments.product_category_level2
    • segments.product_bidding_category_level3 avec segments.product_category_level3
    • segments.product_bidding_category_level4 avec segments.product_category_level4
    • segments.product_bidding_category_level5 avec segments.product_category_level5
  • Remplacement de product_bidding_category_constant par product_category_constant, qui renvoie toutes les localisations disponibles d'une catégorie dans un champ répété.
  • Remplacement de ListingDimensionInfo.product_bidding_category par ListingDimensionInfo.product_category
  • Remplacement de ListingGroupFilterDimension.product_bidding_category par ListingGroupFilterDimension.product_category
• 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 avec Campaign.shopping_setting ou ajouter de Campaign.shopping_setting à un une campagne existante sur le Réseau de Recherche génère OPERATION_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 existante OPERATION_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">
    </ph>
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Objectifs unifiés

• Ajoutée(s) CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals pour configurer les objectifs d'acquisition de clients au niveau du client.
  • Rapport: customer_lifecycle_goal
• Ajoutée(s) CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals pour configurer les objectifs d'acquisition de clients au niveau de la campagne.
  • Rapport: campaign_lifecycle_goal
• 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
• 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 et YOUTUBE_SEARCH dans YOUTUBE.
  • Ajoutée(s) CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE

Notes de version archivées

Vous trouverez les notes de version archivées dans la section Versions abandonnées.