REST Resource: advertisers.lineItems

المرجع: عنصر

تمثّل هذه السمة عنصرًا واحدًا.

تمثيل JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  }
}
الحقول
name

string

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

string (int64 format)

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

string (int64 format)

النتائج فقط. المعرّف الفريد للحملة التي ينتمي إليها العنصر.
insertionOrderId

string (int64 format)

مطلوبة. غير قابل للتغيير. المعرّف الفريد لطلب الإدراج الذي ينتمي إليه العنصر.
lineItemId

string (int64 format)

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

string

مطلوبة. الاسم المعروض للعنصر.

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

enum (LineItemType)

مطلوبة. غير قابل للتغيير. تمثّل هذه السمة نوع العنصر.
entityStatus

enum (EntityStatus)

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

  • بالنسبة إلى طريقة lineItems.create، يُسمح فقط بالقيمة ENTITY_STATUS_DRAFT. لتفعيل عنصر، استخدِم طريقة lineItems.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)

تكاليف الشريك المرتبطة بالعنصر.

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

object (LineItemFlight)

مطلوبة. وقت بدء عرض تفاصيل الإعلان ووقت انتهائه.
budget

object (LineItemBudget)

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

object (Pacing)

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

object (FrequencyCap)

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

يجب استخدام الحقل maxImpressions في عنصر الإعدادات هذا في حال تحديد حدّ أقصى محدود.
partnerRevenueModel

object (PartnerRevenueModel)

مطلوبة. إعداد نموذج أرباح الشريك للعنصر.
conversionCounting

object (ConversionCountingConfig)

إعداد تتبُّع الإحالات الناجحة للعنصر.
creativeIds[]

string (int64 format)

أرقام تعريف تصاميم الإعلانات المرتبطة بالعنصر.
bidStrategy

object (BiddingStrategy)

مطلوبة. استراتيجية عروض الأسعار للعنصر.
integrationDetails

object (IntegrationDetails)

تفاصيل دمج العنصر
targetingExpansion

object (TargetingExpansionConfig)

إعدادات الاستهداف المحسّن للعنصر.

لا تنطبق هذه الإعدادات إلا على عناصر الشبكة الإعلانية أو الفيديو أو تفاصيل الصوت التي تستخدم عروض الأسعار المبرمَجة وتستهدف قوائم المستخدمين المؤهَّلة بشكل إيجابي.
warningMessages[]

enum (LineItemWarningMessage)

النتائج فقط. رسائل التحذير التي تم إنشاؤها بواسطة العنصر. لا تؤدي هذه التحذيرات إلى حظر حفظ العنصر، إلا أنّ بعضها قد يؤدي إلى منع تشغيل العنصر.
mobileApp

object (MobileApp)

تطبيق الأجهزة الجوّالة الذي تم الترويج له من خلال العنصر.

ولا ينطبق ذلك إلا إذا كانت قيمة lineItemType هي LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL أو LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
reservationType

enum (ReservationType)

النتائج فقط. نوع حجز العنصر.
excludeNewExchanges

boolean

ما إذا كان سيتم استبعاد التبادلات الجديدة من الاستهداف التلقائي بواسطة العنصر أم لا. يكون هذا الحقل "خطأ" تلقائيًا.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

النتائج فقط. الإعدادات المخصّصة لعناصر YouTube والشركاء.

LineItemType

الأنواع المحتملة من العنصر.

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

عمليات التعداد
LINE_ITEM_TYPE_UNSPECIFIED

لم يتم تحديد قيمة النوع أو غير معروفة في هذا الإصدار.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_DISPLAY_DEFAULT الإعلانات المصوّرة أو إعلانات HTML5 أو الإعلانات المدمجة مع المحتوى أو إعلانات الوسائط الغنية.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL عرض الإعلانات التي تزيد من عمليات تثبيت أحد التطبيقات
LINE_ITEM_TYPE_VIDEO_DEFAULT إعلانات الفيديو التي يتم بيعها على أساس التكلفة لكل ألف ظهور في مجموعة متنوعة من البيئات.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL إعلانات الفيديو التي تزيد من عمليات تثبيت أحد التطبيقات
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

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

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

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

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_AUDIO_DEFAULT تُباع إعلانات عرض الأسعار في الوقت الفعلي (RTB) لمجموعة متنوعة من البيئات.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP إعلانات خدمة البث المباشر على الإنترنت متوفّرة في طلبات إدراج خدمة البث المباشر على الإنترنت لا ينطبق هذا النوع إلا على العناصر التي لها طلب إدراج بقيمة insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

إعلانات فيديو YouTube التي تروّج للإحالات الناجحة.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

إعلانات فيديو YouTube (التي تصل مدتها إلى 15 ثانية) لا يمكن تخطّيها.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

إعلانات فيديو YouTube التي تعرض قصة بتسلسل معيّن باستخدام مزيج من الأشكال.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

الإعلانات الصوتية على YouTube.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

إعلانات فيديو YouTube التي تعمل على تحسين الوصول إلى المزيد من المستخدمين الفرديين بتكلفة أقل. وقد يشمل ذلك إعلانات الملصقات الصغيرة أو الإعلانات القابلة للتخطي أثناء عرض الفيديو أو مزيج من أنواع الإعلانات.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

إعلانات فيديو YouTube التلقائية.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

إعلانات فيديو YouTube على التلفزيون المتّصل (تصل مدتها إلى 15 ثانية) ولا يمكن تخطّيها.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

إعلانات فيديو YouTube للتلفزيون المتّصل تعمل على تحسين الوصول إلى المزيد من المستخدمين الفرديين بتكلفة أقل وقد يشمل ذلك إعلانات الملصقات الصغيرة أو الإعلانات القابلة للتخطي أثناء عرض الفيديو أو مزيج من أنواع الإعلانات.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

إعلانات الفيديو التلقائية على YouTube للتلفزيون المتّصل يجب تضمين شكل الإعلان أثناء عرض الفيديو فقط.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

الهدف من هذا النوع من العناصر هو عرض عدد المرّات المستهدَفة من الإعلانات على YouTube للشخص نفسه في فترة زمنية معيّنة.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

إعلانات فيديو YouTube التي تهدف إلى الحصول على المزيد من المشاهدات باستخدام مجموعة متنوعة من أشكال الإعلانات.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

الإعلانات الصورية التي يتم عرضها على مستودع الإعلانات الرقمية خارج المنزل.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

إعلانات الفيديو التي يتم عرضها على مستودع الإعلانات الرقمية خارج المنزل.

لا يمكن إنشاء أو تعديل العناصر من هذا النوع واستهدافها باستخدام واجهة برمجة التطبيقات.

LineItemFlight

الإعدادات التي تتحكّم في مدة نشاط أحد العناصر.

تمثيل JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
الحقول
flightDateType

enum (LineItemFlightDateType)

مطلوبة. نوع تواريخ إطلاق العنصر.
dateRange

object (DateRange)

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

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

LineItemFlightDateType

الأنواع المحتملة من تواريخ إطلاق العنصر

عمليات التعداد
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED لم يتم تحديد قيمة النوع أو غير معروفة في هذا الإصدار.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED يتم اكتساب تواريخ إطلاق العنصر من طلب الإدراج الرئيسي.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM يستخدم العنصر تواريخ رحلات الطيران المخصّصة له.

LineItemBudget

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

تمثيل JSON 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
الحقول
budgetAllocationType

enum (LineItemBudgetAllocationType)

مطلوبة. نوع تخصيص الميزانية.

لا يسري LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC إلا عند تفعيل التخصيص التلقائي للميزانية لطلب الإدراج الرئيسي.
budgetUnit

enum (BudgetUnit)

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

string (int64 format)

الحد الأقصى لمبلغ الميزانية الذي سينفقه العنصر. يجب أن يكون أكبر من 0.

عندما تكون قيمة الحقل "budgetAllocationType":

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC، هذا الحقل غير قابل للتغيير ويتم ضبطه من خلال النظام.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED، إذا كانت السمة budgetUnit:
    • BUDGET_UNIT_CURRENCY، يمثّل هذا الحقل الحد الأقصى لمبلغ الميزانية المراد إنفاقه بالمايكرو من عملة المعلِن. على سبيل المثال، يمثِّل الرقم 1500000 1.5 وحدة عادية من العملة.
    • BUDGET_UNIT_IMPRESSIONS، يمثّل هذا الحقل الحد الأقصى لعدد مرّات الظهور المطلوب عرضها.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED، هذا الحقل غير قابل للتطبيق وسيتجاهله النظام.

LineItemBudgetAllocationType

الأنواع المحتملة من توزيع الميزانية

عمليات التعداد
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED لم يتم تحديد قيمة النوع أو غير معروفة في هذا الإصدار.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC تم تفعيل التخصيص التلقائي للميزانية للعنصر.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED يتم تخصيص مبلغ أقصى ثابت للميزانية للعنصر.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED لا يتم تطبيق حدّ ميزانية على العنصر.

PartnerRevenueModel

الإعدادات التي تتحكّم في كيفية احتساب أرباح الشريك.

تمثيل JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
الحقول
markupType

enum (PartnerRevenueModelMarkupType)

مطلوبة. نوع الترميز لنموذج أرباح الشريك.
markupAmount

string (int64 format)

مطلوبة. مبلغ الترميز لنموذج أرباح الشريك. يجب أن تكون القيمة أكبر من 0 أو مساوية له.

  • عند ضبط قيمة markupType على PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM، يمثّل هذا الحقل ترميز التكلفة لكل ألف ظهور بالميكرو من عملة المعلِن. على سبيل المثال، يمثِّل الرقم 1500000 1.5 وحدة عادية من العملة.
  • عند ضبط قيمة السمة markupType على PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP، يمثّل هذا الحقل ترميز النسبة المئوية لتكلفة جميع الوسائل بالملّي ثانية. على سبيل المثال، 100 تمثل 0.1% (عشري 0.001).
  • عند ضبط قيمة السمة markupType على PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP، يمثّل هذا الحقل ترميز النسبة المئوية لإجمالي تكلفة الوسائط بالمللي ثانية. على سبيل المثال، 100 تمثل 0.1% (عشري 0.001).

PartnerRevenueModelMarkupType

أنواع الترميز المحتملة لنموذج أرباح الشركاء.

عمليات التعداد
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED لم يتم تحديد قيمة النوع أو غير معروفة في هذا الإصدار.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM احتساب أرباح الشريك استنادًا إلى تكلفة ثابتة لكل ألف ظهور
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

احتسِب أرباح الشريك استنادًا إلى نسبة مئوية إضافية من تكلفة جميع الوسائل.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP احسب أرباح الشريك استنادًا إلى نسبة مئوية إضافية من إجمالي تكلفة جميع الوسائل، بما في ذلك جميع تكاليف الشركاء وتكاليف البيانات.

ConversionCountingConfig

الإعدادات التي تتحكّم في كيفية احتساب الإحالات الناجحة.

وسيتم احتساب جميع الإحالات الناجحة بعد النقر. يمكن ضبط قيمة النسبة المئوية لاحتساب الإحالات الناجحة بعد المشاهدة.

تمثيل JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
الحقول
postViewCountPercentageMillis

string (int64 format)

النسبة المئوية للإحالات الناجحة المطلوب احتسابها بالمللي ثانية (1, 000 من النسبة المئوية) يجب أن تتراوح القيمة بين 0 و100,000 كحدّ أقصى.

على سبيل المثال، لتتبُّع 50% من الإحالات الناجحة بعد النقر، حدِّد قيمة 50,000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

إعدادات نشاط Floodlight المستخدَمة لتتبُّع الإحالات الناجحة

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

TrackingFloodlightActivityConfig

الإعدادات التي تتحكّم في سلوك أحد إعدادات نشاط Floodlight

تمثيل JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
الحقول
floodlightActivityId

string (int64 format)

مطلوبة. رقم تعريف نشاط Floodlight.
postClickLookbackWindowDays

integer

مطلوبة. عدد الأيام التي تلي النقر على الإعلان والتي قد يتم احتساب إحالة ناجحة فيها. يجب أن تتراوح القيمة بين 0 و90 بشكل شامل.
postViewLookbackWindowDays

integer

مطلوبة. عدد الأيام التي بعد مشاهدة الإعلان والتي قد يتم احتساب إحالة ناجحة فيها. يجب أن تتراوح القيمة بين 0 و90 بشكل شامل.

LineItemWarningMessage

رسائل التحذير التي يتم إنشاؤها بواسطة أحد تفاصيل الإعلان. لا تمنع هذه الأنواع من التحذيرات حفظ عنصر، ولكنها قد تمنع تشغيل عنصر.

عمليات التعداد
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED غير محدد أو غير معروف.
INVALID_FLIGHT_DATES يحتوي هذا العنصر على تواريخ عرض إعلانات غير صالحة. لن يتم تشغيل العنصر.
EXPIRED يقع تاريخ انتهاء هذا العنصر في الماضي.
PENDING_FLIGHT سيبدأ تنفيذ هذا العنصر في المستقبل.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED جميع التبادلات المفعّلة للشركاء مستهدَفة سلبًا. لن يتم تشغيل العنصر.
INVALID_INVENTORY_SOURCE لا يجري استهداف أي مصادر مستودع نشطة. لن يتم تشغيل العنصر.
APP_INVENTORY_INVALID_SITE_TARGETING لا يتضمّن استهداف التطبيقات وعناوين URL لهذا العنصر أيّ تطبيقات متوافقة مع الأجهزة الجوّالة. يتطلب نوع هذا العنصر تضمين تطبيقات الأجهزة الجوّالة في استهداف قنواتك أو قائمة مواقعك الإلكترونية أو تطبيقاتك. لن يتم تشغيل العنصر.
APP_INVENTORY_INVALID_AUDIENCE_LISTS لا يستهدف هذا العنصر أيًّا من مستخدمي الأجهزة الجوّالة. يتطلب نوع هذا العنصر استهداف قائمة مستخدمين بمستخدمي الأجهزة الجوّالة. لن يتم تشغيل العنصر.
NO_VALID_CREATIVE لا يحتوي هذا العنصر على أي تصميم إعلان صالح. لن يتم تشغيل العنصر.
PARENT_INSERTION_ORDER_PAUSED طلب الإدراج لهذا العنصر متوقف مؤقتًا. لن يتم تشغيل العنصر.
PARENT_INSERTION_ORDER_EXPIRED تم تحديد تاريخ انتهاء طلب الإدراج لهذا العنصر في الماضي. لن يتم تشغيل العنصر.

MobileApp

تطبيق للأجهزة الجوّالة يتم الترويج له من خلال عنصر تثبيت تطبيق للأجهزة الجوّالة.

تمثيل JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
الحقول
appId

string

مطلوبة. رقم تعريف التطبيق الذي يقدّمه متجر المنصة.

يتم التعرّف على تطبيقات Android من خلال معرِّف الحزمة الذي يستخدمه "متجر Play" على أجهزة Android، مثل com.google.android.gm.

يتم التعرّف على تطبيقات iOS من خلال رقم تعريف تطبيق مكوَّن من تسعة أرقام يستخدمه متجر App Store من Apple، مثل 422689480.
platform

enum (Platform)

النتائج فقط. النظام الأساسي للتطبيق.
displayName

string

النتائج فقط. اسم التطبيق
publisher

string

النتائج فقط. ناشر التطبيق

النظام الأساسي

الأنظمة الأساسية المحتملة لتطبيقات الأجهزة الجوّالة.

عمليات التعداد
PLATFORM_UNSPECIFIED لم يتم تحديد النظام الأساسي.
IOS نظام التشغيل iOS.
ANDROID نظام Android الأساسي.

YoutubeAndPartnersSettings

إعدادات عناصر YouTube والشركاء

تمثيل JSON 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
الحقول
viewFrequencyCap

object (FrequencyCap)

إعدادات تحديد عدد مرات الظهور للعنصر.

يجب استخدام الحقل maxViews في عنصر الإعدادات هذا في حال تحديد حدّ أقصى محدود.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

اختياريّ. إعدادات القياس التابعة لجهة خارجية للعنصر.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

الإعدادات التي تتحكّم في المستودع الإعلاني الذي تستهدفه منصة YouTube والشركاء.
contentCategory

enum (YoutubeAndPartnersContentCategory)

نوع المحتوى الذي سيتمّ عرض إعلانات YouTube والشركاء عليه.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

النتائج فقط. تمثّل هذه السمة فئة المحتوى التي يتم تطبيقها عند عرض العنصر. عند ضبط فئة المحتوى في كلٍّ من العنصر والمعلِن، سيتم تفعيل فئة أكثر صرامة عند عرض العنصر.
targetFrequency

object (TargetFrequency)

متوسط عدد المرّات التي تريد فيها عرض إعلانات من هذا العنصر للمستخدم نفسه خلال فترة زمنية معيّنة.
linkedMerchantId

string (int64 format)

معرّف التاجر المرتبط بعنصر خلاصة المنتج
relatedVideoIds[]

string

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

string (int64 format)

رقم تعريف النموذج لاكتساب عملاء محتملين.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

الإعدادات ذات الصلة بـ VideoAdSequence.

ThirdPartyMeasurementConfigs

الإعدادات التي تتحكّم في قياسات تفاصيل الإعلانات لدى مورّدي الجهات الخارجية.

تمثيل JSON 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
الحقول
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

اختياريّ. مورّدو الجهات الخارجية الذين يقيسون إمكانية العرض

ينطبق المورّدون الخارجيون التاليون:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

اختياريّ. المورّدون التابعون لجهات خارجية الذين يقيسون أمان العلامة التجارية

ينطبق المورّدون الخارجيون التاليون:

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

اختياريّ. يقيس مورّدو الجهات الخارجية مدى الوصول.

ينطبق المورّدون الخارجيون التاليون:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

اختياريّ. مورّدو الجهات الخارجية الذين يقيسون تأثير العلامة التجارية

ينطبق المورّدون الخارجيون التاليون:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

الإعدادات التي تتحكّم في كيفية ضبط مورّدي القياس التابع لجهة خارجية.

تمثيل JSON 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
الحقول
vendor

enum (ThirdPartyVendor)

مورّد القياس التابع لطرف ثالث
placementId

string

المعرّف الذي تستخدمه النظام الأساسي للمورّد التابع لطرف ثالث لتحديد العنصر.

ThirdPartyVendor

المورّدون الذين يجرون القياس التابع لجهة خارجية

عمليات التعداد
THIRD_PARTY_VENDOR_UNSPECIFIED مورِّد تابع لجهة خارجية غير معروف.
THIRD_PARTY_VENDOR_MOAT خندق.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY إثبات الملكية.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY القياس عن بُعد:
THIRD_PARTY_VENDOR_MEETRICS كلمات المرور.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.

YoutubeAndPartnersInventorySourceConfig

الإعدادات التي تتحكّم في المستودعات ذات الصلة بمنصة YouTube التي سيستهدِفها العنصر على YouTube والشركاء.

تمثيل JSON 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
الحقول
includeYoutube

boolean

اختياريّ. ما إذا كنت تريد استهداف المستودع الإعلاني على YouTube ويشمل ذلك كلاً من البحث والقنوات والفيديوهات.
includeGoogleTv

boolean

اختياريّ. يمكنك اختيار ما إذا كنت تريد استهداف المستودع الإعلاني في تطبيقات الفيديو المتوفّرة مع Google TV.
includeYoutubeVideoPartners

boolean

ما إذا كنت تريد استهداف المستودع الإعلاني في مجموعة من المواقع الإلكترونية والتطبيقات التابعة للشركاء التي تتّبع معايير أمان العلامة التجارية نفسها المتّبعة في YouTube

YoutubeAndPartnersContentCategory

فئات أمان العلامة التجارية للمحتوى على YouTube والشركاء

عمليات التعداد
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED لم يتم تحديد فئة المحتوى أو غير معروفة في هذا الإصدار.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD يشير ذلك المصطلح إلى فئة تتألّف من مجموعة كبيرة من المحتوى المناسب لمعظم العلامات التجارية. يستند المحتوى إلى الإرشادات حول المحتوى المناسب للمعلنين في YouTube.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED فئة تشمل كل المحتوى على YouTube وشركاء الفيديو الذي يستوفي معايير تحقيق الربح.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED يشير ذلك المصطلح إلى فئة تتألّف من نطاق محدود من المحتوى يستوفي متطلبات عالية، لا سيّما في ما يتعلّق باللغة غير اللائقة والإيحاءات الجنسية.

TargetFrequency

إعداد يتحكّم في متوسط عدد مرات ظهور الإعلانات للمستخدم نفسه خلال فترة زمنية معيّنة.

تمثيل JSON 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
الحقول
targetCount

string (int64 format)

في المتوسّط، سيتم عرض الإعلانات على المستخدِم نفسه في الفترة الزمنية التي تفرضها السمة timeUnit وtimeUnitCount.
timeUnit

enum (TimeUnit)

الوحدة الزمنية التي سيتم فيها تطبيق عدد مرّات الظهور المستهدَف.

تسري الوحدة الزمنية التالية:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

عدد timeUnit الذي سيدومه عدد مرّات الظهور المستهدَف.

يتم تطبيق القيود التالية استنادًا إلى قيمة timeUnit:

  • TIME_UNIT_WEEKS - يجب أن يكون 1

VideoAdSequenceSettings

الإعدادات ذات الصلة بـ VideoAdSequence.

تمثيل JSON 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
الحقول
minimumDuration

enum (VideoAdSequenceMinimumDuration)

الحدّ الأدنى للفاصل الزمني قبل أن يرى المستخدم نفسه هذا التسلسل مرة أخرى.
steps[]

object (VideoAdSequenceStep)

الخطوات التي يتألف منها التسلسل.

VideoAdSequenceMinimumDuration

تعداد الحد الأدنى المحتمل للفاصل الزمني قبل أن يرى المستخدم نفسه VideoAdSequence مرة أخرى.

عمليات التعداد
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED الحالة غير محدّدة أو غير معروفة.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 أيام.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 يومًا.

VideoAdSequenceStep

تفاصيل خطوة واحدة في VideoAdSequence.

تمثيل JSON 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
الحقول
stepId

string (int64 format)

رقم تعريف الخطوة.
adGroupId

string (int64 format)

رقم تعريف المجموعة الإعلانية المقابلة للخطوة.
previousStepId

string (int64 format)

رقم تعريف الخطوة السابقة. لا تحتوي الخطوة الأولى على خطوة سابقة.
interactionType

enum (InteractionType)

التفاعل في الخطوة السابقة الذي سيقود المُشاهد إلى هذه الخطوة. الخطوة الأولى لا تحتوي على عناصرInteractType.

InteractionType

تمثّل هذه السمة أنواع التفاعل في الخطوة.

عمليات التعداد
INTERACTION_TYPE_UNSPECIFIED غير محدّد أو غير معروف
INTERACTION_TYPE_PAID_VIEW مشاهدة مدفوعة.
INTERACTION_TYPE_SKIP تخطّى المشاهد المحتوى.
INTERACTION_TYPE_IMPRESSION مرّة ظهور للإعلان (معروضة).
INTERACTION_TYPE_ENGAGED_IMPRESSION مرة ظهور إعلان لم يتخطّاها المشاهد على الفور، ولكن لم تصل أيضًا إلى الحدث القابل للفوترة

الطُرق

bulkEditAssignedTargetingOptions

 تعديلات مجمّعة لخيارات الاستهداف ضمن عناصر متعددة.

bulkListAssignedTargetingOptions

 يسرد خيارات الاستهداف التي تم تعيينها لعناصر متعددة عبر أنواع الاستهداف.

bulkUpdate

 تعمل على تعديل عناصر متعدّدة.

create

 ينشئ عنصرًا جديدًا.

delete

 يؤدي هذا الإجراء إلى حذف عنصر.

duplicate

 تكرار عنصر

generateDefault

 ينشئ عنصرًا جديدًا باستخدام الإعدادات (بما في ذلك الاستهداف) المكتسبة من طلب الإدراج وENTITY_STATUS_DRAFT entity_status.

get

 الحصول على عنصر.

list

 يسرد العناصر في أحد المعلِنين.

patch

 لتعديل عنصر حالي