- المورد: 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 |
الدفع مقابل كل مشاهدة نشطة |
الطُرق |
|
---|---|
|
يسرد خيارات الاستهداف المعيّنة لطلب إدراج على مستوى أنواع الاستهداف. |
|
إنشاء طلب إدراج جديد. |
|
حذف طلب إدراج |
|
الحصول على طلب إدراج |
|
يسرد طلبات الإدراج في أحد المعلِنين. |
|
لتعديل طلب إدراج حالي |