بدء استخدام SGAI

توفّر ميزة إدراج الإعلانات المتسلسلة الخاصة بالخادم (SGAI) بيانًا لمجموعة الإعلانات المتسلسلة الجاهزة للاستخدام. والدمج على أجهزة العميل. في حال تفعيل DAI لعرض الإعلانات Pod في حسابك على Google شبكة "مدير الإعلانات"، يمكنك استخدام SGAI. في حال عدم توفّر عرض إعلانات الكُتب تم تفعيل ميزة DAI. يُرجى التواصل مع مدير حسابك.

من خلال SGAI، يمكنك استخدام نقاط نهاية واجهة برمجة التطبيقات Pod serve API لإنشاء بث استرداد البيانات الوصفية للإعلانات وبيانات مجموعة الإعلانات المتسلسلة

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

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

المتطلبات الأساسية

قبل المتابعة، تأكَّد من توفُّر ما يلي:

• تم تفعيل عرض مجموعة "إدراج إعلان ديناميكي" على شبكة "مدير إعلانات Google".
• حدث بث مباشر من النوع بيان عرض Pod. لإنشاء الحدث، يُرجى اتّباع الخطوات التالية: الرؤية إعداد بث مباشر لميزة "إدراج إعلان ديناميكي"

اتّباع الاقتراحات

قبل إنشاء عنوان URL لبيان مجموعة الإعلانات المتسلسلة، ننصحك تقوم باستدعاء واجهة برمجة تطبيقات الإشعار المبكر (EABN) لتحديد المدة المتوقعة ومعلومات الاستهداف معلمات لكل فاصل إعلاني.

بالنسبة إلى أحداث البث المباشر للإصدار والاختبار، يجب طلب واجهة برمجة تطبيقات EABN، خاصةً إذا كان إعلانك شبكة أي حملات آلية. لمزيد من المعلومات، يُرجى مراجعة ميزات وإرشادات التعامل الآلي المباشر.

تقديم طلب تسجيل البث

يمكنك إنشاء بث عندما يبدأ المستخدم بث محتوى في تطبيق مشغّل الفيديو. طلب تسجيل مع معلمات استهداف لإنشاء جلسة بث حول "مدير الإعلانات" للحصول على تفاصيل حول تقديم طلب تسجيل البث، يُرجى مراجعة الطريقة:stream بعد ذلك، تتلقى بيانات الردّ من الطلب.

تتيح الأمثلة التالية طلب تسجيل البث:

HTTP بنص عادي

• الطلب:

authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded

cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2

• الرد:

{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

صَدفة

• سطر الأوامر:

curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
  --data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
  --compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"

• إخراج:

{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

JavaScript

• استخدام واجهة برمجة تطبيقات الجلب:

const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
  },
  "body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
  "method": "POST",
});

  const stream = await response.json();
  console.log(stream);

• سجلّ وحدة التحكّم:

{
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "polling_frequency": 10,
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "manifest_format": "hls"
}

استطلاع بشأن البيانات الوصفية للفاصل الإعلاني

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

إنشاء عنوان URL لبيان مجموعة الإعلانات المتسلسلة

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

يوضّح المثال التالي بنية عنوان URL لبيان مجموعة الإعلانات المتسلسلة:

https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/pod/101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

ملاحظة: معلمات الفاصل الإعلاني، مثل pod_id وduration وcust_params ويجب أن تكون scte35 هي نفسها لجميع العملاء الذين يشاهدون البث المباشر نفسه، في حين يكون معرّف مصدر البيانات فريدًا لكل عميل إذا اخترت إنشاء عنوان URL لبيان مجموعة الإعلانات المتسلسلة من جهة الخادم وإدراج عناوين URL التي تم إنشاؤها في بيان ساحة المشاركات، اتّبِع أداة معالجة البيان. مستندات الخادم المتعلقة بإرسال معرّف مصدر البيانات من العملاء وإنشاء مَعلمات الفواصل الإعلانية الأخرى

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

تشغيل بيان مجموعة الإعلانات المتسلسلة

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

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

إعداد تقارير عن مرّات الظهور وأحداث الإعلانات

عندما يشغّل مشغّل الفيديو مجموعة الإعلانات المتسلسلة ويصادف بيانات وصفية موقّتة بتنسيق id3، فإنه يستمع إلى أحداث الإعلانات التي يشغّلها مشغّل الفيديو ويعالجها لإرسال إشعارات التحقّق من الوسائط.

ملاحظة مهمة: لا تؤجل إرسال أداة فحص الاتصال إلى عنوان URL للتحقق من الوسائط. ننصحك إشعار على الفور وليس أكثر من دقيقة واحدة