Experiment

Google 広告のテスト機能。ユーザーは、複数のキャンペーンに変更をテストし、パフォーマンスを比較して、効果的な変更を適用する。

JSON 表現 
{
  "resourceName": string,
  "name": string,
  "description": string,
  "suffix": string,
  "type": enum (ExperimentType),
  "status": enum (ExperimentStatus),
  "goals": [
    {
      object (MetricGoal)
    }
  ],
  "promoteStatus": enum (AsyncActionStatus),
  "experimentId": string,
  "startDate": string,
  "endDate": string,
  "longRunningOperation": string
}
フィールド
resourceName

string

変更不可。テストのリソース名。テストリソース名の形式は次のとおりです。

customers/{customerId}/experiments/{experimentId}
name

string

必須。テストの名前。長さは 1 ～ 1,024 文字にする必要があります。顧客の下で一意である必要があります。
description

string

テストの説明。長さは 1 ～ 2048 文字にする必要があります。
suffix

string

システム管理のテストの場合、広告主様は、開始モードに移行する前に、設定段階でサフィックスを指定する必要がある。基本キャンペーン名 + 接尾辞となるように、設計中のキャンペーンとテスト キャンペーン名に接尾辞が追加されます。
type

enum (ExperimentType)

必須。このテストを使用するプロダクト/機能。
status

enum (ExperimentStatus)

広告主様が選択した、このテストのステータス。
goals[]

object (MetricGoal)

このテストの目標。
promoteStatus

enum (AsyncActionStatus)

出力のみ。テスト プロモーション プロセスのステータス。
experimentId

string (int64 format)

出力のみ。テストの ID。読み取り専用。
startDate

string

テストの開始日。デフォルトでは、テストは現在またはキャンペーンの開始日のうち、いずれか遅いほうに開始されます。このフィールドが設定されている場合、ユーザーのタイムゾーンで、指定した日付の初めにテストが開始されます。

形式: YYYY-MM-DD 例: 2019-03-14
endDate

string

テストの終了日。デフォルトでは、テストはキャンペーンの終了日に終了します。このフィールドが設定されている場合、お客様のタイムゾーンに基づき、指定した終了日にテストが終了します。

形式: YYYY-MM-DD 例: 2019-04-18
longRunningOperation

string

出力のみ。テストのスケジュールまたはプロモートの完了をポーリングするために使用できる長時間実行オペレーションのリソース名。最新の長時間実行オペレーションが返されます。

ExperimentType

テストのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
DISPLAY_AND_VIDEO_360 これは DISPLAY_AND_VIDEO_360 のテストです。
AD_VARIATION これは広告バリエーションのテストです。
YOUTUBE_CUSTOM 動画キャンペーンで構成されるカスタムテスト。
DISPLAY_CUSTOM ディスプレイ キャンペーンで構成されるカスタムテスト。
SEARCH_CUSTOM 検索キャンペーンで構成されるカスタムテスト。
DISPLAY_AUTOMATED_BIDDING_STRATEGY ディスプレイ キャンペーンの入札戦略を比較するテスト。
SEARCH_AUTOMATED_BIDDING_STRATEGY 検索キャンペーンの入札戦略を比較するテスト」
SHOPPING_AUTOMATED_BIDDING_STRATEGY ショッピング キャンペーンの入札戦略を比較するテスト。
SMART_MATCHING 非推奨。検索キャンペーンで実施されるスマートマッチのテスト。
HOTEL_CUSTOM ホテル キャンペーンで構成されるカスタムテストです。

ExperimentStatus

テストのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
ENABLED テストは有効です。
REMOVED テストは削除されました。
HALTED テストを停止しました。このステータスは、API を使用して ENABLED ステータスから設定できます。
PROMOTED テストはテスト ステータスから昇格します。
SETUP テストの初期ステータス。
INITIATED テストのキャンペーンは実体化待ちです。このステータスは、API の設定ステータスから設定できます。
GRADUATED テストを終了しました。

MetricGoal

テストの指標目標。

JSON 表現 
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
フィールド
metric

enum (ExperimentMetric)

目標の指標。（クリック数、インプレッション数、費用、コンバージョン数など）。
direction

enum (ExperimentMetricDirection)

目標の指標の方向。（例: 増加、減少、変化なし）。

ExperimentMetric

テストの指標のタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
CLICKS テストの目標はクリック数です。
IMPRESSIONS テストの目標は表示回数です。
COST テストの目的は費用です。
CONVERSIONS_PER_INTERACTION_RATE テストの目標はコンバージョン率です。
COST_PER_CONVERSION テストの目標はコンバージョン単価です。
CONVERSIONS_VALUE_PER_COST テストの目標は費用あたりのコンバージョンの価値です。
AVERAGE_CPC テストの目標は平均クリック単価です。
CTR テストの目標はクリック率です。
INCREMENTAL_CONVERSIONS テストの目標はコンバージョン数の増加である。
COMPLETED_VIDEO_VIEWS テストの目標は動画の完全再生です。
CUSTOM_ALGORITHMS テストの目的はカスタム アルゴリズムです。
CONVERSIONS テストの目標はコンバージョンである。
CONVERSION_VALUE テストの目標はコンバージョン値です。

ExperimentMetricDirection

テストの指標の方向のタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
NO_CHANGE テストの目的は、指標を変更しないことです。
INCREASE テストの目的は、指標を作成することです。
DECREASE テストの目的は指標を減らすことです。
NO_CHANGE_OR_INCREASE テストの目的は、指標を変更しないことまたは増加させることです。
NO_CHANGE_OR_DECREASE テストの目的は、指標を変えない、または減少させることです。

AsyncActionStatus

テストの非同期アクションのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
NOT_STARTED アクションは開始されていません。
IN_PROGRESS アクションを実行しています。
COMPLETED アクションが正常に完了しました。
FAILED 操作に失敗しました。
COMPLETED_WITH_WARNING アクションは正常に完了しましたが、警告が発生しています。