リリースノート

バージョン 17.1.0（2024 年 8 月 7 日）

v17_1 で追加された機能とアップデートは次のとおりです。

アセット

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() を使用すると、レスポンシブ検索広告にリンクされている特定の自動作成アセットを削除できます。

オーディエンス

• 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

キャンペーン

• ShareablePreviewService.GenerateShareablePreviews() では、有効または一時停止中のアセット グループの共有可能な広告プレビュー用の URL（レスポンスの shareable_preview_url）が生成されます。
  • expiration_date_time フィールドは、レスポンスに含まれる URL の有効期限を示します。
  • エラーが発生すると、メソッドは URL ではなく partial_failure_error を返します。

変更履歴

• 新しい変更ステータスのリソースタイプ: ASSET_GROUP。

コンバージョン数

• SKAdNetwork バージョン用の新しいセグメント フィールド: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary: コンバージョン アクション単位でコンバージョンのアップロードの診断情報を表示します。
• オフライン診断レポートに次の指標が追加され、アップロード済みの処理中のコンバージョンの数が示されます。 <ph type="x-smartling-placeholder">
  </ph>
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

計画

• AudienceInsights.GenerateAudienceOverlapInsights() は、入力のプライマリ属性とオーディエンス属性のコレクションを受け取り、プライマリ属性とオーディエンス属性の間で YouTube の潜在的なリーチの重複の推定を返します。

レポート

• segments.date に基づく per_store_view のセグメント化のサポート

動画

• ad_group、campaign などのレポートを使用して、動画キャンペーン向けの次の標準入札戦略に関する情報を取得できるようになりました。
  • Campaign.fixed_cpm（固定 CPM（インプレッション単価））
  • Campaign.target_cpv（目標広告視聴単価）
• Campaign.video_campaign_settings: 次のレポート フィールドを使用して、動画広告を表示できる広告枠を指定できます。
  • 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: 動画広告フォーマットのタイプに基づいて次のレポートを分割できます。
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

バージョン 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 バイトを超える場合にスローされます。
• MutateOperation.asset_group_operation の設定のサポートを追加しました。 BatchJobService を使用する場合。これにより、 バッチ処理を使用して P-MAX キャンペーン全体を管理できる。新しい専用ガイドをご覧ください。

キャンペーン

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

コンバージョン数

• SKAdNetwork 向け コンバージョン、 <ph type="x-smartling-placeholder">
  </ph>
  • 名前を segments.sk_ad_network_conversion_value に変更しました segments.sk_ad_network_fine_conversion_value。
  • segments.sk_ad_network_redistributed_fine_conversion_value を追加しました。
• 次の指標がレスポンスで返されるようになりました。これは、 0 になります。これにより、他の指標との整合性が確保されます。
  • 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
• metrics.search_impression_share のサポートを追加しました。 gender_view 向け
• metrics.phone_calls のサポートを追加しました。 keyword_view 向け

ローカル サービス

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

レポート

• 1 つのリンクされたサービスに関連するフィールドのみを選択できるようになりました product_link に対してクエリを実行するとき。複数選択 フィールドがスローされる場合、 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 エラーが発生します。

ショッピング

• 新しいレポート shopping_product を追加しました。 は、Google 広告管理画面の [商品] ページに対応しています。また、 Google Merchant Center からの商品の現在の状態に関するデータ Google 広告アカウントにリンクされているアカウント
  • 指標をフィルタするには、 shopping_product レポートの使い方 segments.date: GoogleAdsService.Search または GoogleAdsService.SearchStream。 日付による分割はできず、 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
• AdVideoAsset.ad_video_asset_info を追加しました 動画アセットを作成する際のインベントリ設定を DemandGenVideoResponsiveAdInfo。
• （許可リストに追加されたアカウントのみ）作成済み 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 に制限されます。

キャンペーン

• Target の戻り値のサポート 広告費用対効果キャンペーンでの入札単価シミュレーション アプリ キャンペーン 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。
• data_partner と google_ads を次の場所から削除しました: AccountLink。
• 追加済み IdentityVerificationService～ 広告主様の適格性確認を管理する。
  • StartIdentityVerification() : 指定された ID を使用して確認セッションを開始 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 を以下に追加しました テストで同期を有効にするかどうかを指定します。同期あり 有効になり、バージョン 2 で テストの実施中は元のキャンペーンで コピーされます
• 追加済み 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 - 許可 広告主自身が追加した従業員情報を取得できます。

計画

• score さんを次から削除しました: AudienceInsightsAttributeMetadata。

推奨事項

• 追加済み 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 デマンド ジェネレーション キャンペーンの広告の有効性の改善を提案する

ショッピング

• 追加済み CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT および CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS にリンクされたショッピング キャンペーンについて、より詳細なエラーを Comparison Shopping Service Center できます。
• 次の値を 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 の他のオペレーション タイプと整合するようにしています。

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

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

アカウント管理

• アカウントが不正アクセスされたことが原因でアカウントが停止された場合 アクティビティ、 customer.status、 customer_client.status 今度は SUSPENDED を選択します。 以前は、 ENABLED。
• Google 広告アカウントと Merchant Center アカウント:
  • 追加済み ProductLink.merchant_center、 MerchantCenterIdentifier。
  • 追加済み LinkedProductType.MERCHANT_CENTER。
• 追加済み ProductLinkInvitationService、 ProductLinkInvitation のサポート 他のサービスから送信されたリンクの招待を更新する（ホテル向け） Center と Merchant Center アカウントに移行する必要があります。
• MerchantCenterLinkService が削除されました。
  • Google 広告アカウントと Merchant Center アカウントをリンクするには、以下を使用: ProductLinkInvitationService および ProductLinkService。
• AccountLink.hotel_center と、リンクの招待の更新のサポートを削除しました Hotel Center アカウントから AccountLinkService。
  • Hotel Center アカウントからリンクの招待を更新するには、次のコマンドを使用します。 ProductLinkInvitationService。

アセット

• 「ImageAdInfo.media_file」を次に置き換えました ImageAdInfo.image_asset でサポート アセットを使用して画像を追加、削除できます。そのため、 MediaFileService: 不要になった。
• 追加済み ListingGroupFilterDimension.webpage カスタムラベルと URL に基づくリスティング グループ フィルタの作成をサポート。 部分文字列だけを取り出します。
  • AssetGroupListingGroupFilter.vertical も次に置き換えました AssetGroupListingGroupFilter.listing_source および ListingGroupFilterListingSource
• 表示対象の asset_group_asset.source を追加しました アセット グループ アセットの参照元
• 追加済み ad_group_ad_asset_view.source～ 広告グループの広告アセットのソースを表示します。

オーディエンス

• カスタマー マッチについて CustomerMatchUserListMetadata.consent 同意シグナルの入力もサポートします同意が以下の場合、2024 年 3 月 6 日以降 の値がない場合、同意の値は「同意なし」と判断されます。 同意を得ていない 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 新しい条件タイプをサポートしていますこの新しい条件タイプは P-MAX キャンペーンで使用して、AssetGroupSignalを作成します 新しい P-MAX キャンペーンを AssetGroupSignal.search_theme （SearchThemeInfo 条件で）
  • 追加済み 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.interactions 、 TargetCpaSimulationPoint.clicks を選択します。

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

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

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

• 次の値を CampaignPrimaryStatusReason enum:

  • 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 つの概念的な 1 つのコンセプトに論理的に job:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • 次のエラーに INVALID_JOB_ID を追加しました。
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • INVALID_CONVERSION_ACTION を NO_CONVERSION_ACTION_FOUND に置き換え、 次のエラーの INVALID_CONVERSION_ACTION_TYPE:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Android プライバシー サンドボックスのクロスネットワークをサポートする 3 つのレポートを追加しました アトリビューションなし リダイレクト: <ph type="x-smartling-placeholder">
  </ph>
  • 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: サポートが終了したルールベースのアトリビューションのいずれかを モデル 失敗します。以前は、HTTP リクエスト エラーで 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 レポートにフィールドを追加して、 広告主のライセンスと保険に関するきめ細かいステータスを提供します。
• ローカル サービス: <ph type="x-smartling-placeholder">
  </ph>
  • local_services_lead にはすべての ローカル サービスの詳細 lead_charged などの Google 広告の見込み顧客 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

計画

• Forecast.views と PlannedProductForecast.views: ReachPlanService.ListPlannableProducts 確認してください
• 返品のサポートを追加しました PlannableTargeting.surface_targeting ReachPlanService.ListPlannableProducts, これはプロダクトで利用可能なサーフェス
• 新しく追加されました ReachPlanSurface 列挙型。
• ターゲット ターゲティングのサポートを追加しました。 使用頻度 AdvancedProductTargeting.target_frequency_settings, このメソッドは、 PlannedProductForecast.average_frequency。
• 追加済み 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.sales_country を削除しました。 ShoppingSetting.feed_label。
  • 特定の Merchant Center を引き続き使用できます。 フィードを作成する ShoppingSetting.feed_label 表示されます。フィードラベルの値または 2 文字の国に設定する必要があります 以前に ShoppingSetting.sales_country で使用されていたコード。詳しくは 詳しくは、フィードに関する ラベル。
• レポートにおける国コードへの商品カテゴリの依存関係を削除しました。 サポートされているカテゴリ 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。
• カートでの次のコンバージョンを追加 data 指標: <ph type="x-smartling-placeholder">
  </ph>
  • 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。

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

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