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 והאורך המקסימלי שלו הוא 1024. המזהה צריך להיות ייחודי לכל לקוח.
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

בלתי משתנה. צריך להגדיר את הערך True אם צריך לסנכרן את השינויים בקמפיינים של הבסיס עם הקמפיינים לניסיון. כל השינויים שבוצעו ישירות בקמפיינים לניסיון יישמרו. ניתן להגדיר את השדה הזה רק בזמן יצירת הניסוי.

ExperimentType

סוג הניסוי.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
DISPLAY_AND_VIDEO_360 זהו ניסוי של DISPLAY_AND_VIDEO_360.
AD_VARIATION זהו ניסוי של וריאציות של מודעה.
YOUTUBE_CUSTOM ניסוי בהתאמה אישית שכולל קמפיינים של מודעות וידאו.
DISPLAY_CUSTOM ניסוי בהתאמה אישית שכולל קמפיינים לרשת המדיה.
SEARCH_CUSTOM ניסוי בהתאמה אישית שכולל קמפיינים לרשת החיפוש.
DISPLAY_AUTOMATED_BIDDING_STRATEGY ניסוי שמשווה בין שיטות בידינג בקמפיינים לרשת המדיה.
SEARCH_AUTOMATED_BIDDING_STRATEGY ניסוי שמשווה בין שיטות בידינג בקמפיינים לרשת החיפוש."
SHOPPING_AUTOMATED_BIDDING_STRATEGY ניסוי שמשווה בין שיטות בידינג בקמפיינים של שופינג.
SMART_MATCHING הוצא משימוש. ניסוי של התאמה חכמה בקמפיינים לרשת החיפוש.
HOTEL_CUSTOM ניסוי בהתאמה אישית שכולל קמפיינים לקידום מלונות.

ExperimentStatus

סטטוס הניסוי.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
ENABLED הניסוי מופעל.
REMOVED הניסוי הוסר.
HALTED הניסוי הופסק. אפשר להגדיר את הסטטוס הזה מהסטטוס 'מופעל' דרך API.
PROMOTED הניסוי יקודם מחוץ לסטטוס הניסיוני.
SETUP הסטטוס הראשוני של הניסוי.
INITIATED הקמפיינים של הניסוי ממתינים ליצירה. אפשר לשנות את הסטטוס הזה מהסטטוס 'הגדרה' דרך API.
GRADUATED הניסוי שודרג.

MetricGoal

יעד מדד עבור ניסוי.

ייצוג JSON 
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
שדות
metric

enum (ExperimentMetric)

המדד של היעד. לדוגמה, קליקים, חשיפות, עלות, המרות וכו'.
direction

enum (ExperimentMetricDirection)

הכיוון המדד של היעד. לדוגמה: להגדיל, להקטין או לא לשנות.

ExperimentMetric

הסוג של מדד הניסוי.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
CLICKS מטרת הניסוי היא קליקים.
IMPRESSIONS מטרת הניסוי היא חשיפות.
COST מטרת הניסוי היא עלות.
CONVERSIONS_PER_INTERACTION_RATE מטרת הניסוי היא שיעור המרות.
COST_PER_CONVERSION מטרת הניסוי היא עלות להמרה.
CONVERSIONS_VALUE_PER_COST מטרת הניסוי היא ערך ההמרות לעלות.
AVERAGE_CPC מטרת הניסוי היא מחיר ממוצע לקליק.
CTR מטרת הניסוי היא שיעור קליקים.
INCREMENTAL_CONVERSIONS מטרת הניסוי היא המרות מצטברות.
COMPLETED_VIDEO_VIEWS מטרת הניסוי היא השלמת צפיות בסרטונים.
CUSTOM_ALGORITHMS מטרת הניסוי היא אלגוריתמים מותאמים אישית.
CONVERSIONS מטרת הניסוי היא המרות.
CONVERSION_VALUE מטרת הניסוי היא ערך המרה.

ExperimentMetricDirection

סוג הכיוון של מדד הניסוי.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
NO_CHANGE מטרת הניסוי היא לא לשנות את המדד.
INCREASE מטרת הניסוי היא ליצור את המדד.
DECREASE מטרת הניסוי היא להקטין את המדד.
NO_CHANGE_OR_INCREASE מטרת הניסוי היא לא לשנות או להגדיל את המדד.
NO_CHANGE_OR_DECREASE מטרת הניסוי היא לא לשנות או להפחית את המדד.

AsyncActionStatus

סטטוס הפעולה האסינכרונית של הניסוי.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
NOT_STARTED הפעולה לא התחילה.
IN_PROGRESS הפעולה מתבצעת.
COMPLETED הפעולה הושלמה בהצלחה.
FAILED הפעולה נכשלה.
COMPLETED_WITH_WARNING הפעולה הושלמה בהצלחה עם אזהרות.