REST Resource: accounts.mediationGroups.mediationAbExperiments

משאב: MediationAbExperiment

ניסוי בדיקת A/B של תהליך בחירת הרשת.

ייצוג ב-JSON
{
  "name": string,
  "displayName": string,
  "experimentId": string,
  "treatmentTrafficPercentage": string,
  "treatmentMediationLines": [
    {
      object (ExperimentMediationLine)
    }
  ],
  "controlMediationLines": [
    {
      object (ExperimentMediationLine)
    }
  ],
  "state": enum (ExperimentState),
  "startTime": string,
  "endTime": string,
  "mediationGroupId": string,
  "variantLeader": enum (VariantLeader)
}
שדות
name

string

שם המשאב של הניסוי הזה. הפורמט הוא accounts/{publisherId}/ mediationGroups/{mediationGroupId}/mediationAbExperiment/ {mediation_group_experiment_id}. לדוגמה: accounts/pub-9876543210987654/mediationGroups/0123456789/ mediationAbExperiment/12345

displayName

string

השם המוצג של ניסוי ה-A/B של תהליך בחירת הרשת.

experimentId

string

פלט בלבד. מזהה ייחודי של ניסוי A/B בתהליך בחירת הרשת. זהו נכס פלט בלבד.

treatmentTrafficPercentage

string (int64 format)

אחוז התנועה בניסוי A/B בתהליך בחירת הרשת שיופנה לקבוצת הניסוי (וריאנט ב'). שאר המשתמשים יישלחו לקבוצת הבקרה (וריאנט A). האחוז מוצג כמספר שלם בטווח [1,99] כולל. פרטים נוספים זמינים בכתובת https://support.google.com/admob/answer/9572326.

treatmentMediationLines[]

object (ExperimentMediationLine)

שורות ה-Mediation של הניסוי שנוצרו לקבוצת הניסוי. המערכת תשתמש בהם להצגת מודעות כשהסטטוס של הניסוי הוא 'פועל'.

controlMediationLines[]

object (ExperimentMediationLine)

פלט בלבד. שורות ה-Mediation של הניסוי לצורך בקרה. הן עוברות בירושה מקבוצת הבחירה ברשת (Mediation) ברמת ההורה. זהו שדה פלט בלבד.

state

enum (ExperimentState)

פלט בלבד. מצב הניסוי. זהו שדה פלט בלבד.

startTime

string (Timestamp format)

פלט בלבד. השעה שבה הניסוי התחיל (לפי שעון UTC).

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

פלט בלבד. השעה שבה הניסוי הסתיים או השעה שבה הוא אמור להסתיים (ב-UTC).

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

mediationGroupId

string

פלט בלבד. מזהה הקבוצה לבחירת רשת (Mediation) שהניסוי הזה שייך אליה. אפשר להשתמש בפרמטר הזה כדי לסנן את הניסויים ב-API של רשימת הניסויים.

variantLeader

enum (VariantLeader)

פלט בלבד. הווריאנט המוביל בניסוי לפי כמה מדדים מרכזיים.

ExperimentMediationLine

השורה של הקבוצה לבחירת רשת (Mediation) בניסוי. הקמפיין הזה ישמש להצגת מודעות במהלך הניסוי.

ייצוג ב-JSON
{
  "mediationGroupLine": {
    object (MediationGroupLine)
  }
}
שדות
mediationGroupLine

object (MediationGroupLine)

השורה בקבוצה לבחירת רשת שבה נעשה שימוש בניסוי.

ExperimentState

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

  1. הסתיים: הניסוי מסתיים אחרי 90 יום אם לא נבחר וריאנט מנצח.

  2. פג תוקף: אם נבחרה הווריאציה המנצחת או אם חלפו 30 יום מאז שהניסוי הסתיים, הניסוי עובר למצב 'פג תוקף' והווריאציה ב' נמחקת.

טיפוסים בני מנייה (enum)
EXPERIMENT_STATE_UNSPECIFIED ברירת המחדל לשדה שלא הוגדר. אין להשתמש בו.
EXPIRED התוקף של הניסוי פג.
RUNNING הניסוי פועל ולכן נעשה בו שימוש בהצגת מודעות.
ENDED הניסוי הסתיים, אבל עדיין לא פג התוקף שלו. הצגת המודעות ממשיכה בתצורות המקוריות בזמן שהניסוי מוכן להפעלת פעולה.

VariantLeader

הווריאנט המוביל בניסוי.

טיפוסים בני מנייה (enum)
VARIANT_LEADER_UNSPECIFIED ערך ברירת המחדל של ה-enum. אין להשתמש בו.
CONTROL קבוצת הבקרה שמובילה את הניסוי.
TREATMENT הטיפול שמוביל את הניסוי.
INSUFFICIENT_DATA אין מספיק נתונים (חשיפות) כדי לקבוע מי הקבוצה המובילה.
TOO_EARLY_TO_CALL הניסוי לא פעל מספיק זמן כדי לקבוע מהי הגרסה המובילה.
NO_VARIANT_LEADER אף אחד מהווריאנטים לא מוביל באופן מובהק בנתונים שנצפו.

Methods

create

יוצרים ניסוי בדיקת A/B עבור חשבון AdMob ספציפי וקבוצה לבחירת רשת.

stop

עוצרים את ניסוי ה-A/B בתהליך בחירת הרשת ובוחרים וריאציה.