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)

النسبة المئوية لعدد الزيارات في تجربة أ/ب لميزة التوسّط التي سيتم إرسالها إلى المجموعة الضابطة (الصيغة "ب") ويتم إرسال النسبة المتبقية إلى المجموعة الضابطة (الصيغة "أ"). يتم التعبير عن النسبة المئوية كعدد صحيح في النطاق الشامل [1,99]. يمكنك الاطّلاع على https://support.google.com/admob/answer/9572326 للحصول على التفاصيل.

treatmentMediationLines[]

object (ExperimentMediationLine)

خطوط التوسّط في التجربة التي تم إنشاؤها للمجموعة الضابطة وسيتم استخدامها لعرض الإعلانات عندما تكون حالة التجربة "جارية".

controlMediationLines[]

object (ExperimentMediationLine)

النتائج فقط. تمثّل هذه السمة وسيط التجربة الذي يتم استخدامه كعنصر تحكّم. يتم اكتسابها من مجموعة التوسّط الرئيسية. هذا الحقل مخصّص للنتائج فقط.

state

enum (ExperimentState)

النتائج فقط. تمثّل هذه السمة حالة التجربة. هذا الحقل مخصّص للنتائج فقط.

startTime

string (Timestamp format)

النتائج فقط. الوقت الذي بدأت فيه التجربة (بالتوقيت العالمي المنسّق).

يستخدم المعيار 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)

النتائج فقط. الوقت الذي انتهت فيه التجربة أو الوقت المستهدَف لإنهاء التجربة (بتوقيت غرينتش)

يستخدم المعيار 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

النتائج فقط. معرّف مجموعة التوسّط التي تنتمي إليها هذه التجربة. يمكن استخدام هذا المعرّف لفلترة التجارب في واجهة برمجة التطبيقات الخاصة بقائمة التجارب.

variantLeader

enum (VariantLeader)

النتائج فقط. الخيار الأفضل للتجربة وفقًا لبعض المقاييس الرئيسية

ExperimentMediationLine

سطر مجموعة التوسّط الخاص بالتجربة سيتم استخدامها لعرض الإعلانات أثناء تنفيذ التجربة.

تمثيل JSON
{
  "mediationGroupLine": {
    object (MediationGroupLine)
  }
}
الحقول
mediationGroupLine

object (MediationGroupLine)

سطر مجموعة التوسّط المستخدَم في التجربة.

ExperimentState

تمثّل هذه السمة حالة التجربة. هذا الحقل مخصّص للقراءة فقط. يمكن أن تكون التجربة في إحدى الحالات الثلاث التالية، ويمكن الانتقال بينها كما هو موضّح أدناه: 1. قيد التنفيذ: عند إنشاء التجربة، يتم وضعها في حالة "قيد التنفيذ". يتم عرض كلّ من بنود مجموعة التوسّط الضابطة والتجريبية وفقًا لـ treatmentTrafficPercentage المحدّدة.

  1. منتهية: تنتهي التجربة بعد 90 يومًا إذا لم يتم اختيار الصيغة الفائزة.

  2. منتهية الصلاحية: إذا تم اختيار الصيغة الفائزة أو إذا مرّ 30 يومًا على انتهاء التجربة، ستنتقل التجربة إلى الحالة "منتهية الصلاحية" وسيتم حذف الصيغة "ب".

عمليات التعداد
EXPERIMENT_STATE_UNSPECIFIED القيمة التلقائية لحقل لم يتم ضبطه لا تستخدم هذه السمة.
EXPIRED انتهت صلاحية التجربة.
RUNNING التجربة قيد التشغيل وبالتالي يتم استخدامها في العرض.
ENDED انتهت التجربة، ولكنّها لم تنتهِ صلاحيتها بعد. يستمر العرض في الإعدادات الأصلية إلى أن تصبح التجربة جاهزة لتنفيذ إجراء.

VariantLeader

الصيغة الأفضل أداءً في التجربة

عمليات التعداد
VARIANT_LEADER_UNSPECIFIED القيمة التلقائية للتعداد لا تستخدم هذه السمة.
CONTROL عنصر التحكّم الذي يقود التجربة
TREATMENT العلاج الذي يؤدي إلى التجربة
INSUFFICIENT_DATA البيانات التي تم جمعها (مرات الظهور) غير كافية لتحديد قائد.
TOO_EARLY_TO_CALL لم يتم تنفيذ التجربة لفترة كافية لتحديد التجربة الأفضل.
NO_VARIANT_LEADER لا يوجد إصدار فائز بشكل حاسم في البيانات المرصودة.

الطُرق

create

أنشئ تجربة اختبار أ/ب لحساب محدّد على AdMob ومجموعة توسّط.

stop

أوقِف تجربة اختبار أ/ب للتوسّط واختَر صيغة.