REST Resource: advertisers.insertionOrders

المرجع: InsertionOrder

طلب إدراج واحد.

تمثيل JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "displayName": string,
  "insertionOrderType": enum (InsertionOrderType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "performanceGoal": {
    object (PerformanceGoal)
  },
  "budget": {
    object (InsertionOrderBudget)
  },
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "reservationType": enum (ReservationType),
  "billableOutcome": enum (BillableOutcome)
}
الحقول
name

string

النتائج فقط. اسم المورد الخاص بطلب الإدراج
advertiserId

string (int64 format)

النتائج فقط. المعرّف الفريد للمعلِن الذي ينتمي إليه طلب الإدراج
campaignId

string (int64 format)

مطلوبة. غير قابل للتغيير. رقم التعريف الفريد للحملة التي ينتمي إليها طلب الإدراج
insertionOrderId

string (int64 format)

النتائج فقط. المعرّف الفريد لطلب الإدراج تم تعيينه من قِبل النظام.
displayName

string

مطلوبة. الاسم المعروض لطلب الإدراج

يجب ترميزها باستخدام UTF-8 بحجم 240 بايت كحد أقصى.
insertionOrderType

enum (InsertionOrderType)

نوع طلب الإدراج

في حال عدم تحديد هذا الحقل في عملية الإنشاء، سيتم ضبط القيمة التلقائية على RTB.
entityStatus

enum (EntityStatus)

مطلوبة. تتحكّم هذه السياسة في ما إذا كان بإمكان طلب الإدراج إنفاق ميزانيته وعروض أسعاره على المستودع أم لا.

  • بالنسبة إلى طريقة insertionOrders.create، يُسمح فقط بالقيمة ENTITY_STATUS_DRAFT. لتفعيل طلب إدراج، استخدِم طريقة insertionOrders.patch وعدِّل الحالة إلى ENTITY_STATUS_ACTIVE بعد الإنشاء.
  • لا يمكن تغيير حالة طلب الإدراج مرة أخرى إلى حالة "ENTITY_STATUS_DRAFT" من أي حالة أخرى.
  • لا يمكن ضبط طلب الإدراج على ENTITY_STATUS_ACTIVE إذا كانت حملته الرئيسية غير نشطة.
updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر تعديل لطلب الإدراج تم تعيينه من قِبل النظام.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
partnerCosts[]

object (PartnerCost)

تكاليف الشريك المرتبطة بطلب الإدراج

إذا لم يتم توفير البيانات أو كانت فارغة في طريقة insertionOrders.create، سيكتسب طلب الإدراج الذي تم إنشاؤه حديثًا تكاليف الشريك من إعدادات الشريك.
pacing

object (Pacing)

مطلوبة. إعداد سرعة إنفاق الميزانية لطلب الإدراج
frequencyCap

object (FrequencyCap)

مطلوبة. إعداد تحديد عدد مرات الظهور لطلب الإدراج.
integrationDetails

object (IntegrationDetails)

تفاصيل دمج إضافية لطلب الإدراج
performanceGoal

object (PerformanceGoal)

مطلوبة. هدف الأداء الخاص بطلب الإدراج
budget

object (InsertionOrderBudget)

مطلوبة. إعدادات تخصيص الميزانية لطلب الإدراج
bidStrategy

object (BiddingStrategy)

استراتيجية عروض الأسعار لطلب الإدراج. بشكل تلقائي، يتم ضبط fixedBid.
reservationType

enum (ReservationType)

النتائج فقط. نوع الحجز لطلب الإدراج
billableOutcome

enum (BillableOutcome)

غير قابل للتغيير. النتيجة القابلة للفوترة لطلب الإدراج

تم إيقاف الشراء المستند إلى النتائج نهائيًا. BILLABLE_OUTCOME_PAY_PER_IMPRESSION هي القيمة الوحيدة الصالحة.

InsertionOrderType

الأنواع المحتملة من طلب الإدراج

يحدّد نوع طلب الإدراج الإعدادات والخيارات السارية، مثل شكل الإعلانات أو خيارات الاستهداف.

عمليات التعداد
INSERTION_ORDER_TYPE_UNSPECIFIED نوع طلب الإدراج غير محدّد أو غير معروف.
RTB عرض الأسعار في الوقت الفعلي.
OVER_THE_TOP خدمة البث المباشر على الإنترنت:

InsertionOrderBudget

الإعدادات التي تتحكّم في كيفية تخصيص ميزانية طلب الإدراج

تمثيل JSON 
{
  "budgetUnit": enum (BudgetUnit),
  "automationType": enum (InsertionOrderAutomationType),
  "budgetSegments": [
    {
      object (InsertionOrderBudgetSegment)
    }
  ]
}
الحقول
budgetUnit

enum (BudgetUnit)

مطلوبة. غير قابل للتغيير. تحدد وحدة الميزانية ما إذا كانت الميزانية تستند إلى العملة أو مستندة إلى مرات الظهور.
automationType

enum (InsertionOrderAutomationType)

نوع التشغيل الآلي المستخدَم لإدارة عرض السعر والميزانية لطلب الإدراج

في حال عدم تحديد هذا الحقل في عملية الإنشاء، سيتم ضبط القيمة التلقائية على INSERTION_ORDER_AUTOMATION_TYPE_NONE.
budgetSegments[]

object (InsertionOrderBudgetSegment)

مطلوبة. قائمة شرائح الميزانية. استخدِم شريحة ميزانية لتحديد ميزانية معيّنة خلال فترة زمنية معيّنة يتم فيها تنفيذ طلب إدراج.

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 (DateRange)
  },
  "campaignBudgetId": string
}
الحقول
budgetAmountMicros

string (int64 format)

مطلوبة. مبلغ الميزانية الذي سيتم إنفاقه في طلب الإدراج في شريحة dateRange المحدّدة. قيمة المبلغ بالمايكرو. يجب أن يكون أكبر من 0. على سبيل المثال، 500000000 يمثل 500 وحدة قياسية للعملة.
description

string

وصف شريحة الميزانية. ويمكن استخدامه لإدخال معلومات طلب الشراء لكل شريحة من شرائح الميزانية وطباعة هذه المعلومات على الفواتير.

يجب ترميزها باستخدام UTF-8.
dateRange

object (DateRange)

مطلوبة. إعدادات تاريخَي البدء والانتهاء لشريحة الميزانية. يتم حلها وفقًا للمنطقة الزمنية للمعلِن الرئيسي.

  • عند إنشاء شريحة ميزانية جديدة، يجب أن تكون كلٌّ من startDate وendDate في المستقبل.
  • تحتوي شريحة الميزانية الحالية التي تتضمّن startDate في الماضي على عنصر endDate قابل للتغيير، ولكنّ شريحة startDate غير قابلة للتغيير.
  • يجب أن تستخدم السمة endDate القيمة startDate أو تاريخ لاحق، وكلاهما قبل عام 2037.
campaignBudgetId

string (int64 format)

budgetId لميزانية الحملة التي تشكّل شريحة الميزانية الخاصة بطلب الإدراج جزءًا منها.

BillableOutcome

وقد تكون هذه النتائج قابلة للفوترة عن طلب إدراج.

عمليات التعداد
BILLABLE_OUTCOME_UNSPECIFIED نتيجة غير محدّدة قابلة للفوترة
BILLABLE_OUTCOME_PAY_PER_IMPRESSION الدفع مقابل مرات الظهور
BILLABLE_OUTCOME_PAY_PER_CLICK

الدفع بالنقرة.
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION

الدفع مقابل كل عرض نشط

الطُرق

create

 إنشاء طلب إدراج جديد

delete

 لحذف طلب إدراج

get

 تلقّي طلب إدراج

list

 يسرد طلبات الإدراج في المعلِن.

listAssignedTargetingOptions

 يسرد خيارات الاستهداف المعيّنة لطلب إدراج على مستوى أنواع الاستهداف المختلفة.

patch

 لتعديل طلب إدراج حالي