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,
  "syncEnabled": boolean
}
フィールド
resourceName

string

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

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

string

必須。テストの名前。最小の長さは 1、最大の長さは 1,024 にする必要があります。顧客に対して一意である必要があります。
description

string

テストの説明。長さは 1 ～ 2,048 文字以内にする必要があります。
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

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

boolean

変更不可。基本のキャンペーンに加えた変更をテスト キャンペーンと同期させる場合は true に設定します。テスト キャンペーンに直接加えた変更は保存されます。このフィールドは、テストの作成中にのみ設定できます。

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 アクションは正常に完了しましたが、警告があります。