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

مطلوبة. اسم التجربة. يجب أن يبلغ طوله 1024 كحد أدنى و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 مثال: 2019-03-14
endDate

string

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

التنسيق: YYYY-MM-DD مثال: 2019-04-18
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 اكتمل الإجراء بنجاح مع ظهور تحذيرات.