- المورد: InsertionOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- الطُرق
المرجع: 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 "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
partnerCosts[] |
تكاليف الشريك المرتبطة بطلب الإدراج إذا لم يتم توفير البيانات أو كانت فارغة في طريقة |
pacing |
مطلوبة. إعداد سرعة إنفاق الميزانية لطلب الإدراج |
frequencyCap |
مطلوبة. إعداد تحديد عدد مرات الظهور لطلب الإدراج. |
integrationDetails |
تفاصيل دمج إضافية لطلب الإدراج |
performanceGoal |
مطلوبة. هدف الأداء الخاص بطلب الإدراج |
budget |
مطلوبة. إعدادات تخصيص الميزانية لطلب الإدراج |
bidStrategy |
استراتيجية عروض الأسعار لطلب الإدراج. بشكل تلقائي، يتم ضبط |
reservationType |
النتائج فقط. نوع الحجز لطلب الإدراج |
billableOutcome |
غير قابل للتغيير. النتيجة القابلة للفوترة لطلب الإدراج تم إيقاف الشراء المستند إلى النتائج نهائيًا. |
InsertionOrderType
الأنواع المحتملة من طلب الإدراج
يحدّد نوع طلب الإدراج الإعدادات والخيارات السارية، مثل شكل الإعلانات أو خيارات الاستهداف.
عمليات التعداد | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
نوع طلب الإدراج غير محدّد أو غير معروف. |
RTB |
عرض الأسعار في الوقت الفعلي. |
OVER_THE_TOP |
خدمة البث المباشر على الإنترنت: |
InsertionOrderBudget
الإعدادات التي تتحكّم في كيفية تخصيص ميزانية طلب الإدراج
تمثيل JSON |
---|
{ "budgetUnit": enum ( |
الحقول | |
---|---|
budgetUnit |
مطلوبة. غير قابل للتغيير. تحدد وحدة الميزانية ما إذا كانت الميزانية تستند إلى العملة أو مستندة إلى مرات الظهور. |
automationType |
نوع التشغيل الآلي المستخدَم لإدارة عرض السعر والميزانية لطلب الإدراج في حال عدم تحديد هذا الحقل في عملية الإنشاء، سيتم ضبط القيمة التلقائية على |
budgetSegments[] |
مطلوبة. قائمة شرائح الميزانية. استخدِم شريحة ميزانية لتحديد ميزانية معيّنة خلال فترة زمنية معيّنة يتم فيها تنفيذ طلب إدراج. |
InsertionOrderAutomationType
الخيارات المتاحة لبرمجة عرض السعر والميزانية على طلب الإدراج
عمليات التعداد | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
خيار التشغيل الآلي لطلب الإدراج غير محدّد أو غير معروف في هذا الإصدار. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
التخصيص التلقائي للميزانية. يمكنك السماح للنظام بتغيير الميزانية تلقائيًا إلى مالك العناصر لتحسين الأداء المحدّد في performanceGoal . لا يتم تفعيل التشغيل الآلي لإعدادات عروض الأسعار. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
لا يتم التشغيل الآلي لعرض السعر أو الميزانية على مستوى طلب الإدراج. يجب ضبط عرض السعر والميزانية يدويًا على مستوى العنصر. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
السماح للنظام بتعديل عروض الأسعار تلقائيًا وتغيير الميزانية إلى العناصر المالكة لتحسين الأداء المحدّد في performanceGoal . |
InsertionOrderBudgetSegment
الإعدادات التي تتحكم في ميزانية شريحة واحدة من الميزانية.
تمثيل JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
الحقول | |
---|---|
budgetAmountMicros |
مطلوبة. مبلغ الميزانية الذي سيتم إنفاقه في طلب الإدراج في شريحة |
description |
وصف شريحة الميزانية. ويمكن استخدامه لإدخال معلومات طلب الشراء لكل شريحة من شرائح الميزانية وطباعة هذه المعلومات على الفواتير. يجب ترميزها باستخدام UTF-8. |
dateRange |
مطلوبة. إعدادات تاريخَي البدء والانتهاء لشريحة الميزانية. يتم حلها وفقًا للمنطقة الزمنية للمعلِن الرئيسي.
|
campaignBudgetId |
|
BillableOutcome
وقد تكون هذه النتائج قابلة للفوترة عن طلب إدراج.
عمليات التعداد | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
نتيجة غير محدّدة قابلة للفوترة |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
الدفع مقابل مرات الظهور |
BILLABLE_OUTCOME_PAY_PER_CLICK |
الدفع بالنقرة. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
الدفع مقابل كل عرض نشط |
الطُرق |
|
---|---|
|
إنشاء طلب إدراج جديد |
|
لحذف طلب إدراج |
|
تلقّي طلب إدراج |
|
يسرد طلبات الإدراج في المعلِن. |
|
يسرد خيارات الاستهداف المعيّنة لطلب إدراج على مستوى أنواع الاستهداف المختلفة. |
|
لتعديل طلب إدراج حالي |