- المورد: CuratedPackage
- الولاية
- AccessControlSettings
- PackageTargeting
- DeviceType
- البيئة
- CreativeFormat
- AcceleratedMobilePageType
- AuthorizedSellerStatus
- NativeInventoryType
- OpenMeasurementType
- RestrictedCategory
- RewardedType
- PackageVideoTargeting
- VideoMimeType
- MaximumVideoAdDuration
- PositionType
- ContentDeliveryMethod
- VideoPlcmtTargeting
- SelectionType
- VideoPlcmtType
- PlaybackMethod
- VideoPlayerSizeTargeting
- StringTargetingDimension
- AdSize
- النوع
- CriteriaTargeting
- PackagePlacementTargeting
- PackagePublisherProvidedSignalsTargeting
- TaxonomyTargeting
- CurationFeeVisibility
- الطُرق
المورد: CuratedPackage
تمثّل حزمة منتقاة من المساحات الإعلانية التي أنشأها أحد "المنسّقين" ويديرها.
| تمثيل JSON |
|---|
{ "name": string, "displayName": string, "description": string, "createTime": string, "updateTime": string, "floorPriceCpm": { object ( |
| الحقول | |
|---|---|
name |
المعرّف. اسم المورد الفريد للحزمة المنظَّمة التنسيق: |
displayName |
الحقل مطلوب. الاسم المعروض الذي حدّده المنسّق للحزمة المنظَّمة يمكن استخدام هذه المَعلمة لفلترة استجابة طريقة |
description |
اختيارية: وصف للحزمة المنظَّمة يقدّمه المنظِّم |
createTime |
النتائج فقط. الطابع الزمني لوقت إنشاء الحزمة المنظَّمة يمكن استخدام هذه المَعلمة لفلترة استجابة طريقة يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
updateTime |
النتائج فقط. الطابع الزمني لآخر تعديل على الحزمة المنظَّمة يمكن استخدام هذه المَعلمة لفلترة استجابة طريقة يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
floorPriceCpm |
اختيارية: الحدّ الأدنى للتكلفة لكل ألف ظهور الذي يجب أن يقدّمه المشتري للمشاركة في مزادات المساحات الإعلانية المتاحة في هذه الحزمة المنظَّمة. يمكن استخدامها لفلترة استجابة طريقة |
state |
النتائج فقط. حالة الحزمة المنظَّمة يمكن استخدامها لفلترة استجابة طريقة |
accessSettings |
الحقل مطلوب. إعدادات للتحكّم في الوصول إلى الحزمة المنظَّمة يقتصر الوصول إلى هذه الحزمة المنظَّمة على منسّقي وسائط الإعلان المدرَجين في القائمة المسموح بها وصانع المحتوى. لا يمكن إدراج المشترين ومقدّمي عروض الأسعار في القائمة المسموح بها لهذا المورد أو منحهم إمكانية الوصول المباشر إليه. |
targeting |
اختيارية: معايير الاستهداف للحزمة المنظَّمة |
curationFeeVisibility |
اختيارية: غير قابل للتغيير إمكانية ظهور رسوم حزمة التنسيق المجمّعة ورسوم شرائح البيانات (إجمالي رسوم التنسيق) |
| الرسوم المدفوعة للمنسّق مقابل هذه الحزمة. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد: | |
feeCpm |
اختيارية: رسوم التكلفة لكل ألف ظهور التي يفرضها المنظِّم على المشترين الذين يستخدمون هذه الحزمة المنظَّمة. يمكن استخدام هذه المَعلمة لفلترة استجابة طريقة |
millipercentOfMediaFee |
اختيارية: سيتم تحصيل الرسوم كنسبة مئوية من تكلفة الظهور، ويتم تمثيلها بالنسبة المئوية من الألف. على سبيل المثال، يتم تمثيل %1 على النحو التالي: 1000. |
| نهاية الحقول التي يستبعد كلّ منها الآخر | |
ولاية
حالة الحزمة المنظَّمة
| عمليات التعداد | |
|---|---|
STATE_UNSPECIFIED |
القيمة التلقائية |
ACTIVE |
الحزمة المنظَّمة نشطة. |
INACTIVE |
الحزمة المنظَّمة غير نشطة. |
AccessControlSettings
إعدادات للتحكّم في الوصول إلى حزمة منظَّمة
| تمثيل JSON |
|---|
{ "allowlistedMediaPlanners": [ string ] } |
| الحقول | |
|---|---|
allowlistedMediaPlanners[] |
الحقل مطلوب. غير قابل للتغيير قائمة منسّقي وسائط الإعلان الذين تم منحهم صراحةً إذن الوصول إلى الحزمة المنظَّمة يمكن العثور على منسقي وسائط الإعلان المؤهَّلين في طريقة التنسيق: |
PackageTargeting
معايير الاستهداف للحزم المنظَّمة وحزم المزادات
| تمثيل JSON |
|---|
{ "includedDeviceTypes": [ enum ( |
| الحقول | |
|---|---|
includedDeviceTypes[] |
اختيارية: قائمة أنواع الأجهزة المضمّنة التي تريد استهدافها إذا كان الحقل فارغًا، يتم استهداف جميع أنواع الأجهزة. |
includedEnvironment |
اختيارية: البيئة المستهدَفة في حال عدم تحديدها، يتم استهداف جميع البيئات. |
includedCreativeFormat |
اختيارية: تنسيق تصميم الإعلان المطلوب استهدافه في حال عدم ضبطها، يتم استهداف جميع أنواع ترميز تصاميم الإعلانات. |
includedAcceleratedMobilePageType |
اختيارية: نوع الصفحة السريعة التحميل والمتوافقة مع الأجهزة الجوّالة المستهدَفة في حال عدم ضبط هذا الإعداد، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن حالة AMP. |
includedAuthorizedSellerStatuses[] |
اختيارية: قائمة حالات البائعين المعتمَدين المستهدَفين المضمّنة إذا كان الحقل فارغًا، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن حالة البائع. |
includedNativeInventoryTypes[] |
اختيارية: أنواع المساحات الإعلانية المدمجة مع المحتوى المستهدَفة إذا كان هذا الحقل فارغًا، سيتم استهداف المساحة الإعلانية بغض النظر عن نوع المساحة الإعلانية المخصّصة للإعلانات المدمجة مع المحتوى. |
includedOpenMeasurementTypes[] |
اختيارية: قائمة بأنواع القياس المفتوح المستهدَفة إذا كان هذا الحقل فارغًا، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن توافقها مع Open Measurement. |
includedRestrictedCategories[] |
اختيارية: قائمة الفئات المستهدَفة الخاضعة لقيود إذا كان الحقل فارغًا، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن الفئات الخاضعة لقيود. |
includedRewardedType |
اختيارية: نوع الإعلان المستهدَف الذي يضم مكافأة في حال عدم ضبط هذا الإعداد، سيتم استهداف المساحات الإعلانية بغض النظر عن نوع الإعلان الذي يضم مكافأة. |
videoTargeting |
اختيارية: معايير الاستهداف الخاصة بالفيديو |
minimumPredictedViewabilityPercentage |
اختيارية: الحد الأدنى المستهدف للنسبة المئوية المتوقّعة لإمكانية العرض يجب أن تكون هذه القيمة من مضاعفات العدد 10 بين 10 و90 (بما يشمل هذين الرقمَين). على سبيل المثال، الرقم 10 صالح، ولكن الأرقام 0 و15 و100 غير صالحة. وتعني القيمة 10 أنّ الإعدادات ستطابق فقط الخانات الإعلانية التي نتوقّع أن تبلغ نسبة إمكانية عرضها %10 على الأقل. تشير القيمة غير المحدّدة إلى أنّه سيتم استهداف المساحة الإعلانية بغض النظر عن إمكانية العرض المتوقّعة. |
languageTargeting |
اختيارية: اللغات المطلوب استهدافها في حال عدم ضبطها، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن اللغة. يُرجى الاطّلاع على https://developers.google.com/google-ads/api/data/codes-formats#languages للحصول على قائمة برموز اللغات المتاحة. |
includedAdSizes[] |
اختيارية: قائمة أحجام الإعلانات المطلوب استهدافها في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن حجم الإعلان. تتيح الحزم المنظَّمة استخدام حجمَي الإعلانات |
publisherTargeting |
اختيارية: الناشرون المستهدَفون في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن الناشر. يتم تحديد الناشرين من خلال الرقم التعريفي للناشر من ملف ads.txt أو app-ads.txt. لمزيد من التفاصيل، يُرجى الاطّلاع على https://iabtechlab.com/ads-txt/ وhttps://iabtechlab.com/app-ads-txt/. |
minimumPredictedClickThroughRatePercentageMillis |
اختيارية: الحد الأدنى المستهدَف لمعدّل النقر المتوقّع، وتتراوح قيمه بين [10 و10,000] (من %0.01 إلى %10). وتعني القيمة 50 أنّ الإعدادات ستطابق فقط الخانات الإعلانية التي نتوقّع أن تحقّق نسبة نقر إلى ظهور لا تقلّ عن %0.05. تشير القيمة غير المحدّدة إلى أنّه سيتم استهداف المساحة الإعلانية بغض النظر عن معدّل النقر المتوقّع. |
verticalTargeting |
اختيارية: المجالات المضمّنة أو المستبعدة كما هو محدّد في https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن المجال. |
geoTargeting |
اختيارية: أرقام تعريف المعايير الجغرافية التي سيتم تضمينها أو استبعادها كما هو محدّد في https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. في حال عدم ضبطها، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن الموقع الجغرافي. |
includedDataSegments[] |
اختيارية: شرائح البيانات النشطة المطلوب استهدافها في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن شرائح البيانات. التنسيق: |
placementTargeting |
اختيارية: معلومات استهداف مواضع الإعلان، مثل عنوان URL وتطبيقات الأجهزة الجوّالة |
publisherProvidedSignalsTargeting |
اختيارية: الإشارات المقدَّمة من الناشر التي يجب استهدافها في حال عدم ضبط هذا الخيار، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن الإشارات المقدَّمة من الناشر. |
DeviceType
النوع العام للجهاز الذي تريد استهدافه
| عمليات التعداد | |
|---|---|
DEVICE_TYPE_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
DEVICE_TYPE_PERSONAL_COMPUTER |
يستهدف أجهزة الكمبيوتر المكتبية أو أجهزة الكمبيوتر المحمولة. |
DEVICE_TYPE_CONNECTED_TV |
يستهدف أجهزة التلفزيون المتّصلة: الأجهزة التي تبث محتوى التلفزيون، بما في ذلك أجهزة التلفزيون الذكية ووحدات تحكّم الألعاب وأجهزة الاستقبال/أجهزة البث الصغيرة. |
DEVICE_TYPE_PHONE |
يستهدف الهواتف الجوالة المتقدمة. |
DEVICE_TYPE_TABLET |
يستهدف الأجهزة اللوحية. |
البيئة
البيئة المستهدَفة
| عمليات التعداد | |
|---|---|
ENVIRONMENT_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
ENVIRONMENT_SITE |
يستهدف هذا الخيار المساحات الإعلانية المتاحة التي يتم عرضها ضمن موقع إلكتروني يعرض الإعلانات. |
ENVIRONMENT_APP |
يستهدف هذا الخيار المساحات الإعلانية المتاحة داخل تطبيق للأجهزة الجوّالة. |
CreativeFormat
تنسيق تصميم الإعلان الذي يمكن استهدافه
| عمليات التعداد | |
|---|---|
CREATIVE_FORMAT_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
CREATIVE_FORMAT_DISPLAY |
يستهدف الخانات الإعلانية المخصّصة لتصاميم الإعلانات الصورية بتنسيق HTML. |
CREATIVE_FORMAT_VIDEO |
يستهدف الخانات الإعلانية المخصّصة لتصاميم إعلانات الفيديو. |
CREATIVE_FORMAT_AUDIO |
يستهدف الخانات الإعلانية المخصّصة للمواد الإبداعية الصوتية. |
AcceleratedMobilePageType
نوع تنفيذ Accelerated Mobile Pages (AMP) المطلوب استهدافه
| عمليات التعداد | |
|---|---|
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP |
يستهدف هذا الخيار المساحات الإعلانية المتاحة على صفحات الويب العادية التي لا تستخدم أي إطار عمل AMP. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP |
يستهدف هذا الخيار المساحات الإعلانية المتاحة على الصفحات التي تم إنشاؤها باستخدام إطار عمل HTML الأساسي لصفحات AMP. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY |
يستهدف هذا الخيار المساحات الإعلانية المتاحة على الصفحات التي تستخدم تنسيق "سجلّ AMP" (STAMP)، والذي تم تحسينه لسرد القصص المرئية (مثل تجارب ملء الشاشة القابلة للنقر). |
AuthorizedSellerStatus
تمثّل العلاقة بين الناشر والبائع كما هو موضّح في ملف ads.txt أو app-ads.txt.
| عمليات التعداد | |
|---|---|
AUTHORIZED_SELLER_STATUS_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
AUTHORIZED_SELLER_STATUS_DIRECT |
يستهدف المساحات الإعلانية التي تم فيها تحديد البائع على أنّه "مباشر". يشير ذلك إلى أنّ الناشر (مالك المحتوى) يتحكّم مباشرةً في حساب البائع، وأنّه أبرم عقدًا تجاريًا مباشرًا مع النظام الإعلاني لهذا الحساب. |
AUTHORIZED_SELLER_STATUS_RESELLER |
يستهدف هذا الخيار المساحة الإعلانية التي يتم فيها تحديد البائع على أنّه "مورّد". يشير ذلك إلى أنّ الناشر قد فوَّض جهة أخرى لتشغيل حساب البائع المُدرَج وإعادة بيع مساحته الإعلانية. |
NativeInventoryType
تمثّل نوع عرض تصميم الإعلان الذي تتيحه خانة إعلانية، وتحديدًا في ما يتعلّق بـ "الإعلانات المدمجة مع المحتوى".
| عمليات التعداد | |
|---|---|
NATIVE_INVENTORY_TYPE_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
NATIVE_INVENTORY_TYPE_NATIVE_ONLY |
يستهدف الخانات الإعلانية التي تقبل "الإعلانات المدمجة مع المحتوى" وتعرضها فقط. |
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER |
يستهدف الخانات الإعلانية التي تقبل وتعرض إعلانات مدمجة مع المحتوى أو إعلانات بانر. |
OpenMeasurementType
نوع تعريف واجهة القياس المفتوح (OMID) المطلوب استهدافه
| عمليات التعداد | |
|---|---|
OPEN_MEASUREMENT_TYPE_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
OPEN_MEASUREMENT_TYPE_OMID_V1 |
يستهدف هذا الخيار المساحات الإعلانية التي تتوافق مع الإصدار 1 من "تعريف واجهة القياس المفتوح" (OMID). |
RestrictedCategory
تمثّل فئات الإعلانات المحدّدة التي تحظر السياسة استهدافها.
| عمليات التعداد | |
|---|---|
RESTRICTED_CATEGORY_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
RESTRICTED_CATEGORY_ALCOHOL |
يستهدف هذا الخيار المساحات الإعلانية التي يسمح فيها الناشر بعرض إعلانات عن المشروبات الكحولية. |
RESTRICTED_CATEGORY_GAMBLING |
يستهدف هذا الإعداد المساحات الإعلانية المتاحة التي يسمح فيها الناشر بعرض إعلانات المقامرة. |
RewardedType
يحدّد معايير الاستهداف استنادًا إلى ما إذا كانت المساحات الإعلانية المتاحة تقدّم مكافأة للمستخدم مقابل مشاهدة إعلان.
| عمليات التعداد | |
|---|---|
REWARDED_TYPE_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
REWARDED_TYPE_NON_REWARDED |
يستهدف هذا الخيار المساحات الإعلانية التي لا تقدّم مكافأة صريحة للمستخدم مقابل مشاهدة الإعلان أو التفاعل معه. |
REWARDED_TYPE_REWARDED |
يستهدف هذا الخيار المساحات الإعلانية التي تقدّم مكافأة للمستخدم مقابل مشاهدة الإعلان أو التفاعل معه. |
PackageVideoTargeting
معايير الاستهداف الخاصة بالفيديو
| تمثيل JSON |
|---|
{ "includedMimeTypes": [ enum ( |
| الحقول | |
|---|---|
includedMimeTypes[] |
اختيارية: قائمة أنواع MIME المستهدَفة للفيديوهات باستخدام سلاسل أنواع MIME المنشورة من قِبل هيئة IANA (https://www.iana.org/assignments/media-types/media-types.xhtml). إذا كان الحقل فارغًا، سيتم استهداف المساحة الإعلانية بغض النظر عن نوع MIME للفيديو. |
includedMaximumAdDurationTargeting |
اختيارية: الحد الأقصى المستهدف لمدة إعلان الفيديو في حال عدم ضبط هذه القيمة، سيتم استهداف المساحة الإعلانية بغض النظر عن الحد الأقصى لمدة إعلان الفيديو. |
includedPositionTypes[] |
اختيارية: أنواع مواضع عرض إعلانات الفيديو المستهدَفة إذا كان هذا الحقل فارغًا، سيتم استهداف المساحة الإعلانية بغض النظر عن نوع موضع عرض إعلان الفيديو. |
includedContentDeliveryMethod |
اختيارية: طريقة عرض الفيديو المستهدَفة وفي حال عدم ضبط هذا الإعداد، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن طريقة عرض الفيديو. |
plcmtTargeting |
اختيارية: أنواع مواضع إعلانات الفيديو المستهدَفة في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن نوع موضع إعلان الفيديو. |
includedPlaybackMethods[] |
اختيارية: قائمة طرق تشغيل الفيديو المستهدَفة إذا كان هذا الحقل فارغًا، سيتم استهداف المساحة الإعلانية بغض النظر عن طريقة تشغيل الفيديو. |
minimumPredictedCompletionRatePercentage |
اختيارية: النسبة المئوية المستهدَفة للحدّ الأدنى لمعدّل الإكمال المتوقّع يجب أن تكون هذه القيمة من مضاعفات العدد 10 بين 10 و90 (بما يشمل هذين الرقمَين). على سبيل المثال، الرقم 10 صالح، ولكن الأرقام 0 و15 و100 غير صالحة. وتعني القيمة 10 أنّ الإعدادات ستتطابق فقط مع الخانات الإعلانية التي نتوقّع أن تبلغ نسبة إكمالها %10 على الأقل. تشير القيمة غير المحدّدة إلى أنّه سيتم استهداف المساحة الإعلانية بغض النظر عن معدّل الإكمال المتوقّع. |
includedPlayerSizeTargeting |
اختيارية: حجم مشغّل الفيديو المستهدَف في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن حجم مشغّل الفيديو. |
VideoMimeType
أنواع MIME للفيديو المطلوب استهدافها
| عمليات التعداد | |
|---|---|
VIDEO_MIME_TYPE_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
VIDEO_MIME_TYPE_THREEGPP |
تنسيق حاوية 3GPP يُستخدَم على هواتف الجيل الثالث (3G). |
VIDEO_MIME_TYPE_APPLICATION_MPEGURL |
HLS/M3U8 |
VIDEO_MIME_TYPE_MP4 |
حاوية MPEG-4 مع برنامج ترميز H.264 عادةً |
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH |
DASH. |
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT |
JavaScript (تُستخدَم لإعلانات VPAID) |
VIDEO_MIME_TYPE_WEBM |
حاوية WebM تستخدم برنامج ترميز VP9 |
MaximumVideoAdDuration
الحدّ الأقصى لمدة مواد الإعلان الإبداعية للفيديو المطلوب استهدافها. تحدّد قيم التعداد المجموعات، ويعني اختيار قيمة أنّ مدة تصميم الإعلان يجب أن تكون أقل من أو تساوي الوقت المحدّد.
| عمليات التعداد | |
|---|---|
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS |
ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 15 ثانية (0 < المدة <= 15 ثانية). |
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS |
ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 20 ثانية (0 < المدة <= 20 ثانية). |
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS |
ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 30 ثانية (0 < المدة <= 30 ثانية). |
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS |
ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 60 ثانية (0 < المدة <= 60 ثانية). |
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS |
ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 90 ثانية (0 < المدة <= 90 ثانية). |
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS |
ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 120 ثانية (0 < المدة <= 120 ثانية). |
PositionType
الموضع القابل للاستهداف للإعلان ضمن فيديو معيّن
| عمليات التعداد | |
|---|---|
POSITION_TYPE_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
POSITION_TYPE_MIDROLL |
يتم تشغيل الإعلان في منتصف محتوى الفيديو. |
POSITION_TYPE_POSTROLL |
يتم تشغيل الإعلان بعد محتوى الفيديو. |
POSITION_TYPE_PREROLL |
يتم تشغيل الإعلان قبل محتوى الفيديو. |
ContentDeliveryMethod
معايير الاستهداف المستندة إلى طريقة عرض محتوى الفيديو
| عمليات التعداد | |
|---|---|
CONTENT_DELIVERY_METHOD_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
CONTENT_DELIVERY_METHOD_STREAMING |
يستهدف محتوى الفيديو الذي يتم بثه مباشرةً. |
CONTENT_DELIVERY_METHOD_PROGRESSIVE |
يستهدف محتوى الفيديو الذي يتم نقله بشكل تدريجي حسب متطلبات تشغيل العميل. |
VideoPlcmtTargeting
يحدّد معايير الاستهداف استنادًا إلى نوع موضع إعلان الفيديو، وغالبًا ما يتوافق مع حقل "plcmt" في OpenRTB من IAB.
| تمثيل JSON |
|---|
{ "selectionType": enum ( |
| الحقول | |
|---|---|
selectionType |
الحقل مطلوب. نوع الاختيار لقائمة مواضع إعلانات الفيديو |
videoPlcmtTypes[] |
الحقل مطلوب. قائمة بأنواع مواضع إعلانات الفيديو المستهدَفة إذا كان الحقل فارغًا، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن نوع موضع إعلان الفيديو. |
SelectionType
قائمة تعداد لأنواع الاختيار المحتملة التي تستخدمها سمات الاستهداف
| عمليات التعداد | |
|---|---|
SELECTION_TYPE_UNSPECIFIED |
نوع الاختيار غير محدّد. يجب عدم استخدامها. |
SELECTION_TYPE_INCLUDE |
يتم تضمين القيم في سمة الاستهداف. |
SELECTION_TYPE_EXCLUDE |
يتم استبعاد القيم في سمة الاستهداف. |
VideoPlcmtType
يمثّل نوع موضع إعلان الفيديو، بما يتوافق مع معايير OpenRTB.
| عمليات التعداد | |
|---|---|
VIDEO_PLCMT_TYPE_UNSPECIFIED |
القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف. |
INSTREAM |
"الإعلانات ما قبل التشغيل" و"الإعلانات أثناء التشغيل" و"الإعلانات ما بعد التشغيل" التي يتم تشغيلها قبل محتوى الفيديو الذي طلبه المستهلك أو أثناء بثه أو بعده يجب ضبط "إعلانات الفيديو أثناء عرض الفيديو" على "تفعيل الصوت" تلقائيًا عند بدء تشغيل المشغّل، أو أن تكون نية المستخدم واضحة وصريحة لمشاهدة محتوى الفيديو. على الرغم من احتمال وجود محتوى آخر يحيط بالمشغّل، يجب أن يكون محتوى الفيديو هو السبب الرئيسي لزيارة المستخدم. ويجب أن يظلّ المحتوى الأساسي على الصفحة ومشغّل الفيديو الوحيد المعروض الذي يمكنه تشغيل الصوت. إذا تم تحويل المشغّل إلى عائم/ثابت، يجب أن تنقل طلبات عرض الإعلانات اللاحقة حجم المشغّل المعدَّل بدقة. |
ACCOMPANYING_CONTENT |
"الإعلانات ما قبل التشغيل" و"الإعلانات أثناء التشغيل" و"الإعلانات ما بعد التشغيل" التي يتم تشغيلها قبل بث محتوى الفيديو أو أثناء بثه أو بعده يتم تحميل مشغّل الفيديو وتشغيله قبل فقرات النص أو المحتوى الرسومي أو بينها أو بعدها، ويبدأ تشغيله فقط عندما يدخل إلى إطار العرض. يجب ألا يبدأ تشغيل المحتوى المصاحب إلا عند دخوله إلى إطار العرض. وقد يتحوّل إلى مشغّل عائم/ثابت أثناء الانتقال إلى أسفل الصفحة. |
INTERSTITIAL |
إعلانات الفيديو التي يتم تشغيلها بدون محتوى فيديو أثناء التشغيل، يجب أن يكون الفيديو هو المحتوى الرئيسي للصفحة وأن يشغل معظم إطار العرض وألّا يتم إخفاؤه من خلال الانتقال إلى أسفل الصفحة. ويمكن أن يكون ذلك في مواضع مثل الفيديو داخل التطبيق أو عروض الشرائح. |
NO_CONTENT |
إعلانات الفيديو التي يتم تشغيلها بدون بث محتوى الفيديو ويمكن أن يكون ذلك في مواضع مثل عروض الشرائح أو الخلاصات المدمجة مع المحتوى أو الإعلانات المضمّنة في المحتوى أو الإعلانات الثابتة/العائمة. |
PlaybackMethod
طريقة التشغيل المطلوب استهدافها
| عمليات التعداد | |
|---|---|
PLAYBACK_METHOD_UNSPECIFIED |
طريقة تشغيل الفيديو غير محدّدة يجب عدم استخدامها. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON |
يبدأ التشغيل تلقائيًا عند تحميل الصفحة أو المحتوى. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF |
يبدأ التشغيل تلقائيًا عند تحميل الصفحة أو المحتوى، ولكن بدون صوت. |
PLAYBACK_METHOD_CLICK_TO_PLAY |
يبدأ التشغيل من خلال إجراء يتّخذه المستخدم (مثل النقر على زر التشغيل). |
VideoPlayerSizeTargeting
تمثّل حجم مشغّل الفيديو الذي يمكن استهدافه. يجب ضبط كل من العرض والارتفاع على قيم غير صفرية.
| تمثيل JSON |
|---|
{ "minimumWidth": string, "minimumHeight": string } |
| الحقول | |
|---|---|
minimumWidth |
الحقل مطلوب. الحد الأدنى لعرض مشغّل الفيديو بالبكسل |
minimumHeight |
الحقل مطلوب. الحد الأدنى لارتفاع مشغّل الفيديو بالبكسل |
StringTargetingDimension
استهداف عام باستخدام قيم سلاسل
| تمثيل JSON |
|---|
{
"selectionType": enum ( |
| الحقول | |
|---|---|
selectionType |
الحقل مطلوب. كيفية استهداف العناصر في هذه القائمة |
values[] |
الحقل مطلوب. القيم المحدّدة |
AdSize
تمثّل هذه السمة حجم خانة إعلانية واحدة أو تصميم إعلان واحد.
| تمثيل JSON |
|---|
{
"width": string,
"height": string,
"type": enum ( |
| الحقول | |
|---|---|
width |
عرض الخانة الإعلانية بالبكسل لن يظهر هذا الحقل إلا عندما يكون نوع المقاس |
height |
ارتفاع الخانة الإعلانية بالبكسل لن يظهر هذا الحقل إلا عندما يكون نوع المقاس |
type |
نوع حجم الخانة الإعلانية |
النوع
تمثّل هذه السمة أنواعًا مختلفة من أحجام الخانات الإعلانية أو أحجام التصاميم.
| عمليات التعداد | |
|---|---|
TYPE_UNSPECIFIED |
عنصر نائب لنوع حجم غير محدّد |
PIXEL |
خانة إعلانية بحجم محدّد حسب الارتفاع والعرض بالبكسل |
INTERSTITIAL |
حجم خاص لوصف خانة إعلانية بينية |
NATIVE |
الإعلانات المدمجة مع المحتوى (على الأجهزة الجوّالة) التي يعرضها الناشر |
FLUID |
يمكن تغيير الحجم المرن (الحجم المتجاوب) تلقائيًا مع تغيُّر البيئة الخارجية. |
CriteriaTargeting
الاستهداف العام المستخدَم لاستهداف السمات التي تحتوي على قائمة بمعرّفات رقمية مضمّنة ومستبعَدة لا يمكن فلترة هذه القائمة باستخدام بنية فلتر القائمة.
| تمثيل JSON |
|---|
{ "targetedCriteriaIds": [ string ], "excludedCriteriaIds": [ string ] } |
| الحقول | |
|---|---|
targetedCriteriaIds[] |
قائمة بأرقام التعريف الرقمية التي سيتم تضمينها |
excludedCriteriaIds[] |
قائمة بالمعرّفات الرقمية التي سيتم استبعادها |
PackagePlacementTargeting
تمثّل الاستهداف المتعلّق بأماكن ظهور الإعلانات، مثل مواقع إلكترونية أو تطبيقات معيّنة للأجهزة الجوّالة. سيتم دمج أنواع استهداف مواضع الإعلان المختلفة منطقيًا باستخدام عامل التشغيل OR.
| تمثيل JSON |
|---|
{ "uriTargeting": { object ( |
| الحقول | |
|---|---|
uriTargeting |
اختيارية: قائمة عناوين URL المستهدَفة أو المستبعَدة. يجب إزالة http/https من النطاقات (على سبيل المثال، google.com)، ويمكن أن تحتوي على 5 مسارات كحدّ أقصى لكل عنوان URL. |
mobileAppTargeting |
اختيارية: قائمة بمعرّفات التطبيقات المتوافقة مع الأجهزة الجوّالة المستهدَفة أو المستبعَدة التي يملكها الناشرون في الوقت الحالي، تتوفّر تطبيقات Android وApple فقط. يمكن العثور على معرّف تطبيق Android، مثل com.google.android.apps.maps، في عنوان URL لمتجر Google Play. ويمكن العثور على معرّف تطبيق iOS (وهو رقم) في نهاية عنوان URL لمتجر iTunes. يتم تضمين تطبيقات الأجهزة الجوّالة التابعة للطرف الأول أو استبعادها. |
includedMobileAppCategoryTargeting[] |
اختيارية: قائمة فئات التطبيقات المتوافقة مع الأجهزة الجوّالة المستهدَفة |
PackagePublisherProvidedSignalsTargeting
تمثّل الاستهداف المتعلّق بالإشارات المقدَّمة من الناشر. سيتم دمج الأنواع المختلفة من الإشارات المقدَّمة من الناشر باستخدام عامل التشغيل المنطقي OR.
| تمثيل JSON |
|---|
{ "audienceTargeting": { object ( |
| الحقول | |
|---|---|
audienceTargeting |
اختيارية: قائمة بأرقام تعريف الجمهور المستهدَف أو المستبعَد استنادًا إلى الإصدار 1.1 من تصنيف IAB للجمهور (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv) |
contentTargeting |
اختيارية: قائمة معرّفات Content ID المستهدَفة أو المستبعَدة يستند إلى الإصدار 2.2 من تصنيف المحتوى لدى IAB (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv) |
videoAndAudioSignalsTargeting |
اختيارية: قائمة بمعرّفات إشارات الفيديو والصوت المستهدَفة والمستبعَدة هذه إشارات إضافية متوافقة مع الإشارات المقدَّمة من الناشر. |
TaxonomyTargeting
تحدّد معايير الاستهداف للتعامل مع مساحة معرّف تصنيف المحتوى والجمهور في IAB.
| تمثيل JSON |
|---|
{ "targetedTaxonomyIds": [ string ], "excludedTaxonomyIds": [ string ] } |
| الحقول | |
|---|---|
targetedTaxonomyIds[] |
اختيارية: قائمة أرقام تعريف تصنيف المحتوى المستهدَف |
excludedTaxonomyIds[] |
اختيارية: قائمة أرقام تعريف تصنيفات المحتوى المستبعَدة |
CurationFeeVisibility
مستوى ظهور رسوم حزمة التنسيق المجمّعة ورسوم شرائح البيانات (إجمالي رسوم التنسيق) تظهر الرسوم دائمًا لمنشئ الحزمة.
| عمليات التعداد | |
|---|---|
CURATION_FEE_VISIBILITY_UNSPECIFIED |
لم يتم تحديد إمكانية رؤية إجمالي رسوم التنظيم. |
DISCLOSED |
تظهر رسوم التنظيم الإجمالية لجميع المشترين. هذه هي القيمة التلقائية في حال عدم ضبطها. |
NON_DISCLOSED |
لا يظهر إجمالي رسوم التنظيم لجميع المشترين. |
الطُرق |
|
|---|---|
|
يؤدي هذا الإجراء إلى تفعيل حزمة منظَّمة حالية. |
|
يؤدي هذا الإجراء إلى إنشاء حزمة منظَّمة جديدة. |
|
لإيقاف حزمة منظَّمة حالية |
|
للحصول على حزمة منظَّمة استنادًا إلى اسم المورد |
|
تعرض هذه الطريقة الحِزم المنظَّمة التي يملكها القيّم المحدّد. |
|
تعديل حزمة منظَّمة حالية |