ডায়নামিক অ্যাড ইনসার্শন VOD API

ডায়নামিক বিজ্ঞাপন যোগ করার API আপনাকে DAI চাহিদা অনুসার ভিডিও (VOD) স্ট্রিমের জন্য অনুরোধ করতে এবং ট্র্যাক করতে দেয়। HLS ও DASH স্ট্রিমে কাজ করে।

পরিষেবা: dai.google.com

stream পদ্ধতির পাথ https://dai.google.com-এর সাথে সম্পর্কিত

পদ্ধতি: স্ট্রিম

HTTP অনুরোধ

POST https://dai.google.com/ondemand/v1/hls/content/{content-source}/vid/{video-id}/stream

POST https://dai.google.com/ondemand/v1/dash/content/{content-source}/vid/{video-id}/stream

রিকোয়েস্ট হেডার

Authorization: DCLKDAI key="<api-key>"

পাথ প্যারামিটার

অনুরোধের বডি

অনুরোধের প্রধান অংশ application/x-www-form-urlencoded ধরনের এবং এতে নিম্নলিখিত প্যারামিটার রয়েছে:

প্রতিক্রিয়ার বডি

সফল হলে, রেসপন্স বডিতে একটি নতুন Stream থাকে। সার্ভার-সাইড-বিকনিং স্ট্রিমের জন্য, এই Stream-এ শুধুমাত্র stream_id এবং stream_manifest ফিল্ড থাকে।

পরিমাপ খুলুন

Verifications ফিল্ডে নন-সার্ভার-সাইড-বিকনিং স্ট্রিমের জন্য ওপেন মেজারমেন্ট যাচাইকরণ সংক্রান্ত তথ্য থাকে। Verifications-এ এক বা একাধিক Verification এলিমেন্ট থাকে যা থার্ড-পার্টি মেজারমেন্ট কোডের মাধ্যমে ক্রিয়েটিভ প্লেব্যাক যাচাই করার জন্য প্রয়োজনীয় রিসোর্স ও মেটাডেটার তালিকা দেখায়। শুধুমাত্র JavaScriptResource কাজ করে। আরও তথ্যের জন্য, IAB Tech Lab এবং VAST 4.1 স্পেসিফিকেশন দেখুন।

পদ্ধতি: মিডিয়া যাচাইকরণ

প্লেব্যাকের সময় আপনি কোনও বিজ্ঞাপন মিডিয়া আইডেন্টিফায়ার দেখতে পেলে, অবিলম্বে stream এন্ডপয়েন্ট থেকে media_verification_url ব্যবহার করে একটি অনুরোধ করুন। media_verification_url হল একটি অ্যাবসোলিউট পাথ। সার্ভার-সাইড-বিকনিং স্ট্রিমের জন্য মিডিয়া যাচাইকরণের অনুরোধের প্রয়োজন নেই, যেখানে সার্ভার মিডিয়া যাচাইকরণ শুরু করে।

media verification এন্ডপয়েন্টে করা অনুরোধ আইডেমপোটেন্ট।

HTTP অনুরোধ

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

প্রতিক্রিয়ার বডি

media verification নিম্নলিখিত উত্তরগুলি প্রদান করে:

• HTTP/1.1 204 No Content যদি মিডিয়া যাচাইকরণ সফল হয় এবং সব পিং পাঠানো হয়।
• ভুল URL ফর্ম্যাটিং বা মেয়াদ শেষ হয়ে যাওয়ার কারণে অনুরোধটি মিডিয়া যাচাই করতে না পারলে HTTP/1.1 404 Not Found।
• HTTP/1.1 404 Not Found যদি এই আইডির জন্য আগের যাচাইকরণের অনুরোধ সফল হয়।
• HTTP/1.1 409 Conflict যদি অন্য কোনও অনুরোধ এই সময়ে পিং পাঠায়।

বিজ্ঞাপন মিডিয়া আইডি (HLS)

বিজ্ঞাপন মিডিয়া আইডেন্টিফায়ার TXXX কী ব্যবহার করে HLS টাইমড মেটাডেটায় এনকোড করা হবে, "ব্যবহারকারীর দ্বারা নির্ধারিত টেক্সট তথ্য" ফ্রেমের জন্য সংরক্ষিত। ফ্রেমের কন্টেন্ট এনক্রিপ্ট করা হবে না এবং সবসময় "google_" টেক্সট দিয়ে শুরু হবে।

প্রতিটি বিজ্ঞাপন যাচাইকরণের অনুরোধের জন্য ফ্রেমের সম্পূর্ণ টেক্সট কন্টেন্ট media_verification_url-এ যোগ করতে হবে।

বিজ্ঞাপনের মিডিয়া আইডি (DASH)

DASH-এর EventStream এলিমেন্ট ব্যবহার করে ম্যানিফেস্টে বিজ্ঞাপন মিডিয়া শনাক্তকারী যোগ করা হবে।

প্রতিটি EventStream-এর জন্য urn:google:dai:2018-এর স্কিম আইডি URI থাকবে। এতে messageData অ্যাট্রিবিউট সহ ইভেন্ট থাকবে, যার মধ্যে "google_" দিয়ে শুরু হওয়া বিজ্ঞাপন মিডিয়া আইডি থাকবে। প্রতিটি বিজ্ঞাপন যাচাইকরণের অনুরোধের জন্য messageData অ্যাট্রিবিউটের সম্পূর্ণ কন্টেন্ট media_verification_url-এ যোগ করতে হবে।

উত্তরের ডেটা

স্ট্রিম

{
  "stream_id": string,
  "total_duration": number,
  "content_duration": number,
  "valid_for": string,
  "valid_until": string,
  "subtitles": [object(Subtitle)],
  "hls_master_playlist": string,
  "stream_manifest": string,
  "media_verification_url": string,
  "apple_tv": object(AppleTV),
  "ad_breaks": [object(AdBreak)],
}

AppleTV

{
  "interstitials_url": string,
}

AdBreak

{
  "type": string,
  "start": number,
  "duration": number,
  "ads": [object(Ad)],
}

বিজ্ঞাপন

{
  "seq": number,
  "start": 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,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "events": [object(Event)],
  "verifications": [object(Verification)],
  "universal_ad_id": object(UniversalAdID),
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
  "skip_metadata": object(SkipMetadata),
  "extensions": [],
}

ইভেন্ট

{
  "time": number,
  "type": string,
}

সাবটাইটেল

{
  "language": string,
  "language_name": string,
  "ttml": string,
  "webvtt": string,
}

SkipMetadata

{
  "offset": number,
  "tracking_url": 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

{
  "url": string,
}

FallbackImage

{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}

র‌্যাপার

{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}

যাচাইকরণ

{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}

JavaScriptResource

{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}

TrackingEvent

{
  "event": string,
  "uri": string,
}

UniversalAdID

{
  "id_value": string,
  "id_registry": string,
}

সহযোগী

{
  "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)],
}

InteractiveFile

{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}