- المورد: LineItem
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- LineItemWarningMessage
- MobileApp
- المنصة
- YoutubeAndPartnersSettings
- ThirdPartyMeasurementConfigs
- ThirdPartyVendorConfig
- ThirdPartyVendor
- YoutubeAndPartnersInventorySourceConfig
- YoutubeAndPartnersContentCategory
- TargetFrequency
- RelatedVideo
- VideoAdSequenceSettings
- VideoAdSequenceMinimumDuration
- VideoAdSequenceStep
- InteractionType
- VideoAdInventoryControl
- DemandGenSettings
- الطُرق
المورد: LineItem
تمثّل هذه السمة بندًا إعلانيًا واحدًا.
| تمثيل JSON |
|---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
| الحقول | |
|---|---|
name |
للعرض فقط. اسم مورد البند الإعلاني. |
advertiserId |
للعرض فقط. المعرّف الفريد للمعلِن الذي ينتمي إليه البند الإعلاني |
campaignId |
للعرض فقط. المعرّف الفريد للحملة التي ينتمي إليها البند الإعلاني |
insertionOrderId |
الحقل مطلوب. غير قابل للتغيير المعرّف الفريد لطلب الإدراج الذي ينتمي إليه البند الإعلاني |
lineItemId |
للعرض فقط. المعرّف الفريد للبند الإعلاني. يتم تخصيصه من قِبل النظام. |
displayName |
الحقل مطلوب. الاسم المعروض للبند الإعلاني يجب أن يكون بترميز UTF-8 وبحدّ أقصى 240 بايت. |
lineItemType |
الحقل مطلوب. غير قابل للتغيير نوع البند الإعلاني. |
entityStatus |
الحقل مطلوب. يتحكّم هذا الإعداد في ما إذا كان بإمكان البند الإعلاني إنفاق ميزانيته وتقديم عروض أسعار للمساحة الإعلانية المتاحة أم لا.
|
updateTime |
للعرض فقط. الطابع الزمني لآخر تعديل على البند الإعلاني يتم تخصيصه من قِبل النظام. يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
partnerCosts[] |
تكاليف الشريك المرتبطة بالعنصر في حال عدم توفّر هذه السمة أو كانت فارغة في طريقة |
flight |
الحقل مطلوب. وقت بدء عرض الإعلان وانتهائه في تفاصيل الإعلان |
budget |
الحقل مطلوب. إعدادات تخصيص الميزانية في البند الإعلاني |
pacing |
الحقل مطلوب. إعداد سرعة إنفاق الميزانية للبند الإعلاني |
frequencyCap |
اختيارية: مطلوبة إذا لم يكن نوع البند الإعلاني يجب استخدام الحقل |
partnerRevenueModel |
الحقل مطلوب. إعداد نموذج إيرادات الشريك للبند الإعلاني |
conversionCounting |
إعداد تتبُّع الإحالات الناجحة للبند الإعلاني |
creativeIds[] |
أرقام تعريف تصاميم الإعلانات المرتبطة بالعنصر. |
bidStrategy |
الحقل مطلوب. استراتيجية عروض الأسعار الخاصة بالعنصر. |
integrationDetails |
تفاصيل دمج البند الإعلاني |
targetingExpansion |
إعدادات الاستهداف المحسّن للبند الإعلاني لا تنطبق هذه الإعدادات إلا على البنود الإعلانية الصورية أو بنود إعلانات الفيديو أو البنود الإعلانية الصوتية التي تستخدم عروض الأسعار المبرمَجة وتستهدف بشكل إيجابي قوائم المستخدمين المؤهَّلة. |
warningMessages[] |
للعرض فقط. رسائل التحذير التي تم إنشاؤها بواسطة تفاصيل الإعلان لا تمنع هذه التحذيرات حفظ البند الإعلاني، ولكن قد يمنع بعضها تشغيل البند الإعلاني. |
mobileApp |
التطبيق المتوافق مع الأجهزة الجوّالة الذي يروّج له البند الإعلاني لا ينطبق ذلك إلا عندما تكون قيمة |
reservationType |
للعرض فقط. نوع الحجز الخاص بالعنصر. |
excludeNewExchanges |
ما إذا كنت تريد استبعاد منصات التبادل الإعلاني الجديدة من الاستهداف تلقائيًا بواسطة العنصر. تكون قيمة هذا الحقل false تلقائيًا. |
youtubeAndPartnersSettings |
اختيارية: الإعدادات الخاصة بالبنود الإعلانية على YouTube والشركاء |
demandGenSettings |
اختيارية: الإعدادات الخاصة ببنود حملات زيادة الطلب ينطبق ذلك على البنود الإعلانية لحملات زيادة الطلب فقط. |
containsEuPoliticalAds |
ما إذا كان هذا العنصر سيعرض إعلانات سياسية عن الاتحاد الأوروبي إذا تم ضبط السمة يجب تحديد هذا الحقل عند إنشاء تفاصيل إعلان جديد. وإلا، سيتعذّر تنفيذ طلب |
optimizeFixedBidding |
اختيارية: ما إذا كان سيتم تفعيل تحسين عروض الأسعار في "مساحة العرض والفيديو 360" لبنود عروض الأسعار الثابتة بشكلٍ تلقائي، تعمل "مساحة العرض والفيديو 360" على تحسين عرض السعر الثابت من خلال خفض عروض الأسعار تلقائيًا لمرّات الظهور التي يقلّ احتمال تحقيقها لأداء جيد. يتم تفعيل هذا التحسين تلقائيًا (القيمة هي true). عند ضبط هذا الحقل على لا ينطبق هذا الإعداد إلا على بنود/أسطر تتضمّن |
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 |
الإعلانات التي تظهر على سطح الفيديو في طلبات الإدراج على سطح الفيديو لا ينطبق هذا النوع إلا على البنود الإعلانية التي تتضمّن طلب إدراج من النوع 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 ( |
| الحقول | |
|---|---|
flightDateType |
الحقل مطلوب. نوع تواريخ عرض الإعلانات للبند الإعلاني |
dateRange |
تاريخا بدء عرض البند الإعلاني وانتهائه ويتم حلّها وفقًا للمنطقة الزمنية للمعلِن الرئيسي.
|
LineItemFlightDateType
الأنواع المحتملة لتواريخ عرض الإعلانات في بند إعلاني
| عمليات التعداد | |
|---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
لم يتم تحديد قيمة النوع أو أنّها غير معروفة في هذا الإصدار. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
يتم اكتساب تواريخ عرض البند الإعلاني من طلب الإدراج الرئيسي. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
يستخدم البند الإعلاني تواريخ توقيت عرض إعلانات مخصّصة خاصة به. |
LineItemBudget
الإعدادات التي تتحكّم في كيفية تخصيص الميزانية
| تمثيل JSON |
|---|
{ "budgetAllocationType": enum ( |
| الحقول | |
|---|---|
budgetAllocationType |
الحقل مطلوب. نوع تخصيص الميزانية لا ينطبق الحقل يجب ضبط هذا الحقل على |
budgetUnit |
للعرض فقط. تحدّد وحدة الميزانية ما إذا كانت الميزانية مستندة إلى العملة أو إلى مرّات الظهور. يتم اكتساب هذه القيمة من طلب الإدراج الرئيسي. |
maxAmount |
الحدّ الأقصى لمبلغ الميزانية الذي سينفقه البند الإعلاني. يجب أن تكون القيمة أكبر من 0. عندما تكون قيمة الحقل "
|
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 ( |
| الحقول | |
|---|---|
markupType |
الحقل مطلوب. نوع الترميز لنموذج إيرادات الشريك يجب ضبط هذا الحقل على |
markupAmount |
الحقل مطلوب. يشير هذا إلى مبلغ الزيادة في نموذج إيرادات الشريك. يجب أن تكون القيمة أكبر من أو تساوي 0.
|
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 ( |
| الحقول | |
|---|---|
postViewCountPercentageMillis |
النسبة المئوية للإحالات الناجحة بعد رؤية الإعلان التي سيتم احتسابها، بالمللي ثانية (1/1000 من النسبة المئوية). يجب أن تتراوح القيمة بين 0 و100,000 (بما فيها هذان الرقمان). على سبيل المثال، لتتبُّع% 50 من الإحالات الناجحة بعد النقر، اضبط القيمة على 50000. |
floodlightActivityConfigs[] |
إعدادات أنشطة Floodlight المستخدَمة لتتبُّع الإحالات الناجحة عدد الإحالات الناجحة المحسوبة هو مجموع كل الإحالات الناجحة التي تم احتسابها من خلال جميع أرقام تعريف أنشطة Floodlight المحدّدة في هذا الحقل. لا يمكن تعديل هذا الحقل إذا تمّ تحديد خوارزمية عروض أسعار مخصّصة للعنصر. إذا ضبطت هذا الحقل وعيّنت خوارزمية عروض أسعار مخصّصة في الطلب نفسه، يجب أن تتطابق أنشطة Floodlight مع الأنشطة التي تستخدمها خوارزمية عروض الأسعار المخصّصة. |
primaryAttributionModelId |
اختيارية: نموذج تحديد المصدر الذي يجب استخدامه لقياس الإحالات الناجحة سيحدّد نموذج تحديد المصدر هذا كيفية احتساب الإحالات الناجحة. يمكنك ضبط النموذج الأساسي لإعدادات Floodlight أو مجموعة معيّنة. مزيد من التفاصيل ينطبق ذلك على البنود الإعلانية لحملات زيادة الطلب فقط. |
TrackingFloodlightActivityConfig
الإعدادات التي تتحكّم في سلوك إعداد نشاط Floodlight واحد
| تمثيل JSON |
|---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
| الحقول | |
|---|---|
floodlightActivityId |
الحقل مطلوب. رقم تعريف نشاط Floodlight |
postClickLookbackWindowDays |
الحقل مطلوب. عدد الأيام اللاحقة للنقر على الإعلان والتي يمكن خلالها احتساب إحالة ناجحة. يجب أن تتراوح القيمة بين 0 و90 (بما فيها هذان الرقمان). |
postViewLookbackWindowDays |
الحقل مطلوب. عدد الأيام اللاحقة لمشاهدة الإعلان والتي يمكن خلالها احتساب إحالة ناجحة. يجب أن تتراوح القيمة بين 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 ( |
| الحقول | |
|---|---|
appId |
الحقل مطلوب. رقم تعريف التطبيق الذي يوفّره متجر المنصة يتم تحديد تطبيقات Android من خلال معرّف الحزمة الذي يستخدمه "متجر Google Play" على Android، مثل يتم تحديد تطبيقات iOS من خلال معرّف تطبيق مكوّن من تسعة أرقام يستخدمه متجر التطبيقات من Apple، مثل |
platform |
للعرض فقط. النظام الأساسي للتطبيق |
displayName |
للعرض فقط. اسم التطبيق |
publisher |
للعرض فقط. ناشر التطبيق |
النظام الأساسي
منصات تطبيقات الأجهزة الجوّالة المحتملة
| عمليات التعداد | |
|---|---|
PLATFORM_UNSPECIFIED |
لم يتم تحديد المنصة. |
IOS |
نظام iOS الأساسي |
ANDROID |
نظام Android الأساسي |
YoutubeAndPartnersSettings
إعدادات البنود الإعلانية في YouTube والشركاء
| تمثيل JSON |
|---|
{ "viewFrequencyCap": { object ( |
| الحقول | |
|---|---|
viewFrequencyCap |
إعدادات الحدّ الأقصى لعدد مرّات المشاهدة في البند الإعلاني يجب استخدام الحقل |
thirdPartyMeasurementConfigs |
اختيارية: إعدادات خدمة القياس الخارجية في البند الإعلاني |
inventorySourceSettings |
الإعدادات التي تتحكّم في المساحات الإعلانية المتاحة التي سيستهدفها البند الإعلاني في YouTube والشركاء. |
contentCategory |
للعرض فقط. نوع المحتوى الذي ستظهر عليه الإعلانات على YouTube والشركاء. |
effectiveContentCategory |
للعرض فقط. فئة المحتوى التي تسري عند عرض تفاصيل الإعلان عند ضبط فئة المحتوى في كلّ من تفاصيل الإعلان والمعلِن، سيتم تطبيق الفئة الأكثر صرامة عند عرض تفاصيل الإعلان. وستكتسب البنود الإعلانية الجديدة الإعداد على مستوى المعلِن فقط. |
targetFrequency |
اختيارية: متوسط عدد المرات التي تريد فيها عرض إعلانات من هذا العنصر للمستخدم نفسه على مدار فترة زمنية معيّنة. |
linkedMerchantId |
اختيارية: رقم تعريف حساب Merchant Center المستخدَم لتقديم خلاصة منتجات يجب أن يكون حساب Merchant Center هذا مرتبطًا بحساب المعلِن. |
relatedVideos[] |
اختيارية: الفيديوهات ذات الصلة بالبند الإعلاني ستظهر هذه الفيديوهات أسفل إعلان الفيديو الأساسي عند تشغيله في تطبيق YouTube على الأجهزة الجوّالة. |
leadFormId |
اختيارية: رقم تعريف النموذج لجذب العملاء المحتملين |
videoAdSequenceSettings |
اختيارية: الإعدادات ذات الصلة بـ VideoAdSequence. |
videoAdInventoryControl |
اختيارية: الإعدادات التي تتحكّم في المساحة الإعلانية المسموح بها لهذا البند الإعلاني. |
ThirdPartyMeasurementConfigs
الإعدادات التي تتحكّم في مقاييس البنود الإعلانية المحدّدة التي يقيسها مزوّدو الخدمات الخارجيون.
| تمثيل JSON |
|---|
{ "viewabilityVendorConfigs": [ { object ( |
| الحقول | |
|---|---|
viewabilityVendorConfigs[] |
اختيارية: مزوّدو الخدمات الخارجيون الذين يقيسون إمكانية العرض ينطبق ذلك على مقدّمي الخدمات الخارجيين التاليين:
|
brandSafetyVendorConfigs[] |
اختيارية: مزوّدو الخدمات الخارجيون الذين يقيسون أمان العلامة التجارية ينطبق ذلك على مقدّمي الخدمات الخارجيين التاليين:
|
reachVendorConfigs[] |
اختيارية: مزوّدو الخدمات الخارجيون الذين يقيسون مدى الوصول إلى الجمهور ينطبق ذلك على مزوّدي الخدمات الخارجيين التاليين:
|
brandLiftVendorConfigs[] |
اختيارية: مزوّدو الخدمات الخارجيون الذين يقيسون تأثير العلامة التجارية ينطبق ذلك على مقدّمي الخدمات الخارجيين التاليين:
|
ThirdPartyVendorConfig
الإعدادات التي تتحكّم في كيفية ضبط مورّدي خدمة القياس الخارجية
| تمثيل JSON |
|---|
{
"vendor": enum ( |
| الحقول | |
|---|---|
vendor |
مورّد خدمة القياس الخارجية |
placementId |
المعرّف الذي تستخدمه منصة مزوّد الخدمة الخارجي لتحديد البند الإعلاني |
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 |
Audience Project: |
THIRD_PARTY_VENDOR_VIDEO_AMP |
VideoAmp |
THIRD_PARTY_VENDOR_ISPOT_TV |
iSpot.tv |
THIRD_PARTY_VENDOR_INTAGE |
Intage. |
THIRD_PARTY_VENDOR_MACROMILL |
Macromill. |
THIRD_PARTY_VENDOR_VIDEO_RESEARCH |
Video Research: |
THIRD_PARTY_VENDOR_AQUILA |
Aquila. |
YoutubeAndPartnersInventorySourceConfig
الإعدادات التي تتحكّم في المساحات الإعلانية المتاحة ذات الصلة بمنصة YouTube التي سيستهدفها العنصر في YouTube والشركاء.
| تمثيل JSON |
|---|
{ "includeYoutube": boolean, "includeGoogleTv": boolean, "includeYoutubeVideoPartners": boolean } |
| الحقول | |
|---|---|
includeYoutube |
اختيارية: ما إذا كان سيتم استهداف المساحات الإعلانية على YouTube ويشمل ذلك البحث والقنوات والفيديوهات. |
includeGoogleTv |
اختيارية: ما إذا كنت تريد استهداف المساحات الإعلانية المتاحة في تطبيقات الفيديو المتوافقة مع Google TV |
includeYoutubeVideoPartners |
ما إذا كنت تريد استهداف المساحات الإعلانية المتاحة على مجموعة من المواقع الإلكترونية والتطبيقات التابعة للشركاء والتي تتّبع معايير أمان العلامة التجارية نفسها المتّبعة في 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 ( |
| الحقول | |
|---|---|
targetCount |
العدد المستهدَف لمرّات ظهور الإعلانات في المتوسط للشخص نفسه في الفترة الزمنية التي تحدّدها السمتان |
timeUnit |
الوحدة الزمنية التي سيتم تطبيق عدد مرّات الظهور المستهدَف فيها. تنطبق وحدة الوقت التالية:
|
timeUnitCount |
عدد تنطبق القيود التالية استنادًا إلى قيمة
|
RelatedVideo
تمثّل هذه السمة إدخال فيديو ذي صلة.
| تمثيل JSON |
|---|
{ "videoId": string, "videoAssetId": string } |
| الحقول | |
|---|---|
videoId |
للعرض فقط. معرّف الفيديو على YouTube للفيديو ذي الصلة |
videoAssetId |
الحقل مطلوب. |
VideoAdSequenceSettings
الإعدادات ذات الصلة بـ VideoAdSequence
| تمثيل JSON |
|---|
{ "minimumDuration": enum ( |
| الحقول | |
|---|---|
minimumDuration |
الحد الأدنى للفاصل الزمني قبل أن يرى المستخدم نفسه هذا التسلسل مرة أخرى. |
steps[] |
الخطوات التي يتألف منها التسلسل |
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 ( |
| الحقول | |
|---|---|
stepId |
رقم تعريف الخطوة |
adGroupId |
رقم تعريف المجموعة الإعلانية المقابلة للخطوة |
previousStepId |
رقم تعريف الخطوة السابقة لا تتضمّن الخطوة الأولى خطوة سابقة. |
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 |
اختيارية: ما إذا كان يمكن عرض الإعلانات على شكل "إعلانات أثناء عرض الفيديو" |
allowInFeed |
اختيارية: ما إذا كان يمكن عرض الإعلانات على شكل "إعلانات ضمن الخلاصة" |
allowShorts |
اختيارية: ما إذا كان يمكن عرض الإعلانات على شكل إعلانات Shorts |
allowNonSkippableInStream |
اختيارية: يشير هذا الحقل إلى ما إذا كان يمكن عرض الإعلانات على شكل "إعلانات غير قابلة للتخطّي أثناء عرض الفيديو". |
DemandGenSettings
إعدادات البنود الإعلانية لحملات زيادة الطلب
| تمثيل JSON |
|---|
{
"thirdPartyMeasurementConfigs": {
object ( |
| الحقول | |
|---|---|
thirdPartyMeasurementConfigs |
اختيارية: إعدادات القياس التابع لجهة خارجية في البند الإعلاني لحملة زيادة الطلب |
linkedMerchantId |
اختيارية: رقم تعريف حساب Merchant Center المستخدَم لتقديم خلاصة منتجات يجب أن يكون حساب Merchant Center هذا مرتبطًا بحساب المعلِن. |
geoLanguageTargetingEnabled |
اختيارية: غير قابل للتغيير ما إذا كان يمكن ضبط الاستهداف حسب الموقع الجغرافي واستهداف اللغة على مستوى البند الإعلاني. وإلا، يجب تعيين أنواع الاستهداف ذات الصلة مباشرةً إلى المجموعات الإعلانية. |
الطُرق |
|
|---|---|
|
تعديلات مجمّعة لخيارات الاستهداف ضمن تفاصيل إعلانات متعددة |
|
تعرض هذه القائمة خيارات الاستهداف المحدّدة لعدة بنود إعلانية على مستوى أنواع الاستهداف. |
|
تعديل بنود متعددة |
|
تنشئ هذه الطريقة بندًا إعلانيًا جديدًا. |
|
لحذف بند إعلاني |
|
تكرار بند إعلاني |
|
للحصول على تفاصيل بند إعلاني |
|
تعرض هذه الطريقة تفاصيل الإعلانات لدى معلِن معيّن. |
|
تعديلات على بند إعلاني حالي |