Experiment

Eksperimen Google Ads bagi pengguna untuk bereksperimen perubahan pada beberapa kampanye, membandingkan performa, dan menerapkan perubahan yang efektif.

Representasi 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
}
Kolom
resourceName

string

Tidak dapat diubah. Nama resource eksperimen. Nama resource eksperimen memiliki bentuk:

customers/{customerId}/experiments/{experimentId}

name

string

Wajib. Nama eksperimen. Nama harus memiliki panjang minimum 1 dan panjang maksimum 1024. ID pelanggan harus unik di bagian pelanggan.

description

string

Deskripsi eksperimen. Nama harus memiliki panjang minimum 1 dan panjang maksimum 2048.

suffix

string

Untuk eksperimen yang dikelola sistem, pengiklan harus memberikan akhiran selama pembuatan, pada tahap penyiapan sebelum beralih ke eksperimen yang dimulai. Akhiran akan ditambahkan ke nama kampanye dalam desain dan kampanye eksperimen sehingga nama tersebut adalah nama kampanye dasar + akhiran.

type

enum (ExperimentType)

Wajib. Produk/fitur yang menggunakan eksperimen ini.

status

enum (ExperimentStatus)

Status yang dipilih Pengiklan untuk eksperimen ini.

goals[]

object (MetricGoal)

Sasaran eksperimen ini.

promoteStatus

enum (AsyncActionStatus)

Hanya output. Status proses promosi eksperimen.

experimentId

string (int64 format)

Hanya output. ID eksperimen. Hanya baca.

startDate

string

Tanggal saat eksperimen dimulai. Secara default, eksperimen dimulai sekarang atau pada tanggal mulai kampanye, mana saja yang lebih akhir. Jika kolom ini ditetapkan, eksperimen akan dimulai pada awal tanggal yang ditentukan dalam zona waktu pelanggan.

Format: YYYY-MM-DD Contoh: 2019-03-14

endDate

string

Tanggal saat eksperimen berakhir. Secara default, eksperimen berakhir pada tanggal akhir kampanye. Jika kolom ini ditetapkan, eksperimen akan berakhir pada akhir tanggal yang ditentukan dalam zona waktu pelanggan.

Format: YYYY-MM-DD Contoh: 2019-04-18

longRunningOperation

string

Hanya output. Nama resource dari operasi yang berjalan lama yang dapat digunakan untuk melakukan polling guna menyelesaikan jadwal eksperimen atau mempromosikannya. Operasi yang berjalan lama terbaru ditampilkan.

syncEnabled

boolean

Tidak dapat diubah. Tetapkan ke true (benar) jika perubahan pada kampanye dasar harus disinkronkan ke kampanye uji coba. Perubahan apa pun yang dilakukan langsung pada kampanye uji coba akan dipertahankan. Kolom ini hanya dapat ditetapkan saat eksperimen sedang dibuat.

ExperimentType

Jenis eksperimen.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai dalam versi ini tidak diketahui.
DISPLAY_AND_VIDEO_360 Ini adalah eksperimen DISPLAY_AND_VIDEO_360.
AD_VARIATION Ini adalah eksperimen variasi iklan.
YOUTUBE_CUSTOM Eksperimen kustom yang terdiri dari kampanye Video.
DISPLAY_CUSTOM Eksperimen kustom yang terdiri dari kampanye Display.
SEARCH_CUSTOM Eksperimen kustom yang terdiri dari kampanye penelusuran.
DISPLAY_AUTOMATED_BIDDING_STRATEGY Eksperimen yang membandingkan strategi bidding untuk kampanye Display.
SEARCH_AUTOMATED_BIDDING_STRATEGY Eksperimen yang membandingkan strategi bidding untuk kampanye penelusuran".
SHOPPING_AUTOMATED_BIDDING_STRATEGY Eksperimen yang membandingkan strategi bidding untuk kampanye Shopping.
SMART_MATCHING TIDAK DIGUNAKAN LAGI. Eksperimen pencocokan pintar dengan kampanye penelusuran.
HOTEL_CUSTOM Eksperimen kustom yang terdiri dari kampanye Hotel.

ExperimentStatus

Status eksperimen.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai dalam versi ini tidak diketahui.
ENABLED Eksperimen diaktifkan.
REMOVED Eksperimen telah dihapus.
HALTED Eksperimen telah dihentikan. Status ini dapat disetel dari status DIAKTIFKAN melalui API.
PROMOTED Eksperimen akan dipromosikan dari status eksperimen.
SETUP Status awal eksperimen.
INITIATED Kampanye eksperimen sedang menunggu terwujud. Status ini dapat disetel dari status PENYIAPAN melalui API.
GRADUATED Eksperimen telah lulus.

MetricGoal

Sasaran metrik untuk eksperimen.

Representasi JSON
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
Kolom
metric

enum (ExperimentMetric)

Metrik tujuan. Misalnya, klik, tayangan, biaya, konversi, dll.

direction

enum (ExperimentMetricDirection)

Arah metrik tujuan. Misalnya, naikkan, turunkan, tidak ada perubahan.

ExperimentMetric

Jenis metrik eksperimen.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai dalam versi ini tidak diketahui.
CLICKS Sasaran eksperimen ini adalah klik.
IMPRESSIONS Sasaran eksperimen ini adalah tayangan.
COST Sasaran eksperimen ini adalah biaya.
CONVERSIONS_PER_INTERACTION_RATE Sasaran eksperimen ini adalah rasio konversi.
COST_PER_CONVERSION Sasaran eksperimen ini adalah biaya per konversi.
CONVERSIONS_VALUE_PER_COST Sasaran eksperimen ini adalah nilai konversi per biaya.
AVERAGE_CPC Sasaran eksperimen adalah CPC rata2.
CTR Sasaran eksperimen ini adalah ctr.
INCREMENTAL_CONVERSIONS Sasaran eksperimen ini adalah konversi tambahan.
COMPLETED_VIDEO_VIEWS Sasaran eksperimen ini adalah penyelesaian jumlah tontonan video.
CUSTOM_ALGORITHMS Sasaran eksperimen ini adalah algoritma kustom.
CONVERSIONS Sasaran eksperimen ini adalah konversi.
CONVERSION_VALUE Sasaran eksperimen ini adalah nilai konversi.

ExperimentMetricDirection

Jenis arah metrik eksperimen.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai dalam versi ini tidak diketahui.
NO_CHANGE Tujuan eksperimen ini adalah untuk tidak mengubah metrik.
INCREASE Tujuan eksperimen ini adalah untuk membuat metrik.
DECREASE Tujuan eksperimen ini adalah untuk mengurangi metrik.
NO_CHANGE_OR_INCREASE Tujuan eksperimen ini adalah untuk tidak mengubah atau meningkatkan metrik.
NO_CHANGE_OR_DECREASE Tujuan eksperimen ini adalah untuk tidak mengubah atau mengurangi metrik.

AsyncActionStatus

Status tindakan asinkron eksperimen.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai dalam versi ini tidak diketahui.
NOT_STARTED Tindakan belum dimulai.
IN_PROGRESS Tindakan sedang berlangsung.
COMPLETED Tindakan berhasil diselesaikan.
FAILED Tindakan gagal.
COMPLETED_WITH_WARNING Tindakan berhasil diselesaikan dengan peringatan.