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
}
שדות
resourceName

string

לא משתנה. שם המשאב של הניסוי. שמות משאבי הניסוי הם בתבנית:

customers/{customerId}/experiments/{experimentId}
name

string

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

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

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 הפעולה הסתיימה בהצלחה עם אזהרות.