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

string

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

customers/{customerId}/experiments/{experimentId}

name

string

Wajib. Nama eksperimen. Panjangnya harus minimal 1 dan panjang maksimal 1024. Nama ini harus unik di bawah pelanggan.

description

string

Deskripsi eksperimen. Panjangnya harus minimal 1 dan panjang maksimal 2048.

suffix

string

Untuk eksperimen yang dikelola sistem, pengiklan harus memberikan akhiran selama pembuatan, di tahap penyiapan sebelum beralih ke dimulai. Akhiran akan ditambahkan ke nama kampanye dalam desain dan eksperimen sehingga namanya 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 lama. Jika kolom ini ditetapkan, eksperimen akan dimulai di 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 memeriksa penyelesaian jadwal eksperimen atau promosi. Operasi yang berjalan lama yang terbaru ditampilkan.

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 ditetapkan dari status DIAKTIFKAN melalui API.
PROMOTED Eksperimen akan dipromosikan dari status eksperimental.
SETUP Status awal eksperimen.
INITIATED Kampanye eksperimen menunggu terwujud. Status ini dapat disetel dari status PENYIAPAN melalui API.
GRADUATED Eksperimen telah selesai.

MetricGoal

Sasaran metrik untuk eksperimen.

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

enum (ExperimentMetric)

Metrik sasaran. Misalnya, klik, tayangan, biaya, konversi, dsb.

direction

enum (ExperimentMetricDirection)

Arah metrik dari tujuan. Misalnya, menambah, mengurangi, tanpa 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 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 adalah ctr.
INCREMENTAL_CONVERSIONS Sasaran eksperimen ini adalah konversi tambahan.
COMPLETED_VIDEO_VIEWS Sasaran eksperimen ini adalah penyelesaian tontonan video.
CUSTOM_ALGORITHMS Sasaran eksperimen ini adalah algoritma kustom.
CONVERSIONS Sasaran eksperimen adalah konversi.
CONVERSION_VALUE Sasaran eksperimen 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 Sasaran eksperimen ini adalah untuk tidak mengubah atau meningkatkan metrik.
NO_CHANGE_OR_DECREASE Sasaran 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.