- المورد: InsertionOrder
- InsertionOrderType
- مؤشر الأداء الرئيسي
- KpiType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- OptimizationObjective
- الطُرق
المرجع: InsertionOrder
طلب إدراج واحد
تمثيل JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد لطلب الإدراج |
advertiserId |
النتائج فقط. المعرّف الفريد للمعلِن الذي ينتمي إليه طلب الإدراج |
campaignId |
مطلوب. غير قابل للتغيير. المعرّف الفريد للحملة التي ينتمي إليها طلب الإدراج |
insertionOrderId |
النتائج فقط. المعرّف الفريد لطلب الإدراج يحدده النظام. |
displayName |
مطلوب. الاسم المعروض لطلب الإدراج يجب أن يكون بترميز UTF-8 بحيث لا يزيد حجمه عن 240 بايت. |
insertionOrderType |
نوع طلب الإدراج إذا لم يتم تحديد هذا الحقل عند الإنشاء، سيتم ضبط القيمة التلقائية على |
entityStatus |
مطلوب. تتحكّم هذه السياسة في ما إذا كان يمكن لطلب الإدراج إنفاق الميزانية وتقديم عروض الأسعار على المستودع الإعلاني.
|
updateTime |
النتائج فقط. الطابع الزمني لآخر تعديل لطلب الإدراج يحدده النظام. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
partnerCosts[] |
تكاليف الشريك المرتبطة بطلب الإدراج في حال عدم توفّر هذا الطلب أو تركه فارغًا في طريقة |
pacing |
مطلوب. إعدادات سرعة إنفاق الميزانية لطلب الإدراج |
frequencyCap |
مطلوب. إعداد تحديد عدد مرات الظهور لطلب الإدراج |
integrationDetails |
تفاصيل إضافية عن الدمج لطلب الإدراج |
kpi |
مطلوب. مؤشر الأداء الرئيسي (KPI) لطلب الإدراج. ويتم تمثيل ذلك باسم "الهدف" في شاشة العرض واجهة فيديو 360. |
budget |
مطلوب. إعدادات تخصيص الميزانية لطلب الإدراج |
bidStrategy |
استراتيجية عروض الأسعار لطلب الإدراج ويتم ضبط |
reservationType |
النتائج فقط. نوع الحجز لطلب الإدراج |
optimizationObjective |
اختياريّ. هدف التحسين لطلب الإدراج لا يتوفّر هذا الحقل إلا للعملاء المدرَجين في القائمة المسموح بها. إذا لم يكن عميل مُدرَجًا في القائمة المسموح بها، سيكون هذا الحقل خاليًا، وسيؤدي محاولة ضبطه إلى ظهور رسالة خطأ. |
InsertionOrderType
الأنواع المحتملة لطلب الإدراج
ويحدِّد نوع طلب الإدراج الإعدادات والخيارات السارية، مثل شكل الإعلانات أو خيارات الاستهداف.
عمليات التعداد | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
نوع طلب الإدراج غير محدّد أو غير معروف. |
RTB |
عرض الأسعار في الوقت الفعلي: |
OVER_THE_TOP |
خدمة البث المباشر على الإنترنت. |
مؤشر الأداء الرئيسي
الإعدادات التي تتحكم في مؤشر الأداء الرئيسي (KPI) لطلب الإدراج.
تمثيل JSON |
---|
{ "kpiType": enum ( |
الحقول | |
---|---|
kpiType |
مطلوب. تمثّل هذه السمة نوع مؤشر الأداء الرئيسي. |
kpiAlgorithmId |
اختياريّ. رقم تعريف خوارزمية عروض الأسعار المخصّصة المرتبط بـ KPI_CUSTOM_IMPRESSION_VALUE_OVER_COST. ويتم تجاهل هذا الحقل في حال عدم اختيار مؤشر الأداء الرئيسي المناسب. |
حقل الاتحاد kpi_value . مطلوب. قيمة مؤشر الأداء الرئيسي. ويتطابق الحقل ذي الصلة مع kpi_type . يمكن أن يكون kpi_value واحدًا فقط مما يلي: |
|
kpiAmountMicros |
مبلغ الهدف بالميكرو بعملة المعلن. سارٍ عندما تكون السمة
على سبيل المثال: 1500000 يمثل 1.5 وحدة قياسية للعملة. |
kpiPercentageMicros |
التمثيل العشري للنسبة المئوية للهدف بوحدات المايكرو. سارٍ عندما تكون السمة
على سبيل المثال: 70000 يمثّل نسبة 7% (الرقم العشري 0.07). |
kpiString |
سلسلة مؤشر الأداء الرئيسي، والتي يمكن أن تكون فارغة. يجب أن يكون بترميز UTF-8 بطول لا يزيد عن 100 حرف. يسري هذا العرض عندما تكون قيمة الحقل " |
KpiType
أنواع مؤشرات الأداء الرئيسية المحتملة (KPI).
عمليات التعداد | |
---|---|
KPI_TYPE_UNSPECIFIED |
لم يتم تحديد نوع مؤشر الأداء الرئيسي أو أنّه غير معروف في هذا الإصدار. |
KPI_TYPE_CPM |
ومؤشر الأداء الرئيسي هو CPM (التكلفة لكل ألف ظهور). |
KPI_TYPE_CPC |
ومؤشر الأداء الرئيسي هو تكلفة النقرة. |
KPI_TYPE_CPA |
مؤشر الأداء الرئيسي هو تكلفة الإجراء (CPA). |
KPI_TYPE_CTR |
ومؤشر الأداء الرئيسي هو نسبة النقر إلى الظهور (CTR). |
KPI_TYPE_VIEWABILITY |
مؤشر الأداء الرئيسي هو نسبة إمكانية العرض. |
KPI_TYPE_CPIAVC |
مؤشر الأداء الرئيسي هو CPIAVC (تكلفة الظهور المسموعة والمرئية عند الانتهاء). |
KPI_TYPE_CPE |
مؤشر الأداء الرئيسي هو تكلفة المشاركة (CPE). |
KPI_TYPE_CPV |
يتم تعيين مؤشر الأداء الرئيسي بنظام تكلفة المشاهدة (CPV). |
KPI_TYPE_CLICK_CVR |
ومؤشر الأداء الرئيسي هو النسبة المئوية لمعدّل الإحالات الناجحة الناتجة عن النقر (الإحالات الناجحة لكل نقرة). |
KPI_TYPE_IMPRESSION_CVR |
ومؤشر الأداء الرئيسي هو النسبة المئوية لمعدّل الإحالات الناجحة الناتجة عن ظهور الإعلان (الإحالات الناجحة لكل ظهور). |
KPI_TYPE_VCPM |
مؤشر الأداء الرئيسي هو التكلفة لكل ألف ظهور قابل للعرض (VCPM). |
KPI_TYPE_VTR |
مؤشر الأداء الرئيسي هو نسبة المشاهدة على YouTube (عدد المشاهدات على YouTube لكل ظهور). |
KPI_TYPE_AUDIO_COMPLETION_RATE |
مؤشر الأداء الرئيسي هو النسبة المئوية لمعدّل اكتمال الصوت (الاستماع إلى الصوت الكامل لكل ظهور). |
KPI_TYPE_VIDEO_COMPLETION_RATE |
مؤشر الأداء الرئيسي هو النسبة المئوية لمعدّل مشاهدة الفيديو بالكامل (عدد المشاهدات الكاملة للفيديو لكل ظهور). |
KPI_TYPE_CPCL |
ويتم ضبط مؤشر الأداء الرئيسي بنظام تكلفة النقرة المكتملة (CPCL). |
KPI_TYPE_CPCV |
ويتم ضبط مؤشر الأداء الرئيسي على أساس تكلفة مشاهدة الفيديو بالكامل (CPCV). |
KPI_TYPE_TOS10 |
ويتم ضبط مؤشر الأداء الرئيسي وفقًا لمعدّل الوقت المستغرَق في الشاشة لأكثر من 10 ثوانٍ (النسبة المئوية لمرات الظهور القابلة للقياس وغير القابلة للتخطّي التي ظهرت على الشاشة لمدة 10 ثوانٍ على الأقل). |
KPI_TYPE_MAXIMIZE_PACING |
تم ضبط مؤشر الأداء الرئيسي لزيادة تأثير العلامة التجارية مع إعطاء الأولوية لإنفاق الميزانية بالكامل. |
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST |
يتمّ ضبط مقياس الأداء الرئيسي على القيمة المخصّصة لمرّات الظهور مقسومة على التكلفة. |
KPI_TYPE_OTHER |
مؤشر الأداء الرئيسي هو بعض القيمة الأخرى. |
InsertionOrderBudget
الإعدادات التي تتحكّم في كيفية تخصيص ميزانية طلب الإدراج.
تمثيل JSON |
---|
{ "budgetUnit": enum ( |
الحقول | |
---|---|
budgetUnit |
مطلوب. غير قابل للتغيير. تحدّد وحدة الميزانية ما إذا كانت الميزانية مستندة إلى العملة أو مستندة إلى الظهور. |
automationType |
نوع التشغيل الآلي المستخدَم لإدارة عرض السعر والميزانية لطلب الإدراج إذا لم يتم تحديد هذا الحقل عند الإنشاء، سيتم ضبط القيمة التلقائية على |
budgetSegments[] |
مطلوب. قائمة شرائح الميزانية استخدِم شريحة ميزانية لتحديد ميزانية معيّنة لفترة زمنية معيّنة يتم فيها تنفيذ طلب إدراج. |
InsertionOrderAutomationType
الخيارات المتاحة للتشغيل المبرمَج لعرض سعر طلب الإدراج والميزانية
عمليات التعداد | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
خيار التشغيل الآلي لطلب الإدراج غير محدّد أو غير معروف في هذا الإصدار. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
التخصيص التلقائي للميزانية. السماح للنظام بتحويل الميزانية تلقائيًا إلى العناصر المملوكة من أجل تحسين الأداء المحدّد في kpi . لا تتوفّر إمكانية التشغيل الآلي في إعدادات عروض الأسعار. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
لا يتم ضبط عروض الأسعار أو الميزانية بشكل آلي على مستوى طلب الإدراج. يجب ضبط عرض السعر والميزانية يدويًا على مستوى العنصر. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
السماح للنظام بتعديل عروض الأسعار تلقائيًا وتحويل الميزانية إلى العناصر المملوكة من أجل تحسين الأداء المحدّد في kpi . |
InsertionOrderBudgetSegment
هي الإعدادات التي تتحكّم في ميزانية شريحة واحدة من الميزانيات.
تمثيل JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
الحقول | |
---|---|
budgetAmountMicros |
مطلوب. مبلغ الميزانية الذي سينفقه طلب الإدراج لقيمة |
description |
وصف شريحة الميزانية. ويمكن استخدامه لإدخال معلومات "طلب الشراء" لكل قسم من أقسام الميزانية وطباعة هذه المعلومات على الفواتير. يجب أن تكون بترميز UTF-8. |
dateRange |
مطلوب. إعدادات تاريخَي البدء والانتهاء لقسم الميزانية. ويتم حلها وفقًا للمنطقة الزمنية للمعلِن الرئيسي.
|
campaignBudgetId |
|
OptimizationObjective
الأنواع المحتملة لأهداف التحسين.
عمليات التعداد | |
---|---|
OPTIMIZATION_OBJECTIVE_UNSPECIFIED |
قيمة النوع غير محدّدة أو غير معروفة في هذا الإصدار. |
CONVERSION |
امنح الأولوية لمرات الظهور التي تؤدي إلى زيادة المبيعات والإحالات الناجحة. |
CLICK |
إعطاء الأولوية لمرات الظهور التي تزيد من زيارات الموقع الإلكتروني والتطبيقات ومتاجر التطبيقات |
BRAND_AWARENESS |
أعط الأولوية لانطباعات جودة معينة. |
CUSTOM |
يتم تحديد الهدف من خلال خوارزمية عروض الأسعار المخصّصة المحدّدة. |
NO_OBJECTIVE |
عدم تحديد الهدف. ويمكن استخدام أي مؤشرات أداء رئيسية أو استراتيجية عروض أسعار. |
الطُرق |
|
---|---|
|
ينشئ طلب إدراج جديدًا. |
|
يؤدي هذا الإجراء إلى حذف طلب إدراج. |
|
الحصول على طلب إدراج |
|
يسرد طلبات الإدراج في أحد المعلِنين. |
|
يسرد خيارات الاستهداف المحدّدة لطلب إدراج على مستوى أنواع الاستهداف المختلفة. |
|
تعديل طلب إدراج حالي |