v16.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
テスト
ローカル サービス
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
v16(2024 年 2 月 21 日)
v16 では、以下の機能と変更点が追加されました。
アカウントの管理
advertising_partner
をAccountLink
からProductLink
とProductLinkInvitation
に移行しました。AccountLink
からdata_partner
とgoogle_ads
を削除しました。- 広告主様の適格性確認を管理するために
IdentityVerificationService
を追加しました。StartIdentityVerification()
は、指定されたverification_program
で検証セッションを開始するために使用されます。新しい検証セッションを作成し、正常に作成された検証に対して空のレスポンスを返します。GetIdentityVerification()
は検証情報の取得に使用でき、IdentityVerification
の複数のオブジェクトを返します。各IdentityVerification
には以下が含まれます。verification_program
(本人確認プログラム タイプ)identity_verification_requirement
: 広告主が確認を完了する期限に関する詳細が含まれています。verification_progress
。次のような確認セッションに関する詳細情報が含まれます。program_status
は、この確認セッションの現在のステータスを表します。action_url
は、確認を完了するための URL にお客様を誘導します。invitation_link_expiration_time
はaction_url
の有効期限を表します。
- 列挙型:
- エラー:
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
に以下のフィールドを追加しました。これにより、旅行アクティビティが利用可能な州と都市に基づいてリスティング グループを作成できるようになりました。 travel_activity_performance_view
に次のセグメントのサポートを追加しました。
ローカル サービス
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
ライフサイクル目標
update
をCustomerLifecycleGoalOperation
とCampaignLifecycleGoalOperation
に追加し、これらのオペレーション タイプと API の他のオペレーション タイプとの整合性を確保しました。
v15(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
を使用します。
- Google 広告アカウントを Merchant Center アカウントにリンクするには、
AccountLinkService
を使用した Hotel Center アカウントからのリンクの招待の更新と、AccountLink.hotel_center
のサポートを削除しました。- Hotel Center アカウントからのリンク招待を更新するには、
ProductLinkInvitationService
を使用します。
- Hotel Center アカウントからのリンク招待を更新するには、
アセット
- アセットを使用した画像の追加と削除をサポートするために、
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 キャンペーンではそれぞれ除外できます。各アセットタイプの自動化ステータスを表示する
Campaign.asset_automation_settings[]
を追加しました。CampaignPrimaryStatusReason
列挙型に次の値を追加しました。NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
コンバージョン数
- 同意の提供をサポートするため、
CallConversion.consent
とClickConversion.consent
を追加しました。詳しくは、通話コンバージョン ガイドとクリック コンバージョン ガイドをご覧ください。 - SKAdNetwork コンバージョンに関連する以下のフィールドを追加しました。これらのフィールドは、
customer
またはcampaign
でクエリするときに使用できます。 metrics.sk_ad_network_conversions
をmetrics.sk_ad_network_installs
に置き換えました。- オフライン コンバージョンのアップロードを診断できるようになりました
offline_conversion_upload_client_summary
をcustomer
リソースのフィールドからトップレベル レポートに移動しました。このレポートを使用すると、成功したイベントの数、成功率、エラーの割合など、コンバージョンのアップロード ステータスに関する有用な情報を取得できます。- 注意点: アップロードされて
ConversionUploadError.CLICK_NOT_FOUND
エラーが発生するコンバージョンも、成功としてカウントされますが、OfflineConversionAlert
のフラグも付きます。
- 注意点: アップロードされて
- 次のリクエスト タイプのオプション パラメータとして
job_id
を追加しました。これにより、複数のアップロード リクエストを 1 つの概念的なジョブに論理的にグループ化できます。 - 次のエラーに
INVALID_JOB_ID
を追加しました。 - 次のエラーの
INVALID_CONVERSION_ACTION
をNO_CONVERSION_ACTION_FOUND
とINVALID_CONVERSION_ACTION_TYPE
に置き換えました。
- リダイレクトなしの 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
に次のフィールドのサポートを追加しました。- セグメント:
- 指標:
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
ローカル サービス広告
customer
レポートにLocalServicesSettings
とそのフィールドが追加され、ローカル サービス広告主のライセンスと保険の詳細なステータスが返されました。- ローカル サービス用に、以下の新しいレポートを追加しました。
local_services_lead
には、ローカル サービス広告の見込み顧客(lead_charged
、lead_type
、lead_status
など)に関するすべての詳細情報が含まれます。- 列挙型:
local_services_lead_conversation
には、メッセージと電話の会話の詳細(conversation_channel
、call_duration_millis
、call_recording_url
など)が含まれます。- 通話の録音 URL は、対象の顧客アカウントとその MCC アカウントに対して認証されます。
local_services_verification_artifact
は、バックグラウンド チェック、ビジネス ライセンス、事業保険データなどのローカル サービス広告主のアーティファクトを返します。ライセンスや保険に関連するドキュメントには、URL からアクセスできます。
計画
- 該当する商品カテゴリについて、
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
を追加しました。 - 次のタイプの推奨事項を追加しました。
FORECASTING_SET_TARGET_CPA
: トラフィックの増加が予想される季節限定イベントに先立って、目標コンバージョン単価が指定されていないキャンペーンに対して、目標コンバージョン単価を設定することが推奨されます。SET_TARGET_CPA
: 目標コンバージョン単価が指定されていないキャンペーンに対して、目標コンバージョン単価の設定が推奨されます。SET_TARGET_ROAS
: 目標広告費用対効果が指定されていないキャンペーンに目標広告費用対効果を設定することが推奨されます。
レポート
campaign
(ディスプレイ、動画、ファインド、アプリ キャンペーンで使用可能)とsegments.device
でクエリできる次の新しい指標を追加しました。
ショッピング
- 値が
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
- これらの指標はすべて、次のレポートで選択できます。
目標の統合
- 顧客レベルで顧客獲得目標を設定するための
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
を追加しました。
v14.1.0(2023-08-09)
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
に設定されている場合、地域と言語を広告グループの条件として追加できます。
条件
(許可リストに登録されたアカウントのみ)
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 に移行することをおすすめします
レポート
- 新規顧客とリピーターに関する新しい指標とセグメント:
- 新しい
customer_search_term_insight
ビューとcampaign_search_term_insight
ビュー:metrics.search_volume
は、検索語句に関する分析情報のカテゴリの音量範囲を示します。
ショッピング
- リスティング グループの新しいフィールド:
- 新しいフィールド:
ShoppingSetting.advertising_partner_ids
CampaignError
列挙型の新しい値:NOT_LINKED_ADVERTISING_PARTNER
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
動画
- (許可リストに登録されているアカウントのみ)
AdType.DISCOVERY_VIDEO_RESPONSIVE_AD
とそれに対応するDiscoveryVideoResponsiveAdInfo
v14(2023 年 6 月 7 日)
v14 では、以下の新機能と更新が導入されました。
キャンペーン
コンバージョン数
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
を追加しました。
条件
アカウント単位の除外キーワードの取得、作成、更新のサポートを追加しました。
- フィールド:
- 列挙型:
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
ホテル広告
SuggestTravelAssetsRequest.place_id
の名前をSuggestTravelAssetsRequest.place_ids
に変更しました。
計画
KeywordPlanService
から次のメソッドを削除しました。GenerateForecastCurve
GenerateForecastMetrics
GenerateForecastTimeSeries
GenerateHistoricalMetrics
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
が追加され、最初にキーワード プランを作成しなくても、キーワード キャンペーンの予測指標を生成できるようになりました。campaign_criterion_simulation
レポートの取得に対するサポートを終了しましたAudienceInsightsService.ListAudienceInsightsAttributes
のディメンションとしてYOUTUBE_DYNAMIC_LINEUP
のサポートを追加しました。DynamicLineupAttributeMetadata.sample_channels
を追加しました。これはGenerateAudienceCompositionInsights
レスポンスで使用され、Lineups 内のサンプル チャンネルを提供します。
推奨事項
- アカウントで動的画像表示オプションを有効にすることをおすすめする
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
リリースノートのアーカイブ
過去のリリースノートについては、廃止バージョンをご覧ください。