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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
الحقول
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 والشركاء
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

تُستخدَم لتحديد ما إذا كان سيتم عرض إعلانات سياسية عن الاتحاد الأوروبي في عنصر الإعلان هذا.

إذا تم ضبط containsEuPoliticalAds على DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING في حساب المعلِن الرئيسي، سيتم تعيين القيمة DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING لهذا الحقل ما لم يتم تحديد قيمة أخرى. يمكن بعد ذلك تعديل هذا الحقل باستخدام واجهة المستخدم أو واجهة برمجة التطبيقات أو ملفات البيانات المنظَّمة.

يجب تعيين هذا الحقل عند إنشاء عنصر سطر جديد. وفي ما عدا ذلك، سيتعذّر تنفيذ طلب advertisers.lineItems.create.

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 إعلانات Over-the-top (OTT) في طلبات إدراج إعلانات 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 مقدار 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)

النسبة المئوية للإحالات الناجحة بعد رؤية الإعلان التي سيتم احتسابها، بالمللي ثانية (جزء من ألف من النسبة المئوية). يجب أن تتراوح القيمة بين 0 و100000، بما في ذلك الرقمان.

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

object (TrackingFloodlightActivityConfig)

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

عدد الإحالات الناجحة التي يتمّ احتسابها هو مجموع كلّ الإحالات الناجحة التي يتمّ احتسابها من خلال جميع أرقام تعريف أنشطة 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)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
الحقول
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
videoAdInventoryControl

object (VideoAdInventoryControl)

اختيارية: إعدادات التحكّم في المستودع الإعلاني المسموح به لهذا العنصر.

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_ZEFR
  • 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
  • THIRD_PARTY_VENDOR_NIELSEN

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.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.

YoutubeAndPartnersInventorySourceConfig

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

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

boolean

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

boolean

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

boolean

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

YoutubeAndPartnersContentCategory

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

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

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

InteractionType

أنواع التفاعل في إحدى الخطوات

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

VideoAdInventoryControl

عنصر التحكّم في مستودع إعلانات الفيديو المستخدَم في أنواع معيّنة من تفاصيل الإعلانات على YouTube

تمثيل JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
الحقول
allowInStream

boolean

اختيارية: تُستخدَم لتحديد ما إذا كان يمكن عرض الإعلانات كإعلانات أثناء عرض الفيديو.
allowInFeed

boolean

اختيارية: ما إذا كان يمكن عرض الإعلانات بتنسيق "ضمن الخلاصة"
allowShorts

boolean

اختيارية: تُستخدَم لتحديد ما إذا كان يمكن عرض الإعلانات بتنسيق فيديوهات Shorts.

الطُرق

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

 تعرض هذه السمة خيارات الاستهداف المحدّدة لبنود متعدّدة في أنواع الاستهداف المختلفة.

bulkUpdate

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

create

 تُنشئ هذه الطريقة عنصرًا جديدًا في السطر.

delete

 تحذف هذه الطريقة عنصرًا.

duplicate

 تكرِّر هذه الطريقة تفاصيل إعلان.

generateDefault

 تُنشئ هذه الطريقة عنصرًا جديدًا في الحملة يتضمّن إعدادات (بما في ذلك الاستهداف) موروثة من أمر الإدراج وENTITY_STATUS_DRAFT entity_status.

get

 تعرض هذه الطريقة تفاصيل أحد المنتجات أو الخدمات.

list

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

patch

 تعدّل هذه الطريقة عنصرًا حاليًا في خطة الإعلانات.