Experiment

Tính năng thử nghiệm của Google Ads cho người dùng thử nghiệm các thay đổi trên nhiều chiến dịch, so sánh hiệu suất và áp dụng những thay đổi có hiệu quả.

Biểu diễn dưới dạng 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
}
Các trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của thử nghiệm. Tên tài nguyên thử nghiệm có dạng:

customers/{customerId}/experiments/{experimentId}

name

string

Bắt buộc. Tên thử nghiệm. Mã này phải có độ dài tối thiểu là 1 và độ dài tối đa là 1024. Mã này phải là duy nhất đối với một khách hàng.

description

string

Nội dung mô tả về thử nghiệm. Mã này phải có độ dài tối thiểu là 1 và độ dài tối đa là 2048.

suffix

string

Đối với thử nghiệm do hệ thống quản lý, nhà quảng cáo phải cung cấp hậu tố trong quá trình tạo thử nghiệm, trong giai đoạn thiết lập trước khi chuyển sang thử nghiệm đã bắt đầu. Hậu tố này sẽ được thêm vào tên chiến dịch trong thiết kế và chiến dịch thử nghiệm để tên là tên chiến dịch cơ sở + hậu tố.

type

enum (ExperimentType)

Bắt buộc. Sản phẩm/tính năng sử dụng thử nghiệm này.

status

enum (ExperimentStatus)

Trạng thái do Nhà quảng cáo chọn của thử nghiệm này.

goals[]

object (MetricGoal)

Mục tiêu của thử nghiệm này.

promoteStatus

enum (AsyncActionStatus)

Chỉ có đầu ra. Trạng thái của quá trình quảng bá thử nghiệm.

experimentId

string (int64 format)

Chỉ có đầu ra. ID của thí nghiệm. Chỉ đọc.

startDate

string

Ngày bắt đầu thử nghiệm. Theo mặc định, thử nghiệm bắt đầu ngay bây giờ hoặc vào ngày bắt đầu của chiến dịch, tuỳ vào ngày nào đến sau. Nếu bạn đặt trường này, thì thử nghiệm sẽ bắt đầu vào ngày bắt đầu của ngày được chỉ định theo múi giờ của khách hàng.

Định dạng: YYYY-MM-DD Ví dụ: 2019-03-14

endDate

string

Ngày kết thúc thử nghiệm. Theo mặc định, thử nghiệm sẽ kết thúc vào ngày kết thúc của chiến dịch. Nếu bạn đặt trường này, thử nghiệm sẽ kết thúc vào cuối ngày được chỉ định theo múi giờ của khách hàng.

Định dạng: YYYY-MM-DD Ví dụ: 2019-04-18

longRunningOperation

string

Chỉ có đầu ra. Tên tài nguyên của hoạt động diễn ra trong thời gian dài có thể dùng để thăm dò ý kiến về việc hoàn thành lịch thử nghiệm hoặc quảng bá. Thao tác chạy trong thời gian dài gần đây nhất sẽ được trả về.

ExperimentType

Loại thử nghiệm.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Phiên bản này không xác định được giá trị.
DISPLAY_AND_VIDEO_360 Đây là một thử nghiệm DISPLAY_AND_VIDEO_360.
AD_VARIATION Đây là một thử nghiệm biến thể quảng cáo.
YOUTUBE_CUSTOM Một thử nghiệm tuỳ chỉnh bao gồm các chiến dịch Video.
DISPLAY_CUSTOM Một thử nghiệm tuỳ chỉnh bao gồm các chiến dịch hiển thị.
SEARCH_CUSTOM Thử nghiệm tuỳ chỉnh bao gồm các chiến dịch tìm kiếm.
DISPLAY_AUTOMATED_BIDDING_STRATEGY Một thử nghiệm so sánh các chiến lược đặt giá thầu cho chiến dịch hiển thị.
SEARCH_AUTOMATED_BIDDING_STRATEGY Một thử nghiệm so sánh các chiến lược đặt giá thầu cho chiến dịch tìm kiếm."
SHOPPING_AUTOMATED_BIDDING_STRATEGY Một thử nghiệm so sánh các chiến lược đặt giá thầu cho chiến dịch mua sắm.
SMART_MATCHING KHÔNG DÙNG NỮA. Thử nghiệm so khớp thông minh với chiến dịch tìm kiếm.
HOTEL_CUSTOM Thử nghiệm tuỳ chỉnh gồm các chiến dịch khách sạn.

ExperimentStatus

Trạng thái của thử nghiệm.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Phiên bản này không xác định được giá trị.
ENABLED Thử nghiệm đã được bật.
REMOVED Thử nghiệm này đã bị xoá.
HALTED Thử nghiệm đã bị tạm dừng. Bạn có thể đặt trạng thái này từ trạng thái ĐÃ BẬT thông qua API.
PROMOTED Thử nghiệm sẽ được quảng bá ngoài trạng thái thử nghiệm.
SETUP Trạng thái ban đầu của thử nghiệm.
INITIATED Các chiến dịch thử nghiệm đang chờ cụ thể hoá. Bạn có thể đặt trạng thái này từ trạng thái THIẾT LẬP thông qua API.
GRADUATED Thử nghiệm này đã kết thúc.

MetricGoal

Mục tiêu chỉ số cho một thử nghiệm.

Biểu diễn dưới dạng JSON
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
Các trường
metric

enum (ExperimentMetric)

Chỉ số của mục tiêu. Ví dụ: số lượt nhấp, số lượt hiển thị, chi phí, số lượt chuyển đổi, v.v.

direction

enum (ExperimentMetricDirection)

Hướng chỉ số của mục tiêu. Ví dụ: tăng, giảm, không thay đổi.

ExperimentMetric

Loại chỉ số thử nghiệm.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Phiên bản này không xác định được giá trị.
CLICKS Mục tiêu của thử nghiệm là lượt nhấp.
IMPRESSIONS Mục tiêu của thử nghiệm là số lượt hiển thị.
COST Mục tiêu của thử nghiệm là chi phí.
CONVERSIONS_PER_INTERACTION_RATE Mục tiêu của thử nghiệm là tỷ lệ chuyển đổi.
COST_PER_CONVERSION Mục tiêu của thử nghiệm là chi phí mỗi lượt chuyển đổi.
CONVERSIONS_VALUE_PER_COST Mục tiêu của thử nghiệm là giá trị lượt chuyển đổi trên chi phí.
AVERAGE_CPC Mục tiêu của thử nghiệm là cpc trung bình.
CTR Mục tiêu của thử nghiệm là ctr.
INCREMENTAL_CONVERSIONS Mục tiêu của thử nghiệm là gia tăng lượt chuyển đổi.
COMPLETED_VIDEO_VIEWS Mục tiêu của thử nghiệm là lượt xem video hoàn chỉnh.
CUSTOM_ALGORITHMS Mục tiêu của thử nghiệm là thuật toán tuỳ chỉnh.
CONVERSIONS Mục tiêu của thử nghiệm là lượt chuyển đổi.
CONVERSION_VALUE Mục tiêu của thử nghiệm là giá trị lượt chuyển đổi.

ExperimentMetricDirection

Loại hướng chỉ số thử nghiệm.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Phiên bản này không xác định được giá trị.
NO_CHANGE Mục tiêu của thử nghiệm là không thay đổi chỉ số.
INCREASE Mục tiêu của thử nghiệm là tạo chỉ số.
DECREASE Mục tiêu của thử nghiệm là giảm chỉ số.
NO_CHANGE_OR_INCREASE Mục tiêu của thử nghiệm là không thay đổi hoặc tăng chỉ số.
NO_CHANGE_OR_DECREASE Mục tiêu của thử nghiệm là không thay đổi hoặc giảm chỉ số.

AsyncActionStatus

Trạng thái hành động không đồng bộ trong thử nghiệm.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Phiên bản này không xác định được giá trị.
NOT_STARTED Hành động chưa bắt đầu.
IN_PROGRESS Đang thực hiện hành động.
COMPLETED Tác vụ đã hoàn tất thành công.
FAILED Thao tác không thành công.
COMPLETED_WITH_WARNING Hành động đã hoàn tất thành công kèm theo cảnh báo.