واجهة برمجة التطبيقات المباشرة التي تعرض لوحة "إدراج إعلان ديناميكي"

تتيح لك واجهة برمجة التطبيقات Dynamic Ad Insertion API طلب وتتبُّع أحداث البث المباشر المستندة إلى DAI.

الخدمة: dai.google.com

ترتبط كل معرّفات الموارد المنتظمة (URI) بالموقع الإلكتروني https://dai.google.com.

الطريقة: stream

الطُرق
stream POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

تسجيل مجموعة DAI DAI لعرض جلسة بث مباشر

طلب HTTP

POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

مَعلمات المسار

المعلمات
network_code string

رمز شبكة "مدير إعلانات Google" للناشر

custom_asset_key string

المعرّف المخصّص المرتبط بهذا الحدث في "مدير إعلانات Google".

نص الطلب

نص الطلب من النوع application/x-www-form-urlencoded ويحتوي على المعلمات التالية:

المعلمات
مَعلمات استهداف DFP اختياري مَعلمات الاستهداف الإضافية
إلغاء مَعلمات البث اختياري إلغاء القيم التلقائية لمَعلمة إنشاء البث
مصادقة HMAC اختياري المصادقة باستخدام رمز مميّز يستند إلى HMAC

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على عنصر Stream جديد.

فتح القياس

تحتوي واجهة برمجة التطبيقات DAI API على معلومات لإثبات صحة بيانات "القياس المفتوح" في الحقل Verifications. يحتوي هذا الحقل على عنصر واحد أو أكثر من عناصر Verification التي تسرد الموارد والبيانات الوصفية المطلوبة لتنفيذ رمز قياس تابع لجهة خارجية من أجل التحقّق من تشغيل تصميم الإعلان. يُسمح فقط بالقيمة JavaScriptResource. لمزيد من المعلومات، يُرجى الاطّلاع على المختبَر التقني لمكتب الإعلانات التفاعلية (IAB Tech Lab) ومواصفات VAST 4.1.

الطريقة: قسم الحزمة

الطُرق
pod segment GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

لإنشاء مصدر بيانات متوفّر أثناء التشغيل (DAI) لرقم تعريف الحدث المحدّد

طلب HTTP

GET https://dai.google.com/linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

مَعلمات المسار

المعلمات
network_code string

رمز شبكة "مدير إعلانات Google" للناشر

custom_asset_key string

المعرّف المخصّص المرتبط بهذا الحدث في "مدير إعلانات Google".

pod_identifier

تتوفّر التنسيقات التالية:

pod/{integer}

المعرّف الرقمي للفاصل الإعلاني الحالي. يتم تحديد معرّفات مجموعات الإعلانات بشكل تدريجي لكلّ حدث فاصل إعلاني، بدءًا من 1.

ad_break_id/{string}

معرّف السلسلة للفاصل الإعلاني الحالي.
profile_name string

تمثّل هذه السمة اسم الملف الشخصي لترميز DAI في "مدير إعلانات Google". يجب أن يكون ملفّ تعريف الترميز أحد ملفات تعريف الترميز التي تمّ إعدادها للحدث المحدّد.

segment_number integer

فهرس الشريحة المطلوبة ضمن مجموعة الإعلانات المتسلسلة الحالية، بدءًا من الصفر
segment_format string

إضافة الملف المرتبطة بتنسيق المقطع المطلوب الإضافات المقبولة هي: ts أو mp4 أو vtt أو aac أو ac3 أو eac3.

مَعلمات طلب البحث

المعلمات
stream_id مطلوبة string

رقم تعريف مصدر البيانات لجلسة المستخدِم الحالية. يتم عرض هذه القيمة من خلال طلب ناجح إلى نقطة نهاية stream.
sd required1 integer

مدة المقطع المطلوب بالمللي ثانية.
so اختيارية

إزاحة الشريحة المطلوبة داخل مجموعة الإعلانات المتسلسلة بالمللي ثانية إذا لم تستخدم المَعلمة so، سيتم احتسابها من خلال ضرب مدة الشريحة في رقم الشريحة.
pd سمة مطلوبة2 integer

مدة مجموعة الإعلانات المتسلسلة، بالمللي ثانية
auth-token مطلوبة string

رمز HMAC موقَّع ومُشفَّر بتنسيق عنوان URL للمجموعة الإعلانية الحالية
last اختيارية boolean

يشير إلى المقطع الأخير في الفاصل الإعلاني. واصِل حذف هذه المَعلمة من كل الشرائح الأخرى.
scte35 اختيارية string

إشارة SCTE-35 بترميز Base64 لهذا الفاصل الإعلاني
cust_params اختيارية string

مجموعة من أزواج المفاتيح والقِيم، تُستخدَم لاستهداف الحملات في "مدير الحملة". يجب تمثيل هذه الثنائيات كسلسلة طلب بحث مُشفَّرة بتنسيق عنوان URL.

مثال:
المعلمات
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

الحواشي السفلية

  1. sd غير مطلوب لمقاطع الإعداد. ↩
  2. لا يكون pd مطلوبًا للأحداث التي تم فيها تفعيل فواصل إعلانات بدون مدة. ↩

مثال

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbreak-2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

نص الاستجابة

في حال إتمام الإجراء، سيكون نص الاستجابة شريحة بث قابلة للتشغيل تتطابق مع التنسيق والمعلَمات المحدّدة في الطلب.

الطريقة: بيان مجموعة HLS

يسترجع بيان مجموعة الإعلانات في مجموعة HLS لبث مباشر جاهز لمشغّل فيديو العميل لتحميله وتشغيله.

الطُرق
GET GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/pod/{pod_id}.m3u8;

واجهة برمجة تطبيقات لاسترداد قائمة تشغيل متعددة الصيغ بتنسيق HLS لمجموعة إعلانية.

طلب HTTP

GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/pod/{pod_id}.m3u8?stream_id={stream_id}&pd={pod_duration}

مَعلمات المسار

المعلمات
network_code string

رمز شبكة "مدير إعلانات Google" للناشر
custom_asset_key string

المعرّف المخصّص المرتبط بهذا الحدث في "مدير إعلانات Google"
pod_id integer

المعرّف الرقمي للفاصل الإعلاني الحالي. يتم تحديد معرّفات مجموعات الإعلانات بشكل تدريجي لكلّ حدث فاصل إعلاني، بدءًا من 1.

يجب أن يكون

مَعلمات طلب البحث

المعلمات
stream_id مطلوب string

رقم تعريف مصدر البيانات لجلسة المستخدِم الحالية. يتم عرض هذه القيمة من خلال طلب ناجح إلى نقطة نهاية stream.
pd مطلوب integer

مدة مجموعة الإعلانات المتسلسلة، بالمللي ثانية
scte35 اختيارية string

إشارة SCTE-35 بترميز Base64 لهذا الفاصل الإعلاني
cust_params اختيارية string

مجموعة من أزواج المفاتيح والقِيم، تُستخدَم لاستهداف الحملات في "مدير الحملة". يجب تمثيل هذه الثنائيات كسلسلة طلب بحث مُشفَّرة بتنسيق عنوان URL.

مثال:
المعلمات
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة عبارة عن قائمة تشغيل متعددة الصيغ بتنسيق HLS.

الطريقة: بيان مجموعة DASH

يسترجع بيان مجموعة الإعلانات MPEG-DASH لبث مباشر جاهز لتحميله وتشغيله من قِبل مشغّل فيديو العميل.

الطُرق
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/manifest.mpd

واجهة برمجة تطبيقات لاسترداد قائمة تشغيل mpd بتنسيق MPEG-DASH لمجموعة إعلانية

طلب HTTP

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/stream/{stream_id}/pod/{pod_id}/manifest.mpd?pd={pod_duration}

مَعلمات المسار

المعلمات
network_code string

رمز شبكة "مدير إعلانات Google" للناشر
custom_asset_key string

المعرّف المخصّص المرتبط بهذا الحدث في "مدير إعلانات Google"
stream_id string

رقم تعريف مصدر البيانات لجلسة المستخدِم الحالية. يتم عرض هذه القيمة من خلال طلب ناجح إلى نقطة نهاية stream.
pod_id integer

المعرّف الرقمي للفاصل الإعلاني الحالي. يتم تحديد معرّفات مجموعات الإعلانات بشكل تدريجي لكلّ حدث فاصل إعلاني، بدءًا من 1.

يجب أن يكون

مَعلمات طلب البحث

المعلمات
pd مطلوب integer

مدة مجموعة الإعلانات المتسلسلة، بالمللي ثانية
scte35 اختيارية string

إشارة SCTE-35 بترميز Base64 لهذا الفاصل الإعلاني
cust_params اختيارية string

مجموعة من أزواج المفاتيح والقِيم، تُستخدَم لاستهداف الحملات في "مدير الحملة". يجب تمثيل هذه الثنائيات كسلسلة طلب بحث مُشفَّرة بتنسيق عنوان URL.

مثال:
المعلمات
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة عبارة عن قائمة تشغيل mpd بتنسيق MPEG-DASH.

الطريقة: نموذج فترة مجموعة DASH

الطُرق
pods GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

يطلب نموذج فترة DASH من "مدير إعلانات Google". يحتوي هذا النموذج على وحدات ماكرو يجب تعبئتها بمَعلمات البث. بعد تعبئة وحدات الماكرو هذه، سيصبح النموذج فترة الفاصل الإعلاني، ويمكن دمجه في بيان DASH.

طلب HTTP

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

مَعلمات المسار

المعلمات
network_code string

رمز شبكة "مدير إعلانات Google" للناشر

custom_asset_key string

المعرّف المخصّص المرتبط بهذا الحدث في "مدير إعلانات Google".

مَعلمات طلب البحث

المعلمات
stream_id مطلوبة string

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

نص الاستجابة

في حال نجاح الإجراء، يحتوي نص الاستجابة على كائن PodTemplateResponse جديد.

الطريقة: إثبات الملكية من خلال الوسائط

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

الطلبات المُرسَلة إلى نقطة النهاية media verification ثابتة.

الطُرق
media verification GET /{media_verification_url}/{ad_media_id}

إرسال إشعار إلى واجهة برمجة التطبيقات بحدث إثبات ملكية الوسائط

طلب HTTP

GET https://{media-verification-url}/{ad-media-id}

نص الاستجابة

تعرض media verification الردود التالية:

  • HTTP/1.1 204 No Content إذا تم التحقق من الوسائط بنجاح وتم إرسال كل الإشعارات.
  • HTTP/1.1 404 Not Found إذا تعذّر على الطلب التحقق من الوسائط بسبب تنسيق غير صحيح لعنوان URL أو انتهاء الصلاحية.
  • HTTP/1.1 404 Not Found إذا كان طلب إثبات الهوية السابق باستخدام مستند التعريف هذا قد تم قبوله.
  • HTTP/1.1 409 Conflict إذا كان هناك طلب آخر يُرسِل إشعارات في هذا الوقت

معرّفات وسائط الإعلانات

سيتم ترميز معرّفات وسائط الإعلانات في مقطع بيانات وصفية منفصل، أي بيانات وصفية موقّتة لبث HLS أو رسالة emsg لملفات mp4. ستبدأ معرّفات وسائط الإعلانات دائمًا بسلسلة google_.

يجب إلحاق محتوى النص الكامل لإدخال البيانات الوصفية بعنوان URL لإثبات ملكية الإعلان قبل تقديم كل طلب لإثبات ملكية الإعلان.

الطريقة: البيانات الوصفية

تُعرِض نقطة نهاية بيانات التعريف في metadata_url المعلومات المستخدَمة لإنشاء واجهة مستخدم للإعلان. لا تتوفّر نقطة نهاية البيانات الوصفية لعمليات البث التي تستخدم إشارات من جهة الخادم، حيث يكون الخادم مسؤولاً عن بدء عملية إثبات صحة وسائط الإعلانات.

الطُرق
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

لاسترداد معلومات البيانات الوصفية للإعلان

طلب HTTP

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

نص الاستجابة

إذا كانت الاستجابة ناجحة، تعرض مثالاً على PodMetadata.

تحليل البيانات الوصفية

تتضمّن البيانات الوصفية ثلاثة أقسام منفصلة: tags وads وbreaks للإعلان. نقطة دخول إلى البيانات هي قسم tags. من هناك، كرِّر العلامات واعثر على الإدخال الأول الذي يكون اسمه بادئة لمعرّف الوسائط الإعلانية التي تم العثور عليها في الفيديو المضمّن. على سبيل المثال، قد يكون لديك رقم تعريف لوسيط إعلاني بالشكل التالي:

google_1234567890

بعد ذلك، تعثر على عنصر علامة باسم google_12345. في هذه الحالة، يتطابق مع معرّف مادة العرض للإعلان. بعد العثور على عنصر بادئة الوسائط الإعلانية الصحيح، يمكنك البحث عن الأرقام التعريفية للإعلانات وأرقام تعريف الفواصل الإعلانية ونوع الحدث. بعد ذلك، يتم استخدام معرّفات الإعلانات لفهرسة عناصر ads، ويتم استخدام معرّفات الفواصل الإعلانية لفهرسة عناصرbreaks.

بيانات الاستجابة

بث

يُستخدَم البث لعرض قائمة بالموارد للبث الذي تم إنشاؤه حديثًا بتنسيق JSON.
تمثيل JSON
{
  "stream_id": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "heartbeat_url": string,
  "polling_frequency": number,
  "pod_manifest_url": string,
  "manifest_format": string,
}
الحقول
stream_id string

معرّف مصدر البيانات في "مدير إعلانات Google"
media_verification_url string

عنوان URL لإثبات ملكية الوسائط المستخدَم كنقطة نهاية أساسية لتتبُّع أحداث التشغيل
metadata_url string

عنوان URL للبيانات الوصفية المستخدَم لإجراء استطلاع للحصول على المعلومات الدورية حول أحداث إعلانات البث القادمة
session_update_url string

عنوان URL لتعديل الجلسة المستخدَم لتعديل مَعلمات الاستهداف لهذا البث. يتم تسجيل القيم الأصلية لمَعلمات الاستهداف أثناء طلب إنشاء البث الأوّلي.
heartbeat_url string

عنوان URL لمعدّل نبضات القلب، والذي يُستخدَم للحفاظ على بث الإشارات من جهة الخادم، يجب إرسال إشارة إليه كل {PollingFrequency} ثانية. يتمّ تعبئتها لملفات البثّ من جهة الخادم التي تتضمّن إشارات.
polling_frequency number

وتيرة الاستطلاع، بالثواني، عند طلب metadata_url أو heartbeat_url
pod_manifest_url string

يُستخدَم نموذج عنوان URL لبيان مجموعة البث لإنشاء عنوان URL لاسترداد بيان مجموعة البث الخاص بالبث، وهو يتوافق مع عنوان URL لقائمة التشغيل المتعدّدة الصيغ في HLS أو ملف MPD في DASH. تتم تعبئة هذا الحقل لأحداث البث المباشر من النوع "إدراج إعلان ديناميكي" POD_SERVING_MANIFEST. https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType
manifest_format string

تنسيق البيان هو تنسيق البيان الذي تم استرجاعه من pod_manifest_url، سواء كان dash أو hls.

PodMetadata

تتضمّن PodMetadata معلومات عن البيانات الوصفية للإعلانات والفواصل الإعلانية وعلامات تعريف الوسائط.
تمثيل JSON
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}
الحقول
tags map[string, object(TagSegment)]

خريطة لأجزاء العلامات المفهرَسة حسب بادئة العلامة
ads map[string, object(Ad)]

خريطة الإعلانات المفهرَسة حسب رقم تعريف الإعلان
ad_breaks map[string, object(AdBreak)]

خريطة الفواصل الإعلانية المفهرَسة حسب رقم تعريف الفاصل الإعلاني

TagSegment

يحتوي TagSegment على إشارة إلى إعلان وفاصل إعلاني ونوع الحدث. يجب عدم إرسال إشارة TagSegment مع type="progress" إلى نقطة نهاية التحقّق من وسائط الإعلانات.
تمثيل JSON
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
الحقول
ad string

رقم تعريف إعلان هذه العلامة.
ad_break_id string

رقم تعريف الفاصل الإعلاني لهذه العلامة.
type string

نوع الحدث لهذه العلامة

الفاصل الإعلاني

تصف AdBreak فاصلاً إعلانيًا واحدًا في البث. يحتوي على مدة، ونوع (أثناء/قبل/بعد) وعدد الإعلانات.
تمثيل JSON
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
الحقول
type string

أنواع الفواصل الصالحة هي: ما قبل البث وما بين البث وما بعد البث.
duration number

إجمالي مدة الإعلانات لهذا الفاصل الإعلاني، بالثواني
expected_duration number

المدة المتوقّعة للفاصل الإعلاني (بالثواني)، بما في ذلك جميع الإعلانات وأي لوحة إعلانية.
ads number

عدد الإعلانات في الفاصل الإعلاني.
يصف العمود "الإعلان" إعلانًا في البث.
تمثيل JSON
{
  "ad_break_id": string,
  "position": number,
  "duration": number,
  "title": string,
  "description": string,
  "advertiser": string,
  "ad_system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
  "clickthrough_url": string,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}
الحقول
ad_break_id string

رقم تعريف الفاصل الإعلاني لهذا الإعلان.
position number

موضع هذا الإعلان في الفاصل الإعلاني، بدءًا من 1
duration number

مدة الإعلان بالثواني
title string

عنوان اختياري للإعلان.
description string

وصف اختياري للإعلان
advertiser string

المعرّف الاختياري للمعلِن.
ad_system string

نظام إعلان اختياري:
ad_id string

معرّف إعلان اختياري:
creative_id string

رقم تعريف تصميم الإعلان اختياري.
creative_ad_id string

رقم تعريف الإعلان الاختياري لتصميم الإعلان
deal_id string

معرّف الصفقة اختياري.
clickthrough_url string

عنوان URL اختياري للنقرة.
click_tracking_urls string

عناوين URL اختيارية لتتبُّع النقرات:
verifications [object(Verification)]

إدخالات اختيارية لإثبات الملكية باستخدام "القياس المفتوح" تتضمّن الموارد والبيانات الوصفية المطلوبة لتنفيذ رمز القياس التابع لجهة خارجية من أجل التحقّق من تشغيل المواد الإبداعية
slate boolean

قيمة منطقية اختيارية تشير إلى أنّ الإدخال الحالي عبارة عن عنصر حاجب.
icons [object(Icon)]

قائمة الرموز، يتم حذفها إذا كانت فارغة.
wrappers [object(Wrapper)]

قائمة بعناصر Wrappers، يتم حذفها إذا كانت فارغة
universal_ad_id object(UniversalAdID)

معرّف إعلان عالمي اختياري:
extensions string

قائمة اختيارية لجميع عقد <Extension> في تنسيق VAST
companions [object(Companion)]

الإعلانات المصاحبة الاختيارية التي قد تظهر مع هذا الإعلان
interactive_file object(InteractiveFile)

تصميم إعلان تفاعلي اختياري (SIMID) يجب عرضه أثناء تشغيل الإعلان

PodTemplateResponse

يمثّل PodTemplateResponse الحمولة في تنسيق JSON التي يتم إرجاعها إلى VTP لدمج الحِزم.
تمثيل JSON
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
الحقول
dash_period_template string

DashPeriodTemplate هو نموذج xml للفترة التي سيتم ملؤها بالبيانات المناسبة قبل التجميع.
segment_duration_ms int64

SegmentDurationMS هي مدة شرائح الفترة بالمللي ثانية.

الرمز

يحتوي الرمز على معلومات عن رمز VAST.
تمثيل JSON
{
  "click_data": object(ClickData),
  "creative_type": string,
  "click_fallback_images": [object(FallbackImage)],
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "x_position": string,
  "y_position": string,
  "program": string,
  "alt_text": string,
}
الحقول
click_data object(ClickData)

creative_type string

click_fallback_images [object(FallbackImage)]

height int32

width int32

resource string

type string

x_position string

y_position string

program string

alt_text string

ClickData

يحتوي ClickData على معلومات عن النقر على رمز.
تمثيل JSON
{
  "url": string,
}
الحقول
url string

FallbackImage

يحتوي عنصر FallbackImage على معلومات عن صورة احتياطية لتنسيق VAST.
تمثيل JSON
{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}
الحقول
creative_type string

height int32

width int32

resource string

alt_text string

Wrapper

يحتوي الغلاف على معلومات عن إعلان الغلاف. ولا يتضمّن ملف السجلّ رقم تعريف الصفقة إذا لم يكن متوفّرًا.
تمثيل JSON
{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}
الحقول
system string

معرّف نظام الإعلانات:
ad_id string

رقم تعريف الإعلان المستخدَم للإعلان المُغلف
creative_id string

رقم تعريف تصميم الإعلان المستخدَم للإعلان المُغلف
creative_ad_id string

رقم تعريف إعلان تصميم الإعلان المستخدَم في الإعلان المضمّن
deal_id string

رقم تعريف الصفقة الاختياري لإعلان التضمين.

التحقّق

يحتوي القسم "التحقّق" على معلومات عن "القياس المفتوح"، ما يسهّل measuring إمكانية العرض والتحقق من المعلنين التابعين لجهات خارجية. في الوقت الحالي، تتوفّر فقط موارد JavaScript. يُرجى الاطّلاع على https://iabtechlab.com/standards/open-measurement-sdk/.
تمثيل JSON
{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}
الحقول
vendor string

مورّد خدمة إثبات الهوية والملكية
java_script_resources [object(JavaScriptResource)]

قائمة بمصادر JavaScript لإثبات الهوية
tracking_events [object(TrackingEvent)]

قائمة بأحداث التتبّع لإثبات الملكية
parameters string

سلسلة غير شفافة تم تمريرها إلى رمز التحقّق من عملية الإعداد

JavaScriptResource

يحتوي JavaScriptResource على معلومات للتحقّق من خلال JavaScript.
تمثيل JSON
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
الحقول
script_url string

عنوان URI إلى الحمولة البرمجية لـ JavaScript
api_framework string

APIFramework هو اسم إطار عمل الفيديو الذي يستخدم رمز التحقّق.
browser_optional boolean

ما إذا كان من الممكن تشغيل هذا النص البرمجي خارج المتصفح.

TrackingEvent

يحتوي TrackingEvent على عناوين URL التي يجب أن يرسل العميل طلبًا للاتصال بها في حالات معيّنة.
تمثيل JSON
{
  "event": string,
  "uri": string,
}
الحقول
event string

نوع حدث التتبّع:
uri string

حدث التتبُّع الذي سيتم إرسال إشعار إليه.

UniversalAdID

تُستخدَم UniversalAdID لتوفير معرّف فريد لتصميم الإعلان يتم الاحتفاظ به في جميع أنظمة الإعلانات.
تمثيل JSON
{
  "id_value": string,
  "id_registry": string,
}
الحقول
id_value string

الرقم التعريفي العالمي للإعلان لتصميم الإعلان المحدّد للإعلان.
id_registry string

سلسلة تُستخدَم لتحديد عنوان URL لموقع الويب الخاص بالسجلّ الذي تم فيه تصنيف معرّف الإعلان الشامل لتصميم الإعلان المحدّد.

الإعلان المصاحب

يحتوي القسم "مصاحب" على معلومات عن الإعلانات المصاحبة التي قد يتم عرضها مع الإعلان.
تمثيل JSON
{
  "click_data": object(ClickData),
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}
الحقول
click_data object(ClickData)

بيانات النقرات لهذا الفيديو المصاحب.
creative_type string

سمة CreativeType في عقدة <StaticResource> في تنسيق VAST إذا كان هذا إعلانًا مصاحبًا من النوع static
height int32

الارتفاع بالبكسل لهذا الإعلان المصاحب.
width int32

عرض هذا الإعلان المصاحب بالبكسل.
resource string

بالنسبة إلى الإعلانات المصاحبة ثابتة وإطارات iframe، سيكون هذا هو عنوان URL الذي سيتم تحميله وعرضه. بالنسبة إلى العناصر المصاحبة بتنسيق HTML، سيكون هذا هو المقتطف الذي يجب عرضه كعنصر مصاحب.
type string

نوع هذا المصاحب. ويمكن أن يكون إما ثابتًا أو إطار iframe أو HTML.
ad_slot_id string

رقم تعريف الخانة لهذا الإعلان المصاحب.
api_framework string

إطار عمل واجهة برمجة التطبيقات لهذا الملحق
tracking_events [object(TrackingEvent)]

قائمة بأحداث التتبُّع لهذا الجهاز المصاحب

InteractiveFile

يحتوي InteractiveFile على معلومات عن تصميم الإعلان التفاعلي (أي SIMID) التي يجب عرضها أثناء تشغيل الإعلان.
تمثيل JSON
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
الحقول
resource string

عنوان URL لتصميم الإعلان التفاعلي
type string

نوع MIME للملف الذي يتم تقديمه كمورد.
variable_duration boolean

ما إذا كان تصميم الإعلان هذا قد يطلب تمديد المدة
ad_parameters string

قيمة عقدة <AdParameters> في تنسيق VAST