Experiment

تجربة في "إعلانات Google" تتيح للمستخدمين تجربة التغييرات على حملات متعددة ومقارنة الأداء وتطبيق التغييرات الفعّالة.

تمثيل 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 مثال: 14-03-2019
endDate

string

تاريخ انتهاء التجربة. بشكل تلقائي، تنتهي التجربة في تاريخ انتهاء الحملة. إذا تم ضبط هذا الحقل، تنتهي التجربة في نهاية التاريخ المحدّد في المنطقة الزمنية للعميل.

التنسيق: YYYY-MM-DD مثال: 18-04-2019
longRunningOperation

string

النتائج فقط. اسم المورد لعملية التشغيل لفترة طويلة الذي يمكن استخدامه لإجراء استطلاع رأي لإكمال جدول التجربة أو الترويج له. يتم عرض آخر عملية طويلة المدى.
syncEnabled

boolean

غير قابل للتغيير. اضبطها على "صحيح" إذا كان يجب مزامنة التغييرات على الحملات الأساسية مع الحملات التجريبية. سيتم الاحتفاظ بأي تغييرات تم إجراؤها مباشرةً على الحملات التجريبية. لا يمكن ضبط هذا الحقل إلا أثناء إنشاء التجربة.

ExperimentType

نوع التجربة.

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

حالة التجربة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
ENABLED تم تفعيل التجربة.
REMOVED تمت إزالة التجربة.
HALTED تم إيقاف التجربة. يمكن ضبط هذه الحالة من الحالة "تفعيل" من خلال واجهة برمجة التطبيقات.
PROMOTED ستتم ترقية التجربة خارج الحالة التجريبية.
SETUP الحالة الأولية للتجربة.
INITIATED حملات التجربة في انتظار تحقيقها. يمكن ضبط هذه الحالة من حالة الإعداد عبر واجهة برمجة التطبيقات.
GRADUATED تمت ترقية التجربة.

MetricGoal

هدف قياسي لتجربة.

تمثيل JSON 
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
الحقول
metric

enum (ExperimentMetric)

مقياس الهدف. على سبيل المثال، النقرات ومرات الظهور والتكلفة والإحالات الناجحة وما إلى ذلك.
direction

enum (ExperimentMetricDirection)

الاتجاه القياسي للهدف. على سبيل المثال، زيادة أو نقصان أو بدون تغيير.

ExperimentMetric

نوع مقياس التجربة

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

نوع اتجاه مقياس التجربة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
NO_CHANGE الهدف من التجربة هو عدم تغيير المقياس.
INCREASE الهدف من التجربة هو إنشاء المقياس.
DECREASE الهدف من التجربة هو تقليل المقياس.
NO_CHANGE_OR_INCREASE الهدف من التجربة هو عدم تغيير المقياس أو زيادته.
NO_CHANGE_OR_DECREASE الهدف من التجربة هو عدم تغيير المقياس أو تخفيضه.

AsyncActionStatus

حالة الإجراء غير المتزامن للتجربة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
NOT_STARTED لم يبدأ الإجراء.
IN_PROGRESS الإجراء قيد التقدم.
COMPLETED اكتمل الإجراء بنجاح.
FAILED تعذَّر تنفيذ الإجراء.
COMPLETED_WITH_WARNING اكتمل الإجراء بنجاح مع ظهور تحذيرات.