ডায়নামিক বিজ্ঞাপন সন্নিবেশ 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 spec দেখুন।

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

আপনি প্লেব্যাকের সময় একটি বিজ্ঞাপন মিডিয়া শনাক্তকারীর সম্মুখীন হওয়ার পরে, অবিলম্বে 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 এর একটি স্কিম ID URI থাকবে। তারা “google_” দিয়ে শুরু হওয়া একটি বিজ্ঞাপন মিডিয়া আইডি ধারণকারী messageData অ্যাট্রিবিউট সহ ইভেন্ট ধারণ করবে। প্রতিটি বিজ্ঞাপন যাচাইকরণের অনুরোধের জন্য 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)],
}

অ্যাপলটিভি

{
  "interstitials_url": string,
}

অ্যাডব্রেক

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

মেটাডেটা এড়িয়ে যান

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

ক্লিক ডাটা

{
  "url": string,
}

ফলব্যাক ইমেজ

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

জাভাস্ক্রিপ্ট রিসোর্স

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

ট্র্যাকিং ইভেন্ট

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

ইউনিভার্সালএডিআইডি

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

ইন্টারেক্টিভ ফাইল

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