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
}
الحقول
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

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

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 اكتمل الإجراء بنجاح مع ظهور تحذيرات.