Method: customers.generateReachForecast

string

必須。顧客の ID。

{
  "dateRange": {
    object (DateRange)
  },
  "durationInDays": integer
}

object (DateRange)

キャンペーンの期間。日付は yyyy-mm-dd 形式で指定します。終了日には今後 1 年以内、期間は 92 日以内の日付を指定してください。

このフィールドは、durationInDays フィールドと組み合わせることはできません。

integer

期間の値（日数）。

このフィールドは、dateRange フィールドと組み合わせることはできません。

{
  "impressions": integer,
  "timeUnit": enum (FrequencyCapTimeUnit)
}

integer

必須。インプレッション数（その値を含む）。

enum (FrequencyCapTimeUnit)

必須。時間単位のタイプ。

{
  "effectiveFrequencyBreakdownLimit": integer
}

integer

Forecast.effective_frequency_breakdowns に含める最大有効フリークエンシー値。このフィールドでは 1 ～ 10 の頻度がサポートされます。

{
  "plannableLocationIds": [
    string
  ],
  "ageRange": enum (ReachPlanAgeRange),
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "network": enum (ReachPlanNetwork),
  "audienceTargeting": {
    object (AudienceTargeting)
  },
  "plannableLocationId": string
}

string

この予測でターゲットに設定できるプランニング可能な地域 ID のリスト。

複数の ID を指定する場合は、すべての ID に同じ parentCountryId を指定する必要があります。parent_county を超えるプランニングはサポートされていません。プランニング可能な地域 ID とその parentCountryId は ReachPlanService.ListPlannableLocations から取得できます。

リクエストでは、このフィールドか plannableLocationId のいずれかを設定する必要があります。

enum (ReachPlanAgeRange)

対象年齢層。値を設定しない場合、すべての年齢層がターゲットとなります。

object (GenderInfo)

ターゲットとする性別。値を設定しない場合、MALE や FEMALE を指定した場合と同じ結果になります。

object (DeviceInfo)

対象デバイス。指定しない場合、該当するすべてのデバイスが対象になります。該当するデバイスは製品と地域によって異なります。詳しくは ReachPlanService.ListPlannableProducts から入手できます。

enum (ReachPlanNetwork)

広告プロダクトのターゲティング可能なネットワーク。指定しない場合、該当するすべてのネットワークがターゲットになります。該当するネットワークはプロダクトと地域によって異なります。詳しくは ReachPlanService.ListPlannableProducts をご覧ください。

object (AudienceTargeting)

対象グループ指定しない場合、特定のオーディエンスはターゲットになりません。

string

選択したビジネスの ID。プランナブルな地域 ID は ReachPlanService.ListPlannableLocations から取得できます。

リクエストでは、このフィールドか plannableLocationIds のいずれかを設定する必要があります。

このフィールドは V12 で非推奨となり、今後のリリースで削除される予定です。plannableLocationIds を代わりに使用してください。

{
  "userInterest": [
    {
      object (UserInterestInfo)
    }
  ]
}

object (UserInterestInfo)

ターゲットに設定するユーザーの興味 / 関心に基づくオーディエンスのリスト。

{
  "advancedProductTargeting": {
    object (AdvancedProductTargeting)
  },
  "plannableProductCode": string,
  "budgetMicros": string
}

object (AdvancedProductTargeting)

選択した商品のターゲティング設定。各商品で利用可能なターゲティングを一覧表示するには、ReachPlanService.ListPlannableProducts を使用します。

string

必須。プランニング用に選択したプロダクト。広告プロダクトに関連付けられたコード（TrueView、バンパーなど）。利用可能なプランナブル商品コードを一覧表示するには、ReachPlanService.ListPlannableProducts を使用します。

string (int64 format)

必須。選択した商品の予算割り当ての上限（マイクロ秒単位）。この値は、選択したプランニングの currencyCode で指定されます。例: 1 000 000$ = 1 000 000 000 000 マイクロ。

{
  "surfaceTargetingSettings": {
    object (SurfaceTargeting)
  },
  "targetFrequencySettings": {
    object (TargetFrequencySettings)
  },

  // Union field advanced_targeting can be only one of the following:
  "youtubeSelectSettings": {
    object (YouTubeSelectSettings)
  }
  // End of list of possible types for union field advanced_targeting.
}

object (SurfaceTargeting)

この商品のターゲット設定を表示します。

object (TargetFrequencySettings)

フリークエンシー目標キャンペーンの設定。TARGET_FREQUENCY 商品を選択する場合は設定する必要があります。

フリークエンシー目標キャンペーンについて詳しくは、https://support.google.com/google-ads/answer/12400225 をご覧ください。

object (YouTubeSelectSettings)

YouTube Select ターゲティングの設定。

{
  "timeUnit": enum (TargetFrequencyTimeUnit),
  "targetFrequency": integer
}

enum (TargetFrequencyTimeUnit)

必須。targetFrequency の時間枠を記述するために使用される時間単位。

integer

必須。選択された時間単位あたりのフリークエンシー目標。

{
  "lineupId": string
}

string (int64 format)

YouTube Select ターゲティングの Lineups。

{
  "includeCoview": boolean
}

boolean

回答予測に共視聴指標を含めるかどうかを示します。

{
  "youtubeAudienceSize": string,
  "censusAudienceSize": string
}

string (int64 format)

YouTube で検討されたターゲティングと一致する参照オーディエンスのサイズ。

string (int64 format)

国勢調査で考慮されたターゲティングに一致する参照オーディエンスのサイズ。

{
  "reachForecasts": [
    {
      object (ReachForecast)
    }
  ]
}

object (ReachForecast)

リーチ曲線上のすべてのポイントです。

{
  "costMicros": string,
  "forecast": {
    object (Forecast)
  },
  "plannedProductReachForecasts": [
    {
      object (PlannedProductReachForecast)
    }
  ]
}

string (int64 format)

マイクロ単位の費用。

object (Forecast)

このポイントの予測トラフィック指標。

object (PlannedProductReachForecast)

リーチ曲線上のこの時点における、予定された商品ごとの予測割り当てとトラフィックの指標。

{
  "effectiveFrequencyBreakdowns": [
    {
      object (EffectiveFrequencyBreakdown)
    }
  ],
  "onTargetReach": string,
  "totalReach": string,
  "onTargetImpressions": string,
  "totalImpressions": string,
  "viewableImpressions": string,
  "onTargetCoviewReach": string,
  "totalCoviewReach": string,
  "onTargetCoviewImpressions": string,
  "totalCoviewImpressions": string,
  "views": string
}

object (EffectiveFrequencyBreakdown)

有効なフリークエンシー予測のリスト。リストは、1+ から始まり、GenerateReachForecastRequest.effective_frequency_limit に設定された値で終わります。enabledFrequencyLimit が設定されていない場合、このリストは空になります。

string (int64 format)

ターゲティングと完全に一致する GenerateReachForecastRequest.min_effective_frequency または GenerateReachForecastRequest.effective_frequency_limit 回以上リーチしたユニーク ユーザーの数。

なお、データがレポートされるには、ユニーク ユーザー数が一定数に達している必要があります。最小数に達していない場合、onTargetReach の値は 0 に丸められます。

string (int64 format)

GenerateReachForecastRequest.min_effective_frequency または GenerateReachForecastRequest.effective_frequency_limit 以上に達したユニーク ユーザーの合計数。指定したターゲティングに含まれないユーザーも対象となります。

なお、データがレポートされるには、ユニーク ユーザー数が一定数に達している必要があります。最小数に達していない場合、totalReach の値は 0 に丸められます。

string (int64 format)

ターゲティングに完全一致する広告インプレッションの数。

string (int64 format)

広告インプレッションの合計数。これには、ログインしているユーザーに関する情報が不足していることが原因で、指定したターゲティングの範囲外であるインプレッションも含まれます。

string (int64 format)

広告のインプレッションが視認可能とみなされた回数。広告の視認性の測定基準と視認性の測定方法について詳しくは、https://support.google.com/google-ads/answer/7029393 をご覧ください。

string (int64 format)

ターゲティングと完全に一致するリーチしたユニーク ユーザー（共視聴者を含む）の数。

string (int64 format)

リーチしたユニーク ユーザーの数（共視聴者を含む）。指定したターゲティングに含まれないユーザーも対象となります。

string (int64 format)

ターゲティングと完全に一致する広告インプレッションの数（共視聴者を含む）。

string (int64 format)

共視聴者を含む広告インプレッションの合計数。これには、ログインしているユーザーに関する情報が不足していることが原因で、指定したターゲティングの範囲外であるインプレッションも含まれます。

string (int64 format)

指定した商品とターゲティングで予測される広告視聴回数です。インプレッションは、視聴者が広告の大部分または全部を視聴した場合にカウントされます。

ビューについて詳しくは、https://support.google.com/google-ads/answer/2375431 をご覧ください。

{
  "effectiveFrequency": integer,
  "onTargetReach": string,
  "totalReach": string,
  "effectiveCoviewReach": string,
  "onTargetEffectiveCoviewReach": string
}

integer

有効頻度（1 ～ 10）。

string (int64 format)

ターゲティングに完全一致する eCPM の回数以上リーチしたユニーク ユーザーの数。

なお、データがレポートされるには、ユニーク ユーザー数が一定数に達している必要があります。最小数に達していない場合、onTargetReach の値は 0 に丸められます。

string (int64 format)

少なくとも EffectiveFrequency 回以上リーチしたユニーク ユーザーの合計数。指定したターゲティングに含まれないユーザーも対象となります。

なお、データがレポートされるには、ユニーク ユーザー数が一定数に達している必要があります。最小数に達していない場合、totalReach の値は 0 に丸められます。

string (int64 format)

関連付けられた validFrequency の値でリーチしたユーザー数（共視聴ユーザーを含む）。

string (int64 format)

指定したプランのユーザー属性内で、関連する EffectiveFrequency の値でリーチしたユーザー数（共視聴ユーザーを含む）。

{
  "plannableProductCode": string,
  "costMicros": string,
  "plannedProductForecast": {
    object (PlannedProductForecast)
  }
}

string

プランニング用に選択したプロダクト。同じ地域 ID を使用している場合、返される商品コードは ListPlannableProducts から返される商品コードのセット内にあります。

string (int64 format)

マイクロ単位の費用。在庫が限られているために予算を充足できない予定商品がある場合、これは商品の入力割り当てとは異なることがあります。

object (PlannedProductForecast)

この商品について予測されるトラフィック指標。

{
  "onTargetReach": string,
  "totalReach": string,
  "onTargetImpressions": string,
  "totalImpressions": string,
  "viewableImpressions": string,
  "onTargetCoviewReach": string,
  "totalCoviewReach": string,
  "onTargetCoviewImpressions": string,
  "totalCoviewImpressions": string,
  "averageFrequency": number,
  "views": string
}

string (int64 format)

ターゲティングと完全に一致するリーチしたユニーク ユーザーの数。

なお、データがレポートされるには、ユニーク ユーザー数が一定数に達している必要があります。最小数に達していない場合、onTargetReach の値は 0 に丸められます。

string (int64 format)

リーチしたユニーク ユーザーの数。指定したターゲティングに含まれないユーザーも対象となります。

なお、データがレポートされるには、ユニーク ユーザー数が一定数に達している必要があります。最小数に達していない場合、totalReach の値は 0 に丸められます。

string (int64 format)

ターゲティングに完全一致する広告インプレッションの数。

string (int64 format)

広告インプレッションの合計数。これには、ログインしているユーザーに関する情報が不足していることが原因で、指定したターゲティングの範囲外であるインプレッションも含まれます。

string (int64 format)

広告のインプレッションが視認可能とみなされた回数。広告の視認性の測定基準と視認性の測定方法について詳しくは、https://support.google.com/google-ads/answer/7029393 をご覧ください。

string (int64 format)

ターゲティングと完全に一致するリーチしたユニーク ユーザー（共視聴者を含む）の数。

string (int64 format)

リーチしたユニーク ユーザーの数（共視聴者を含む）。指定したターゲティングに含まれないユーザーも対象となります。

string (int64 format)

ターゲティングと完全に一致する広告インプレッションの数（共視聴者を含む）。

string (int64 format)

共視聴者を含む広告インプレッションの合計数。これには、ログインしているユーザーに関する情報が不足していることが原因で、指定したターゲティングの範囲外であるインプレッションも含まれます。

number

選択した時間単位ごとにユーザーに広告が表示される回数で、予測の長さの時間単位数で平均化されます。このフィールドの値は、フリークエンシー目標キャンペーンの場合のみ入力されます。

フリークエンシー目標キャンペーンについて詳しくは、https://support.google.com/google-ads/answer/12400225 をご覧ください。

string (int64 format)

指定した商品とターゲティングで予測される広告視聴回数です。インプレッションは、視聴者が広告の大部分または全部を視聴した場合にカウントされます。

ビューについて詳しくは、https://support.google.com/google-ads/answer/2375431 をご覧ください。