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)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
الحقول
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)

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

يجب استخدام الحقل 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 والمنصات الشريكة
demandGenSettings

object (DemandGenSettings)

اختياريّ. إعدادات خاصة بالبنود الإعلانية في "حملات زيادة الطلب"

لا ينطبق إلا على بنود "حملات زيادة الطلب".
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

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

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

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

boolean

اختياريّ. تحديد ما إذا كان سيتم تفعيل ميزة تحسين عروض الأسعار في "مساحة العرض والفيديو 360" للبنود الإعلانية التي تستخدم عروض أسعار ثابتة

تُحسِّن "مساحة العرض والفيديو 360" عرض السعر الثابت تلقائيًا من خلال خفض عروض الأسعار لمرّات الظهور التي من غير المرجّح أن تحقّق أداءً جيدًا. يتم تفعيل هذا التحسين تلقائيًا (القيمة هي "صحيح").

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

لا ينطبق هذا الإعداد إلا على عناصر الحملات التي تتضمّن biddingStrategy من النوع FIXED_BID.

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

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

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

"إعلانات زيادة الطلب"

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 إلا عندما يكون التخصيص التلقائي للميزانية مفعَّلاً لأمر الإدراج الرئيسي.

يجب ضبط هذا الحقل على LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED لبنود "حملات زيادة الطلب".
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)

الحقل مطلوب. نوع الترميز لنموذج إيرادات الشريك

يجب ضبط هذا الحقل على PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP لبنود "حملات زيادة الطلب".
markupAmount

string (int64 format)

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

  • عندما يتم ضبط markupType على PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM، يمثّل هذا الحقل زيادة التكلفة لكلّ ألف ظهور بالميكرو من عملة المعلِن. على سبيل المثال، يمثّل الرقم 1500000 وحدة عادية واحدة ونصف من العملة.
  • عندما يتم ضبط 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)
    }
  ],
  "primaryAttributionModelId": string
}
الحقول
postViewCountPercentageMillis

string (int64 format)

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

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

object (TrackingFloodlightActivityConfig)

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

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

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

string (int64 format)

اختياريّ. نموذج تحديد المصدر الذي سيتم استخدامه لقياس الإحالات الناجحة. سيحدّد نموذج تحديد المصدر هذا طريقة احتساب الإحالات الناجحة. يمكنك ضبط "النموذج الأساسي" لإعدادات أو مجموعة 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)

اختياريّ. رقم تعريف حساب Merchant Center المستخدَم لتقديم خلاصة منتجات

يجب أن يكون حساب Merchant Center هذا مرتبطًا بالمعلِن.
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
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

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

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

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_MACROMILL

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.
THIRD_PARTY_VENDOR_ORIGIN للمصدر.
THIRD_PARTY_VENDOR_GEMIUS Gemius
THIRD_PARTY_VENDOR_MEDIA_SCOPE ‫MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT مشروع الجمهور
THIRD_PARTY_VENDOR_VIDEO_AMP Video Amp.
THIRD_PARTY_VENDOR_ISPOT_TV Ispot TV
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research

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 مرّة ظهور إعلان لم يتخطّاها المشاهد على الفور، ولكنّها لم تصل إلى الحدث القابل للفوترة أيضًا.

VideoAdInventoryControl

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

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

boolean

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

boolean

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

boolean

اختياريّ. ما إذا كان يمكن عرض الإعلانات بتنسيق Shorts
allowNonSkippableInStream

boolean

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

DemandGenSettings

إعدادات بنود "حملات زيادة الطلب"

تمثيل JSON 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
الحقول
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

اختياريّ. إعدادات القياس التابع لجهة خارجية في تفاصيل عنصر "حملة زيادة الطلب"
linkedMerchantId

string (int64 format)

اختياريّ. رقم تعريف حساب Merchant Center المستخدَم لتقديم خلاصة منتجات

يجب أن يكون حساب Merchant Center هذا مرتبطًا بالمعلِن.
geoLanguageTargetingEnabled

boolean

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

الطُرق

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

 تنشئ هذه الطريقة بندًا إعلانيًا جديدًا.

delete

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

duplicate

 تكرِّر هذه السمة بندًا في فاتورة.

get

 تعرض هذه الطريقة بندًا إعلانيًا.

list

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

patch

 تعديل بند إعلان حالي