Chú ý: Bạn đang xem tài liệu về giao diện REST của API. Hầu hết các thư viện ứng dụng chính thức của chúng tôi đều sử dụng gRPC. Hãy xem Giới thiệu về REST để biết chi tiết.

Trang này được dịch bởi Cloud Translation API.

Experiment

Biểu diễn dưới dạng JSON
ExperimentType
ExperimentStatus
MetricGoal
- Biểu diễn dưới dạng JSON
ExperimentMetric
ExperimentMetricDirection
AsyncActionStatus

Thử nghiệm của Google Ads giúp 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 các thay đổi có hiệu quả.

Biểu diễn dưới dạng JSON

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, "syncEnabled": boolean }

{
  "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
}

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 của thử nghiệm. Mã này phải có độ dài tối thiểu là 1 và tối đa là 1024. Mã này phải là duy nhất trong từng 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 các 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, trong giai đoạn thiết lập trước khi chuyển sang bắt đầu. Hậu tố này sẽ được thêm vào tên chiến dịch thử nghiệm và trong thiết kế để tên này 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ó thể đọc.
`startDate`	`string` Ngày bắt đầu thử nghiệm. Theo mặc định, thử nghiệm sẽ 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ì 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 nhằm 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ề.
`syncEnabled`	`boolean` Không thể thay đổi. Đặt thành true nếu bạn đồng bộ hoá các thay đổi đối với chiến dịch cơ sở với chiến dịch thử nghiệm. Mọi thay đổi được thực hiện trực tiếp đối với chiến dịch thử nghiệm sẽ vẫn được giữ nguyên. Bạn chỉ có thể đặt trường này khi đang tạo thử nghiệm.

ExperimentType

Loại thử nghiệm.

Enum
`UNSPECIFIED`	Chưa chỉ định.
`UNKNOWN`	Giá trị không xác định trong phiên bản này.
`DISPLAY_AND_VIDEO_360`	Đây là thử nghiệm DISPLAY_AND_VIDEO_360.
`AD_VARIATION`	Đây là thử nghiệm biến thể quảng cáo.
`YOUTUBE_CUSTOM`	Thử nghiệm tuỳ chỉnh bao gồm các chiến dịch Video.
`DISPLAY_CUSTOM`	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`	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`	ĐÃ NGỪNG HOẠT ĐỘNG. Thử nghiệm so khớp thông minh với chiến dịch tìm kiếm.
`HOTEL_CUSTOM`	Một 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 chỉ định.
`UNKNOWN`	Giá trị không xác định trong phiên bản này.
`ENABLED`	Thử nghiệm này đã đượ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 chuyển từ 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 của 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 đã hoàn tất.

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`) }

Trường

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.

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 chỉ định.
`UNKNOWN`	Giá trị không xác định trong phiên bản này.
`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 tất.
`CUSTOM_ALGORITHMS`	Mục tiêu của thử nghiệm là các 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 chỉ định.
`UNKNOWN`	Giá trị không xác định trong phiên bản này.
`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 ra chỉ số.
`DECREASE`	Mục tiêu của thử nghiệm là giảm chỉ số này.
`NO_CHANGE_OR_INCREASE`	Mục tiêu của thử nghiệm là không thay đổi hoặc tăng chỉ số này.
`NO_CHANGE_OR_DECREASE`	Mục tiêu của thử nghiệm là không thay đổi hoặc giảm chỉ số này.

AsyncActionStatus

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

Enum
`UNSPECIFIED`	Chưa chỉ định.
`UNKNOWN`	Giá trị không xác định trong phiên bản này.
`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 nhưng kèm theo cảnh báo.