バージョン 17(2024 年 6 月 5 日)
v17 で次の機能と変更が追加されました。
関連
AdService.getAd
を削除しました。これにより、AdService
は Google Ads API の他のサービスと同じような形になります。広告やその他のリソースタイプを取得するためのおすすめの方法については、オブジェクトの取得をご覧ください。- ディメンションと形式に関する
ImageAdInfo.image_asset
の検証を追加しました。画像が無効な場合は、次のエラーがスローされることがあります。
アセット
- 新しい列挙型
ClickType.AD_IMAGE
を追加しました。 - P-MAX キャンペーンと検索キャンペーンの新しい指標を含む以下の新しいレポートを追加しました。
オーディエンス
バッチジョブ
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
を追加しました。
- 次の指標がゼロであっても、レスポンスで返されるようになりました。これにより、他の指標との整合性が確保されます。
条件
- 広告グループの条件が配信されているかどうか、または配信されていない理由を示すため、
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
。
テスト
ローカル サービス
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
で検証セッションを開始するために使用されます。新しい検証セッションが作成され、検証が正常に作成された場合は空のレスポンスが返されます。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
ライフサイクル目標
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
を使用します。
- Google 広告アカウントを Merchant Center アカウントにリンクするには、
AccountLink.hotel_center
を削除し、AccountLinkService
を使用して 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
ローカル サービス広告
- ローカル サービスの広告主に関する詳細なライセンスと保険のステータスを返すため、
LocalServicesSettings
とそのフィールドをcustomer
レポートに追加しました。 - ローカル サービスに次の新しいレポートを追加しました。
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
を追加しました。 - キャンペーン単位で顧客獲得目標を設定するための
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
を追加しました。 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
を追加しました。
リリースノートのアーカイブ
アーカイブ済みのリリースノートについては、廃止されたバージョンをご覧ください。