リリースノート

バージョン 17（2024 年 6 月 5 日）

v17 で次の機能と変更が追加されました。

関連

• AdService.getAd を削除しました。これにより、AdService は Google Ads API の他のサービスと同じような形になります。広告やその他のリソースタイプを取得するためのおすすめの方法については、オブジェクトの取得をご覧ください。
• ディメンションと形式に関する ImageAdInfo.image_asset の検証を追加しました。画像が無効な場合は、次のエラーがスローされることがあります。
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

アセット

• 新しい列挙型 ClickType.AD_IMAGE を追加しました。
• P-MAX キャンペーンと検索キャンペーンの新しい指標を含む以下の新しいレポートを追加しました。
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

オーディエンス

• OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED を追加しました

バッチジョブ

• BatchJobError.REQUEST_TOO_LARGE を追加しました。これは、送信された AddBatchJobOperationsRequest が 1,048,4504 バイトより大きい場合にスローされます。
• BatchJobService を使用する場合の MutateOperation.asset_group_operation の設定のサポートを追加しました。これにより、バッチ処理を使用して P-MAX キャンペーン全体を作成し、管理できます。新しい専用ガイドをご覧ください。

キャンペーン

• Google Ads API の全リソース（キャンペーン、広告、アセットなど）のすべてのフィールド、列挙型、エラーについて、Discovery の名前を「デマンド ジェネレーション」に変更しました。たとえば、AdvertisingChannelType.DISCOVERY は AdvertisingChannelType.DEMAND_GEN に変更されました。
• キャンペーン内のすべてのキーワードに対してキーワードのマッチタイプを設定できる Campaign.keyword_match_type を追加しました。

コンバージョン数

• SKAdNetwork コンバージョンの場合:
  • segments.sk_ad_network_conversion_value の名前を segments.sk_ad_network_fine_conversion_value に変更しました。
  • segments.sk_ad_network_redistributed_fine_conversion_value を追加しました。
• 次の指標がゼロであっても、レスポンスで返されるようになりました。これにより、他の指標との整合性が確保されます。
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

条件

• 広告グループの条件が配信されているかどうか、または配信されていない理由を示すため、AdGroupCriterion に次のフィールドが追加されました。
  • primary_status
  • primary_status_reasons
• gender_view の metrics.search_impression_share のサポートを追加しました。
• keyword_view の metrics.phone_calls のサポートを追加しました。

ローカル サービス

• LocalServicesLead に新しい LocalServicesLeadConversation を追加するための LocalServicesLeadService.AppendLeadConversation() を追加しました。これは、見込み顧客がどのように作成されたかに応じて、SMS などの適切なチャネルを通じてユーザーにメッセージを送信します。
  • AppendLeadConversationRequest.conversations のサイズは 1,000 に制限されています。
  • Conversation.local_services_lead で指定できるのは、lead_type が LeadType.MESSAGE に設定された LocalServicesLead のみです。
• ConversationType に新しい列挙値を追加しました。
  • WHATSAPP: WhatsApp で紹介された会話を表します。
  • 新しい LocalServicesLeadService.AppendLeadConversation() メソッドを使用して導入された会話を表す ADS_API。
• local_services_verification_artifact に次の新しいフィールドを追加しました。
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

報告

• product_link をクエリするときに、1 つのリンクされたプロダクトに関連するフィールドのみを選択できるようになりました。リンクされた複数の商品の複数のフィールドを選択すると、QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE がスローされます。たとえば、同じクエリで product_link.advertising_partner.customer と product_link.data_partner.data_partner_id を選択することはできません。
• page_size を GoogleAdsService.Search に渡すと、RequestError.PAGE_SIZE_NOT_SUPPORTED エラーが発生します。

ショッピング

• Google 広告管理画面の [商品] ページに対応する新しいレポート shopping_product を追加しました。Google 広告アカウントにリンクされている Google Merchant Center アカウントから、商品の現在の状態に関連するデータを返すことができます。
  • GoogleAdsService.Search または GoogleAdsService.SearchStream を使用している場合は、segments.date を使用して、shopping_product レポートから指標をフィルタリングできます。日付による分割は使用できず、ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION エラーが返されます。

統合された目標

• オーディエンスの顧客タイプを設定するための UserListCustomerTypeService.MutateUserListCustomerTypes() を追加しました。
• CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings が削除されました。顧客ライフサイクル目標のオーディエンス設定を指定するには、代わりに UserListCustomerTypeService.MutateUserListCustomerTypes() を使用します。
  • ユーザーリストの添付や関連付けの解除を行うには、UserListCustomerType.customer_type_category を UserListCustomerTypeCategory.PURCHASERS に設定して、ユーザーリストを顧客ライフサイクル目標の既存の顧客定義に含めるか、除外します。詳しくは、オーディエンスのセグメント化をご覧ください。

動画

• ContentLabelType に次の値を追加しました。 以下の ContentLabelTypes は顧客レベルで除外できます。
  • 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
• DemandGenVideoResponsiveAdInfo の作成時に動画アセットのインベントリ設定をサポートする AdVideoAsset.ad_video_asset_info を追加しました。
• （許可リストに登録されたアカウントのみ）Campaign.video_brand_safety_suitability を変更可能にしました。

バージョン 16.1.0（2024 年 4 月 24 日）

v16.1 で追加された機能と変更点は、

アカウントの管理

• CustomerNegativeCriterion.ip_block: 除外条件として顧客レベルで IP を追加できます。
• 新しい列挙値: ProductLinkError.LINK_EXISTS。
• 新しい列挙値: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION。

アセット

• ad_group_ad_asset_view、asset_field_type_view へのデマンド ジェネレーション関連のアセットのサポート。
• 新しい列挙値: AssetFieldType.DISCOVERY_CAROUSEL_CARD。

オーディエンス

• 新しい列挙値: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER により、ユーザーが作成できる類似ユーザーリストの数を 1,000 に制限しました。

キャンペーン

• campaign_simulation レポートを使って、アプリ キャンペーンの目標広告費用対効果 キャンペーン入札単価シミュレーションを返すことをサポートします。
• 新しい列挙値: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN。
• 新しい列挙値: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY。
• 新しい列挙値: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS。

コンバージョン数

• SkAdNetworkConversionValueSchema.postback_mappings: SKAdNetwork 4.0 の機能をサポートします。
• CustomerSkAdNetworkConversionValueSchemaService の警告に対するサポートを MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings として追加しました。true に設定すると、オペレーションの失敗に関連する非ブロッキング エラーは MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning として返されます。
• CustomerSkAdNetworkConversionValueSchemaError の新しい列挙値:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

条件

• BrandInfo の新しいフィールド:
  • display_name
  • primary_url
  • rejection_reason
  • status
• 新しい列挙型: BrandRequestRejectionReason。
• 新しい列挙値: CriterionType.LIFE_EVENT。

テスト

• 新しい列挙値: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT。

ローカル サービス

• local_services_lead.credit_details.credit_state と local_services_lead.credit_details.credit_state_last_update_date_time。それぞれクレジットの状態と更新時のタイムスタンプを返します。
• local_services_lead_conversation.message_details.attachment_urls は、アタッチメントのコンテンツのダウンロードに使用できる URL を返します。

動画

• customer.video_brand_safety_suitability と BrandSafetySuitability: 顧客レベルでの動画のブランド保護適合性の取得をサポートします。
• 新しい列挙値: VideoCampaignError.MUTATE_REQUIRES_RESERVATION。

バージョン 16（2024 年 2 月 21 日）

v16 で次の機能と変更が追加されました。

アカウントの管理

• advertising_partner を AccountLink から ProductLink と ProductLinkInvitation に移行しました。
• AccountLink から data_partner と google_ads を削除しました。
• 広告主様の適格性確認を管理する IdentityVerificationService を追加しました。
  • StartIdentityVerification() は、指定された verification_program で検証セッションを開始するために使用されます。新しい検証セッションが作成され、検証が正常に作成された場合は空のレスポンスが返されます。
    • IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION を追加しました。
  • GetIdentityVerification() は検証情報の取得に使用できます。これにより、IdentityVerification の複数のオブジェクトが返されます。各 IdentityVerification には次のものが含まれます。
    • verification_program: 身元確認プログラムの種類
    • identity_verification_requirement: 広告主が適格性確認を完了する期限に関する詳細が含まれます。
    • verification_progress。次のような確認セッションに関連する詳細情報が含まれます。
      • program_status は、この検証セッションの現在のステータスを表します。
      • action_url は、確認を完了するための URL にユーザーを誘導します。
      • invitation_link_expiration_time は、action_url の有効期限を表します。
  • 列挙型:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • エラー:
    • IdentityVerificationError
• AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT を追加しました。

アセット

• asset_group の変更:
  • segments.year や segments.month などの時間関連セグメントのサポートを追加しました。
  • リソースを分割する代わりに、campaign を属性付きリソースに変更しました。

キャンペーン

• デマンド ジェネレーション キャンペーンの変更点:
  • 既存のデマンド ジェネレーション キャンペーンに Campaign.shopping_setting を設定できるようになりました。
  • デマンド ジェネレーション キャンペーンのオプションの商品フィードを無効にする ShoppingSetting.disable_product_feed を追加しました。
  • Ad.demand_gen_product_ad と、対応する DemandGenProductAdInfo を追加しました。null 以外の Campaign.shopping_setting を使用するデマンド ジェネレーション キャンペーンで使用できます。
• 広告グループが配信されているかどうか、または配信されない理由を示すため、AdGroup に以下のフィールドが追加されました。
  • primary_status
  • primary_status_reasons
• 広告グループの広告が配信されているかどうか、または配信されない理由を示す次のフィールドを AdGroupAd に追加しました。
  • primary_status
  • primary_status_reasons
• AdGroupError に次の値を追加しました。
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

テスト

• テストで同期を有効にするかどうかを指定する Experiment.sync_enabled を追加しました。同期を有効にしている場合、テストの実施中に元のキャンペーンに加えた変更は、自動的にテスト キャンペーンにコピーされます。
• ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE を追加しました。
• CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL を追加しました。

ホテル、旅行

• おすすめスポット広告の ListingDimensionInfo に次のフィールドを追加し、旅行アクティビティが利用可能な州や都市に基づいてリスティング グループを作成できるようにしました。
  • activity_state
  • activity_city
• travel_activity_performance_view に次のセグメントのサポートを追加しました。
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

ローカル サービス

• LocalServicesVerificationArtifact.business_registration_check_verification_artifact と BusinessRegistrationCheckArtifact を追加し、広告主が事業登録の適格性確認プロセスの進行状況をモニタリングできるようにしました。
• 新たにリソース local_services_employee を追加し、追加した従業員情報を広告主が取得できるようにしました。

計画

• AudienceInsightsAttributeMetadata から score を削除しました。

推奨事項

• 推奨事項のタイプや広告チャネルのタイプなど、指定された設定に基づいて推奨事項を返す RecommendationService.GenerateRecommendations() を追加しました。これは、キャンペーンの作成時に特に有用です。
• RecommendationMetrics.conversions_value を追加しました。
• キーワードのマッチタイプが未設定の推奨キーワードの recommended_match_type が、UNKNOWN ではなく UNSPECIFIED に設定されるようになりました。
• 次の種類の推奨事項を追加しました。
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN: 「コンバージョン値の最大化」入札戦略を有効にすることを推奨
  • IMPROVE_GOOGLE_TAG_COVERAGE: Google タグをより多くのページに実装することを推奨
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN: P-MAX キャンペーンで最終ページ URL の拡張機能を有効にすることをおすすめします
  • REFRESH_CUSTOMER_MATCH_LIST: 過去 90 日間更新されていない顧客リストの更新を推奨します
  • CUSTOM_AUDIENCE_OPT_IN: カスタム オーディエンスの作成をおすすめします
  • LEAD_FORM_ASSET: キャンペーン単位または顧客単位でリードフォーム アセットを追加することをおすすめします
  • IMPROVE_DEMAND_GEN_AD_STRENGTH - デマンド ジェネレーション キャンペーンの広告の有効性の改善を推奨

ショッピング

• Comparison Shopping Service Center アカウントにリンクされたショッピング キャンペーンについて、より詳細なエラーを表示するために、CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT と CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS を追加しました。
• 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

ライフサイクル目標

• CustomerLifecycleGoalOperation と CampaignLifecycleGoalOperation に update を追加し、これらのオペレーション タイプと API の他のオペレーション タイプとの一貫性を持たせました。

バージョン 15（2023 年 10 月 18 日）

v15 で導入された新機能と更新は次のとおりです。

アカウントの管理

• 不正なアカウント アクティビティが原因でアカウントが停止された場合、customer.status と customer_client.status は SUSPENDED として返されるようになりました。以前は、ENABLED として返されていました。
• Google 広告アカウントと Merchant Center アカウント間のリンクの追加と削除がサポートされるようになりました。
  • ProductLink.merchant_center と MerchantCenterIdentifier を追加しました。
  • LinkedProductType.MERCHANT_CENTER を追加しました。
• Hotel Center と Merchant Center のアカウントで利用可能な、他のサービスから送信されるリンク招待の更新をサポートする ProductLinkInvitationService と ProductLinkInvitation を追加しました。
• MerchantCenterLinkService が削除されました。
  • Google 広告アカウントを Merchant Center アカウントにリンクするには、ProductLinkInvitationService と ProductLinkService を使用します。
• AccountLink.hotel_center を削除し、AccountLinkService を使用して Hotel Center アカウントからリンクの招待を更新するサポートを削除しました。
  • Hotel Center アカウントからリンクの招待を更新するには、ProductLinkInvitationService を使用します。

アセット

• アセットを使用した画像の追加と削除をサポートするため、ImageAdInfo.media_file を ImageAdInfo.image_asset に置き換えました。これに伴い、不要になった MediaFileService を削除しました。
• カスタムラベルと URL 部分文字列に基づいてリスティング グループ フィルタを作成できるように、ListingGroupFilterDimension.webpage を追加しました。
  • また、AssetGroupListingGroupFilter.vertical を AssetGroupListingGroupFilter.listing_source と ListingGroupFilterListingSource に置き換えました。
• アセット グループ アセットのソースを表示する asset_group_asset.source を追加しました。
• 広告グループの広告アセットのソースを表示する ad_group_ad_asset_view.source を追加しました。

オーディエンス

• カスタマー マッチでは、同意の提供をサポートするために CustomerMatchUserListMetadata.consent が追加されました。2024 年 3 月 6 日以降、EEA ユーザーの同意が得られていない場合、同意の値は「同意なし」と判断されます。同意していない EEA ユーザーからのデータは処理されず、カスタマー マッチを使った広告のパーソナライズには使用できません。詳しくは、カスタマー マッチ ガイドをご覧ください。
• 店舗販売について、同意の提供をサポートするために UserData.consent を追加しました。詳しくは、店舗販売ガイドをご覧ください。店舗販売でカスタマー マッチを使用している場合は、よくある質問で詳細をご確認ください。
• 類似セグメント（指定された既存のシード オーディエンスに基づいて作成されるオーディエンス）の作成をサポートするために、UserList.lookalike_user_list を追加しました。類似セグメントは、デマンド ジェネレーション キャンペーンでのみ使用できます。

キャンペーン

• P-MAX キャンペーンの更新:

  • AssetGroupSignal では、アセット グループに追加して、ターゲティングの精度を高める 2 つのシグナルタイプがサポートされるようになりました。
    • AssetGroupSignal.audience
      • Audience.scope と Audience.asset_group を追加し、オーディエンスの使用を特定のアセット グループに制限しました。Audience.asset_group は、Audience.scope が ASSET_GROUP の場合にのみ設定する必要があります。
    • AssetGroupSignal.search_theme
      • この新しい条件タイプをサポートする CriterionType.SEARCH_THEME を追加しました。この新しい条件タイプは、AssetGroupSignal.search_theme に SearchThemeInfo 条件を入力して AssetGroupSignal を作成する場合にのみ、P-MAX キャンペーンで使用できます。
  • アセット グループのシグナルを追加する際に除外をリクエストできるように AssetGroupSignalOperation.exempt_policy_violation_keys を追加しました。
  • アセット グループ単位でパフォーマンス上位のアセットをレポートする新しい asset_group_top_combination_view を追加しました。
  • 指標フィールドを使用して asset_group をクエリし、P-MAX キャンペーンのパフォーマンスを取得できるようになりました。
  • PerformanceMaxUpgradeStatus で、UPGRADE_ELIGIBLE の名前を UPGRADE_ELIGIBLE に変更しました。

• デマンド ジェネレーション キャンペーンとファインドの目標コンバージョン単価キャンペーンの場合、キャンペーン単位の目標コンバージョン単価の入札単価シミュレーション（campaign_simulation.target_cpa_point_list.points）では、TargetCpaSimulationPoint.clicks ではなく TargetCpaSimulationPoint.interactions が返されるようになりました。

• 指定されたブランドの接頭辞とブランドの除外リストに基づいてブランドを提案できる BrandSuggestionService を追加しました。これらのブランドを使用して BRAND 条件を作成し、BRANDS 共有設定に追加してから、brand_list を共有設定に設定して CampaignCriterion を作成することで、キャンペーンに関連付けることができます。キャンペーンの条件は、検索キャンペーンでターゲットに設定し、P-MAX キャンペーンで除外できます。

  • フィールド:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • 列挙型:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• 各アセットタイプの自動化ステータスを表示する Campaign.asset_automation_settings[] を追加しました。

• CampaignPrimaryStatusReason 列挙型に次の値を追加しました。

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

コンバージョン数

• 同意の提供をサポートするために CallConversion.consent と ClickConversion.consent を追加しました。詳しくは、通話コンバージョン ガイドとクリック コンバージョン ガイドをご覧ください。
• SKAdNetwork コンバージョンに関連する次のフィールドが追加されました。これらのフィールドは、customer または campaign でクエリする場合に使用できます。
  • セグメント:
    • 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
  • 指標:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• metrics.sk_ad_network_conversions を metrics.sk_ad_network_installs に置き換えました。
• オフライン コンバージョンのアップロードの診断のサポートを追加しました
  • offline_conversion_upload_client_summary を customer リソースのフィールドから最上位のレポートに移動しました。このレポートを使用すると、成功したイベント数、成功率、エラーの割合など、コンバージョン アップロードのステータスに関する有用な詳細情報を取得できます。
    • 注意点: アップロードされたコンバージョンで ConversionUploadError.CLICK_NOT_FOUND エラーが発生した場合でも、成功とみなされますが、OfflineConversionAlert のフラグも付きます。
  • 次のリクエスト タイプのオプション パラメータとして job_id を追加しました。これにより、複数のアップロード リクエストを 1 つの概念的なジョブに論理的にグループ化できます。
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • 次のエラーに INVALID_JOB_ID を追加しました。
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • 次のエラーの INVALID_CONVERSION_ACTION を NO_CONVERSION_ACTION_FOUND と INVALID_CONVERSION_ACTION_TYPE に置き換えました。
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Android プライバシー サンドボックスのクロスネットワーク アトリビューション（リダイレクトなし）をサポートする 3 つのレポートを追加しました。
  • android_privacy_shared_key_google_campaign。shared_campaign_key と、鍵のエンコードに役立つフィールドが含まれます。
  • android_privacy_shared_key_google_ad_group。shared_ad_group_key と、鍵のエンコードに役立つフィールドが含まれます。
  • android_privacy_shared_key_google_network_type。shared_network_type_key と、鍵のエンコードに役立つフィールドが含まれます。
• ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS を追加しました。非推奨のルールベースのアトリビューション モデルのいずれかを使用しようとすると、ConversionActionOperation がこのエラーで失敗するようになりました。以前は、オペレーションが UNKNOWN エラーで失敗していました。

ホテル、旅行

• travel_activity_group_view と travel_activity_performance_view に次のフィールドのサポートを追加しました。
  • セグメント:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • 指標:
    • 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

ローカル サービス広告

• ローカル サービスの広告主に関する詳細なライセンスと保険のステータスを返すため、LocalServicesSettings とそのフィールドを customer レポートに追加しました。
• ローカル サービスに次の新しいレポートを追加しました。
  • local_services_lead には、ローカル サービス広告の見込み顧客（lead_charged、lead_type、lead_status など）に関する詳細情報がすべて含まれます。
    • 列挙型:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation には、メッセージと電話での会話の詳細（conversation_channel、call_duration_millis、call_recording_url など）が含まれます。
    • 通話の録音 URL は、対象のお客様のアカウントとその MCC アカウントに対して認証されます。
  • local_services_verification_artifact は、バックグラウンド チェック、営業許可証、事業保険データなど、ローカル サービス広告主のアーティファクトを返します。ライセンスと保険に関連するドキュメントには、URL からアクセスできます。
    • 列挙型:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

計画

• 該当する商品カテゴリの ReachPlanService.ListPlannableProducts で Forecast.views と PlannedProductForecast.views を返すサポートを追加しました。
• 商品で使用可能なサーフェスを記述する ReachPlanService.ListPlannableProducts の PlannableTargeting.surface_targeting を返すサポートを追加しました。
• 新しい ReachPlanSurface 列挙型を追加しました。
• PlannedProductForecast.average_frequency を返す AdvancedProductTargeting.target_frequency_settings を使用したフリークエンシー目標設定のサポートを追加しました。
• ターゲット設定可能なオーディエンスの候補を返す AudienceInsightsService.GenerateSuggestedTargetingInsights を追加しました。
• ReachPlanError に次の値を追加しました。
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

推奨事項

• おすすめコンテンツのサブスクリプションを管理する RecommendationSubscriptionService を追加しました。
  • リソース: RecommendationSubscription
  • フィールド: MutateOperation.recommendation_subscription_operation
  • 列挙型: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • エラー:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• 次の種類の推奨事項を追加しました。
  • FORECASTING_SET_TARGET_CPA: トラフィックの増加が見込まれる季節性イベントに先立ち、指定していないキャンペーンの目標コンバージョン単価を設定することをおすすめします。
  • SET_TARGET_CPA: 目標コンバージョン単価を指定していないキャンペーンでは、目標コンバージョン単価を設定することをおすすめします。
  • SET_TARGET_ROAS: 目標広告費用対効果を指定していないキャンペーンには、目標広告費用対効果を設定することをおすすめします。

報告

• campaign（ディスプレイ キャンペーン、動画キャンペーン、ファインド キャンペーン、アプリ キャンペーンで利用可能）と segments.device でクエリできる次の新しい指標を追加しました。
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

ショッピング

• 値が ShoppingSetting.feed_label として返される ShoppingSetting.sales_country を削除しました。
  • ShoppingSetting.feed_label フィールドを使用すれば、キャンペーンで引き続き特定の Merchant Center フィードを使用できます。フィードラベルの値、または以前に ShoppingSetting.sales_country に使用されていた 2 文字の国コードを設定する必要があります。詳しくは、フィードラベルのサポート記事をご覧ください。
• レポートにおける国コードへの商品カテゴリの依存関係を削除しました。 サポートされているカテゴリ ID のセットに変更はありません。
  • shopping_performance_view で使用されている次のフィールドを置き換えました。
    • segments.product_bidding_category_level1 は、segments.product_category_level1 に置き換えます。
    • segments.product_bidding_category_level2 は、segments.product_category_level2 に置き換えます。
    • segments.product_bidding_category_level3 は、segments.product_category_level3 に置き換えます。
    • segments.product_bidding_category_level4 は、segments.product_category_level4 に置き換えます。
    • segments.product_bidding_category_level5 は、segments.product_category_level5 に置き換えます。
  • product_bidding_category_constant を product_category_constant に置き換えました。これは、繰り返しフィールドのカテゴリで使用可能なすべてのローカライズを返すようになります。
  • ListingDimensionInfo.product_bidding_category を ListingDimensionInfo.product_category に置き換えました。
  • ListingGroupFilterDimension.product_bidding_category を ListingGroupFilterDimension.product_category に置き換えました。
• 検索キャンペーンへの Campaign.shopping_setting の追加はサポートを終了しました。Campaign.shopping_setting を使って検索キャンペーンを作成したり、既存の検索キャンペーンに Campaign.shopping_setting を追加しようとすると、OPERATION_NOT_PERMITTED_FOR_CONTEXT が表示されるようになりました。
• 検索キャンペーンへの CampaignCriterion.listing_scope の追加はできなくなりました。既存の検索キャンペーンに CampaignCriterion.listing_scope を追加しようとすると、OPERATION_NOT_PERMITTED_FOR_CONTEXT が表示されるようになりました。
• 次のカートデータ コンバージョンの指標を追加しました。
  • 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
  • これらの指標はすべて、次のレポートで選択できます。
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

統合された目標

• 顧客単位で顧客獲得目標を設定するための CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals を追加しました。
  • 報告: customer_lifecycle_goal
• キャンペーン単位で顧客獲得目標を設定するための CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals を追加しました。
  • 報告: campaign_lifecycle_goal
• CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN を追加しました。
• ConversionGoalCampaignConfigError に次の値を追加しました。
  • EMPTY_CONVERSION_GOALS
  • STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
  • PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

動画

• キャンペーン レベルでの Google TV のターゲティングのサポートを追加しました。
  • NetworkSettings.target_google_tv_network を追加しました。
  • AdNetworkType.GOOGLE_TV を追加しました。
• キャンペーン単位で YouTube をターゲットに設定できるようになりました。
  • NetworkSettings.target_youtube を追加しました。
  • AdNetworkType で、YOUTUBE_WATCH と YOUTUBE_SEARCH を YOUTUBE に統合しました。
  • CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE を追加しました。

バージョン 14.1.0（2023 年 8 月 9 日）

v14.1 で導入された新機能と更新は次のとおりです。

アカウントの管理

• Customer.customer_agreement_setting: 顧客がリードフォームの利用規約に同意したかどうかを示します。

アセット

• アセット グループが配信されているかどうか、またはアセット グループが配信されていない理由を表示するため、AssetGroup に次の新しいフィールドが追加されました。
  • primary_status
  • primary_status_reasons
• アセット グループのアセットが配信されているかどうか、または配信されていない理由を表示する AssetGroupAsset の新しいフィールド:
  • primary_status
  • primary_status_details
  • primary_status_reasons
• CallToActionType 列挙型の新しい値:
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
• AssetLinkError 列挙型の新しい値:
  • CUSTOMER_NOT_VERIFIED
  • UNSUPPORTED_CALL_TO_ACTION
  • PAGE_FEED_INVALID_LABEL_TEXT

請求

• Invoice と AccountSummary の新しいフィールド:
  • export_charge_subtotal_amount_micros
  • export_charge_tax_amount_micros
  • export_charge_total_amount_micros

キャンペーン

• CampaignPrimaryStatusReason 列挙型の新しい値:

  • HAS_ASSET_GROUPS_DISAPPROVED
  • HAS_ASSET_GROUPS_LIMITED_BY_POLICY
  • MOST_ASSET_GROUPS_UNDER_REVIEW

• （許可リストに登録されたアカウントのみ）upgraded_targeting を指定した DiscoveryCampaignSettings:

  • upgraded_targeting が true に設定されている場合は、広告グループの条件として地域と言語を追加できます。

条件

• 新しい列挙値: CriterionError.INVALID_DETAILED_DEMOGRAPHIC

• （許可リストに登録されたアカウントのみ）LanguageInfo と LocationInfo を AdGroupCriterion として追加できます。

  • これは、アップグレードされたターゲティングが有効になっているファインド キャンペーンでのみご利用いただけます

テスト

• ExperimentError 列挙型の新しい値:
  • DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
  • CANNOT_REMOVE_IN_CREATION_EXPERIMENT
  • CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES

推奨事項

• 新しいタイプの推奨事項:
  • PerformanceMaxOptInRecommendation: アカウントに最初の P-MAX キャンペーンを作成することをおすすめします
  • ImprovePerformanceMaxAdStrengthRecommendation: P-MAX キャンペーンのアセット グループの有効性を改善することをおすすめします
  • MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation: 動的検索広告キャンペーンを P-MAX に移行することをおすすめします

報告

• 新規顧客とリピーターに関する新しい指標とセグメント:
  • metrics.new_customer_lifetime_value
  • metrics.all_new_customer_lifetime_value
  • segments.new_versus_returning_customers
• 新しい customer_search_term_insight ビューと campaign_search_term_insight ビュー:
  • metrics.search_volume は、検索語句に関する分析情報カテゴリの音量範囲を示します。

ショッピング

• リスティング グループの新しいフィールド:
  • ListingGroupInfo.path
  • AssetGroupListingGroupFilter.path
• 新しいフィールド: ShoppingSetting.advertising_partner_ids
• CampaignError 列挙型の新しい値:
  • NOT_LINKED_ADVERTISING_PARTNER
  • INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS

動画

• （許可リストに登録されたアカウントのみ）AdType.DISCOVERY_VIDEO_RESPONSIVE_AD とそれに対応する DiscoveryVideoResponsiveAdInfo

バージョン 14（2023 年 6 月 7 日）

v14 で導入された新機能と更新は次のとおりです。

キャンペーン

• CampaignBudgetError.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD を追加しました

コンバージョン数

• Google アナリティクスのコンバージョンを識別し、コンバージョンがユニバーサル アナリティクス プロパティと GA4 プロパティのどちらからインポートされたかを判断するためのサポートが追加されました。

  • ConversionActionType に次の値を追加しました。
    • UNIVERSAL_ANALYTICS_GOAL
    • UNIVERSAL_ANALYTICS_TRANSACTION
    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE
  • ConversionAction.google_analytics_4_settings を追加しました

• Customer.offline_conversion_client_summaries を追加しました。これは、お客様のオフライン コンバージョンのアップロードと調整のステータスと診断情報をまとめたものです。

  • 列挙型
    • OfflineEventUploadClient:
      • GOOGLE_ADS_API
      • GOOGLE_ADS_WEB_CLIENT
      • ADS_DATA_CONNECTOR
    • OfflineConversionDiagnosticStatus:
      • EXCELLENT
      • GOOD
      • NEEDS_ATTENTION
      • NO_RECENT_UPLOAD

• レスポンスを OfflineConversionUploadSummary.job_id に関連付けるため、ConversionAdjustmentUploadService.UploadConversionAdjustments と ConversionUploadService.UploadClickConversions から返されるレスポンスに job_id を追加しました。

条件

• アカウント単位の除外キーワードを取得、作成、更新するためのサポートが追加されました。

  • フィールド:
    • CustomerNegativeCriterion.negative_keyword_list
  • 列挙型:
    • CriterionType.NEGATIVE_KEYWORD_LIST
    • SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
    • ResourceLimitType
      • SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
      • ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
  • エラー:
    • CriterionError
      • NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
      • CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
      • CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
      • CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE

• CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST を追加しました

ホテル広告

• SuggestTravelAssetsRequest.place_id の名前を SuggestTravelAssetsRequest.place_ids に変更しました。

計画

• KeywordPlanService から次のメソッドを削除しました。
  • GenerateForecastCurve
  • GenerateForecastMetrics
  • GenerateForecastTimeSeries
  • GenerateHistoricalMetrics
• KeywordPlanIdeaService.GenerateKeywordForecastMetrics が追加され、キーワード プランを最初に作成することなく、キーワード キャンペーンの予測指標を生成できるようになりました。
• campaign_criterion_simulation レポートを取得するためのサポートを終了しました
• AudienceInsightsService.ListAudienceInsightsAttributes のディメンションとして YOUTUBE_DYNAMIC_LINEUP のサポートを追加しました。
• Lineups 内でサンプル チャンネルを提供するため、GenerateAudienceCompositionInsights レスポンスで使用される DynamicLineupAttributeMetadata.sample_channels を追加しました。

推奨事項

• アカウントで動的画像表示オプションを有効にすることを推奨する DynamicImageExtensionOptInRecommendation を追加しました
• 目標広告費用対効果の引き下げを推奨する LowerTargetRoasRecommendation を追加しました
• 目標コンバージョン単価の引き上げを提案する RaiseTargetCpaRecommendation を追加しました
• ResponsiveSearchAdAssetRecommendation.current_ad を追加しました

報告

• ad_group_ad_asset_view.pinned_field から利用できる ServedAssetFieldType に次の値を追加しました。
  • SITELINK
  • CALL
  • MOBILE_APP
  • CALLOUT
  • STRUCTURED_SNIPPET
  • PRICE
  • PROMOTION
  • AD_IMAGE
  • LEAD_FORM
  • BUSINESS_LOGO

リリースノートのアーカイブ

アーカイブ済みのリリースノートについては、廃止されたバージョンをご覧ください。