REST Resource: advertisers.lineItems

المورد: LineItem

عنصر سطر واحد

تمثيل 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)

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

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
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

يحدّد هذا الخيار ما إذا كان سيتم استبعاد عمليات الصرف الجديدة من الاستهداف التلقائي من خلال العنصر. تكون قيمة هذا الحقل false تلقائيًا.
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 إعلانات الصوت المستندة إلى عروض الأسعار في الوقت الفعلي التي يتم بيعها لمجموعة متنوعة من البيئات
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP الإعلانات التي تظهر على خدمات البث المباشر على الإنترنت (OTT) في طلبات إدراج الإعلانات على خدمات البث المباشر على الإنترنت لا ينطبق هذا النوع إلا على العناصر التي يكون طلب إدراجها هو 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 وحدة عادية واحدة من العملة.
    • 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/1, 000 من النسبة المئوية) يجب أن تتراوح القيمة بين 0 و100000، بما في ذلك هذان الرقمان.

على سبيل المثال، لتتبُّع% 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 من خلال معرّف تطبيق مكوّن من تسعة أرقام يستخدمه متجر التطبيقات في 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 Moat
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science
THIRD_PARTY_VENDOR_COMSCORE Comscore
THIRD_PARTY_VENDOR_TELEMETRY بيانات القياس عن بُعد
THIRD_PARTY_VENDOR_MEETRICS 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

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

عمليات التعداد
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)

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

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

 تعديل سلعة حالية