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 مقدار 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)
    }
  ],
  "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

تعداد الحدّ الأدنى المحتمل لفاصل الوقت قبل أن يرى المستخدِم نفسه 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

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

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

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