PerformanceGoal

الإعدادات التي تتحكّم في هدف الأداء لحملة أو طلب إدراج.

تمثيل JSON
{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}
الحقول
performanceGoalType

enum (PerformanceGoalType)

مطلوبة. نوع هدف الأداء.

حقل الاتحاد performance_goal_value مطلوبة. قيمة هدف الأداء المقابلة لـ performance_goal_type محدد. يمكن أن تكون السمة "performance_goal_value" واحدة فقط مما يلي:
performanceGoalAmountMicros

string (int64 format)

مبلغ الهدف بالمايكرو من عملة المعلِن.

يسري ذلك إذا كانت السمة performanceGoalType واحدة مما يلي:

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_VCPM

على سبيل المثال، 1500000 يمثل 1.5 وحدة قياسية من العملة.

performanceGoalPercentageMicros

string (int64 format)

تمثيل عشري لنسبة الهدف بالمايكرو.

يسري ذلك إذا كانت السمة performanceGoalType واحدة مما يلي:

  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_CLICK_CVR
  • PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
  • PERFORMANCE_GOAL_TYPE_VTR
  • PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
  • PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

على سبيل المثال، 70000 تمثل 7٪ (الكسر العشري 0.07).

performanceGoalString

string

سلسلة مؤشر الأداء الرئيسي (KPI) يمكن أن تكون فارغة يجب أن يكون بالترميز UTF-8 بطول لا يزيد عن 100 حرف.

يسري هذا العرض الترويجي عند ضبط performanceGoalType على PERFORMANCE_GOAL_TYPE_OTHER.

PerformanceGoalType

الأنواع المحتملة من أهداف الأداء.

عمليات التعداد
PERFORMANCE_GOAL_TYPE_UNSPECIFIED نوع هدف الأداء غير محدد أو غير معروف في هذا الإصدار.
PERFORMANCE_GOAL_TYPE_CPM يتم تحديد هدف الأداء بالتكلفة لكل ألف ظهور.
PERFORMANCE_GOAL_TYPE_CPC يتم تحديد هدف الأداء بتكلفة النقرة.
PERFORMANCE_GOAL_TYPE_CPA يتم تحديد هدف الأداء بتكلفة الإجراء (CPA).
PERFORMANCE_GOAL_TYPE_CTR يتم تحديد هدف الأداء بالنسبة المئوية إلى نسبة النقر إلى الظهور.
PERFORMANCE_GOAL_TYPE_VIEWABILITY يتم ضبط هدف الأداء على النسبة المئوية لإمكانية العرض.
PERFORMANCE_GOAL_TYPE_CPIAVC يتم تحديد هدف الأداء على أنّه CPIAVC (تكلفة مرة ظهور مسموعة ومرئية عند الانتهاء).
PERFORMANCE_GOAL_TYPE_CPE يتم تحديد هدف الأداء بتكلفة المشاركة (CPE).
PERFORMANCE_GOAL_TYPE_CLICK_CVR يتم تحديد هدف الأداء بالنسبة المئوية لمعدّل الإحالات الناجحة الناتجة عن النقر (الإحالات الناجحة لكل نقرة).
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR يتم تحديد هدف الأداء بالنسبة المئوية لمعدّل الإحالات الناجحة لمرات الظهور (الإحالات الناجحة لكل مرة ظهور).
PERFORMANCE_GOAL_TYPE_VCPM يتم ضبط هدف الأداء بالتكلفة لكل ألف ظهور قابل للعرض.
PERFORMANCE_GOAL_TYPE_VTR يتم تحديد هدف الأداء بالنسبة المئوية لنسبة المشاهدة على YouTube (عدد المشاهدات على YouTube لكل مرة ظهور).
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE يتم تحديد هدف الأداء بالنسبة المئوية لمعدّل إكمال الصوت (عدد مرات الاستماع إلى المقطع الصوتي الكامل لكل مرة ظهور).
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE يتم تحديد هدف الأداء بالنسبة المئوية لمعدّل إكمال الفيديو (عدد مرات مشاهدة الفيديو الكاملة لكل مرة ظهور).
PERFORMANCE_GOAL_TYPE_OTHER تم ضبط هدف الأداء على "غير ذلك".