Experiment

การทดสอบ Google Ads เพื่อให้ผู้ใช้ทดสอบการเปลี่ยนแปลงในหลายแคมเปญ เปรียบเทียบประสิทธิภาพ และนำการเปลี่ยนแปลงที่มีประสิทธิภาพไปใช้

การแสดง 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 และความยาวสูงสุด 2048

suffix

string

สำหรับการทดสอบที่จัดการโดยระบบ ผู้ลงโฆษณาต้องใส่ส่วนต่อท้ายระหว่างการสร้างในขั้นตอนการตั้งค่าก่อนที่จะย้ายไปยังการทดสอบเริ่มต้น คำต่อท้ายจะนำไปต่อท้ายชื่อแคมเปญที่ออกแบบไว้และการทดสอบ เพื่อให้ชื่อเป็นชื่อแคมเปญพื้นฐาน + คำต่อท้าย

type

enum (ExperimentType)

ต้องระบุ ผลิตภัณฑ์/ฟีเจอร์ที่ใช้การทดสอบนี้

status

enum (ExperimentStatus)

สถานะที่ผู้ลงโฆษณาเลือกของการทดสอบนี้

goals[]

object (MetricGoal)

เป้าหมายของการทดสอบนี้

promoteStatus

enum (AsyncActionStatus)

เอาต์พุตเท่านั้น สถานะของกระบวนการโปรโมตการทดสอบ

experimentId

string (int64 format)

เอาต์พุตเท่านั้น รหัสการทดสอบ อ่านอย่างเดียว

startDate

string

วันที่การทดสอบเริ่มต้น โดยค่าเริ่มต้น การทดสอบจะเริ่มต้นทันทีหรือในวันที่เริ่มต้นของแคมเปญ ขึ้นอยู่กับว่ากรณีใดจะเกิดขึ้นภายหลัง หากตั้งค่าช่องนี้ไว้ การทดสอบจะเริ่มที่จุดเริ่มต้นของวันที่ที่ระบุไว้ในเขตเวลาของลูกค้า

รูปแบบ: YYYY-MM-DD เช่น 2019-03-14

endDate

string

วันที่การทดสอบสิ้นสุด โดยค่าเริ่มต้น การทดสอบจะสิ้นสุดในวันที่สิ้นสุดของแคมเปญ หากตั้งค่าช่องนี้ไว้ การทดสอบจะสิ้นสุดเมื่อสิ้นสุดวันที่ที่ระบุไว้ในเขตเวลาของลูกค้า

รูปแบบ: YYYY-MM-DD เช่น 2019-04-18

longRunningOperation

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของการดำเนินการที่ใช้เวลานานที่ใช้สำรวจแบบสำรวจเพื่อให้การทดสอบเสร็จสิ้นหรือการโปรโมตได้ ระบบส่งคืนการดำเนินการที่ใช้เวลานานล่าสุดกลับมา

syncEnabled

boolean

เปลี่ยนแปลงไม่ได้ ตั้งค่าเป็น "จริง" หากควรซิงค์การเปลี่ยนแปลงแคมเปญฐานกับแคมเปญทดลอง การเปลี่ยนแปลงใดๆ ที่ทำกับแคมเปญทดลองโดยตรงจะยังคงอยู่ คุณจะตั้งค่าช่องนี้ได้ก็ต่อเมื่อกำลังสร้างการทดสอบเท่านั้น

ExperimentType

ประเภทของการทดสอบ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ไม่รู้จักค่าในเวอร์ชันนี้
DISPLAY_AND_VIDEO_360 นี่คือการทดสอบ DISPLAY_AND_VIDEO_360
AD_VARIATION นี่คือการทดสอบโฆษณารูปแบบต่างๆ
YOUTUBE_CUSTOM การทดสอบที่กําหนดเองซึ่งประกอบด้วยแคมเปญวิดีโอ
DISPLAY_CUSTOM การทดสอบที่กำหนดเองซึ่งประกอบด้วยแคมเปญ Display
SEARCH_CUSTOM การทดสอบที่กำหนดเองซึ่งประกอบด้วยแคมเปญ Search
DISPLAY_AUTOMATED_BIDDING_STRATEGY การทดสอบที่เปรียบเทียบกลยุทธ์การเสนอราคาสำหรับแคมเปญในเครือข่ายดิสเพลย์
SEARCH_AUTOMATED_BIDDING_STRATEGY การทดสอบที่เปรียบเทียบกลยุทธ์การเสนอราคาสําหรับแคมเปญ Search"
SHOPPING_AUTOMATED_BIDDING_STRATEGY การทดสอบที่เปรียบเทียบกลยุทธ์การเสนอราคาสําหรับแคมเปญ Shopping
SMART_MATCHING เลิกใช้งานแล้ว การทดสอบการจับคู่อัจฉริยะกับแคมเปญ Search
HOTEL_CUSTOM การทดสอบที่กําหนดเองซึ่งประกอบด้วยแคมเปญโรงแรม

ExperimentStatus

สถานะของการทดสอบ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ไม่รู้จักค่าในเวอร์ชันนี้
ENABLED เปิดใช้การทดสอบแล้ว
REMOVED นำการทดสอบออกแล้ว
HALTED การทดสอบถูกระงับแล้ว คุณตั้งค่าสถานะนี้จากสถานะ "เปิดใช้" ได้ผ่าน API
PROMOTED ระบบจะโปรโมตการทดสอบว่าไม่อยู่ในสถานะการทดสอบ
SETUP สถานะเริ่มต้นของการทดสอบ
INITIATED แคมเปญของการทดสอบอยู่ระหว่างรอดำเนินการ คุณตั้งค่าสถานะนี้ได้จากสถานะ "การตั้งค่า" ผ่านทาง API
GRADUATED การทดสอบสิ้นสุดแล้ว

MetricGoal

เป้าหมายเมตริกสำหรับการทดสอบ

การแสดง JSON
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
ช่อง
metric

enum (ExperimentMetric)

เมตริกของเป้าหมาย เช่น การคลิก, การแสดงผล, ค่าใช้จ่าย, Conversion เป็นต้น

direction

enum (ExperimentMetricDirection)

ทิศทางเมตริกของเป้าหมาย เช่น เพิ่มขึ้น ลดลง ไม่เปลี่ยนแปลง

ExperimentMetric

ประเภทของเมตริกการทดสอบ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ไม่รู้จักค่าในเวอร์ชันนี้
CLICKS เป้าหมายของการทดสอบคือการคลิก
IMPRESSIONS เป้าหมายของการทดสอบคือการแสดงผล
COST เป้าหมายของการทดสอบคือต้นทุน
CONVERSIONS_PER_INTERACTION_RATE เป้าหมายของการทดลองคืออัตรา Conversion
COST_PER_CONVERSION เป้าหมายของการทดสอบคือต้นทุนต่อ Conversion
CONVERSIONS_VALUE_PER_COST เป้าหมายของการทดสอบคือมูลค่า Conversion ต่อต้นทุน
AVERAGE_CPC เป้าหมายของการทดสอบคือ CPC เฉลี่ย
CTR เป้าหมายของการทดลองคือ CTR
INCREMENTAL_CONVERSIONS เป้าหมายของการทดสอบคือ Conversion ที่เพิ่มขึ้น
COMPLETED_VIDEO_VIEWS เป้าหมายของการทดลองคือ การดูวิดีโอที่เสร็จสมบูรณ์
CUSTOM_ALGORITHMS เป้าหมายของการทดสอบคืออัลกอริทึมที่กําหนดเอง
CONVERSIONS เป้าหมายของการทดสอบคือ Conversion
CONVERSION_VALUE เป้าหมายของการทดสอบคือมูลค่า Conversion

ExperimentMetricDirection

ประเภทของทิศทางเมตริกการทดสอบ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ไม่รู้จักค่าในเวอร์ชันนี้
NO_CHANGE เป้าหมายของการทดสอบคือไม่เปลี่ยนแปลงเมตริก
INCREASE เป้าหมายของการทดสอบคือการสร้างเมตริก
DECREASE เป้าหมายของการทดสอบคือการลดเมตริก
NO_CHANGE_OR_INCREASE เป้าหมายของการทดสอบคือไม่เปลี่ยนแปลงหรือเพิ่มเมตริก
NO_CHANGE_OR_DECREASE เป้าหมายของการทดสอบคือไม่เปลี่ยนแปลงหรือลดเมตริก

AsyncActionStatus

สถานะการทำงานแบบไม่พร้อมกันของการทดสอบ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ไม่รู้จักค่าในเวอร์ชันนี้
NOT_STARTED ยังไม่ได้เริ่มการทำงาน
IN_PROGRESS กำลังดำเนินการ
COMPLETED การดำเนินการเสร็จสมบูรณ์แล้ว
FAILED การทำงานล้มเหลว
COMPLETED_WITH_WARNING การทำงานเสร็จเรียบร้อยแล้วและมีคำเตือน