ডায়নামিক বিজ্ঞাপন সন্নিবেশ VOD API

ডায়নামিক অ্যাড ইনসার্শন API আপনাকে DAI ভিডিও-অন-ডিমান্ড (VOD) স্ট্রিমগুলির অনুরোধ এবং ট্র্যাক করতে সক্ষম করে৷ HLS এবং DASH স্ট্রীম সমর্থিত।

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

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

পদ্ধতি: প্রবাহ

পদ্ধতি
stream POST /ondemand/v1/hls/content/{content-source}/vid/{video-id}/stream

প্রদত্ত সামগ্রীর উত্স এবং ভিডিও আইডির জন্য একটি HLS DAI স্ট্রিম তৈরি করে৷

POST /ondemand/v1/dash/content/{content-source}/vid/{video-id}/stream

প্রদত্ত সামগ্রীর উত্স এবং ভিডিও আইডির জন্য একটি DASH DAI স্ট্রিম তৈরি করে৷

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

শিরোনাম অনুরোধ করুন

পরামিতি
api‑key string

একটি স্ট্রীম তৈরি করার সময় প্রদান করা API কী, প্রকাশকের নেটওয়ার্কের জন্য বৈধ হতে হবে।

অনুরোধের অংশে এটি প্রদান করার পরিবর্তে, API কী নিম্নলিখিত বিন্যাস সহ HTTP অনুমোদন শিরোনামে পাস করা যেতে পারে:

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

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

পরামিতি
content-source string

স্ট্রীমের CMS আইডি।

video-id string

স্ট্রীমের ভিডিও আইডি।

শরীরের অনুরোধ

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

পরামিতি
dai-ssb ঐচ্ছিক

একটি সার্ভার-সাইড-বীকনিং স্ট্রীম তৈরি করতে true সেট করুন৷ ডিফল্ট থেকে false । ডিফল্ট স্ট্রীমের ট্র্যাকিং ক্লায়েন্ট-ইনিশিয়েটেড এবং সার্ভার সাইডে পিং করা হয়।

DFP টার্গেটিং প্যারামিটার ঐচ্ছিক অতিরিক্ত টার্গেটিং পরামিতি।
স্ট্রিম প্যারামিটার ওভাররাইড করুন ঐচ্ছিক স্ট্রীম তৈরির প্যারামিটারের ডিফল্ট মান ওভাররাইড করুন।
HMAC প্রমাণীকরণ ঐচ্ছিক একটি HMAC-ভিত্তিক টোকেন ব্যবহার করে প্রমাণীকরণ করুন।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে একটি নতুন 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 এন্ডপয়েন্টে অনুরোধগুলো অদম্য।

পদ্ধতি
media verification GET {media_verification_url}/{ad_media_id}

একটি মিডিয়া যাচাইকরণ ইভেন্টের API-কে অবহিত করে।

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- এ যুক্ত করা উচিত।

প্রতিক্রিয়া তথ্য

প্রবাহ

JSON ফর্ম্যাটে একটি নতুন তৈরি স্ট্রিমের জন্য সমস্ত সংস্থানগুলির একটি তালিকা রেন্ডার করতে স্ট্রিম ব্যবহার করা হয়।
JSON প্রতিনিধিত্ব
{
  "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)],
}
ক্ষেত্র
stream_id string

স্ট্রিম শনাক্তকারী।
total_duration number

সেকেন্ডে স্ট্রিম সময়কাল।
content_duration number

বিষয়বস্তুর সময়কাল, বিজ্ঞাপন ছাড়া, সেকেন্ডে।
valid_for string

"00h00m00s" ফর্ম্যাটে, সময়কাল স্ট্রীম বৈধ৷
valid_until string

RFC 3339 ফর্ম্যাটে স্ট্রীমটি বৈধ হওয়ার তারিখ৷
subtitles [object(Subtitle)]

সাবটাইটেলের একটি তালিকা। খালি থাকলে বাদ দেওয়া হয়। শুধুমাত্র HLS।
hls_master_playlist string

(অপ্রচলিত) HLS মাস্টার প্লেলিস্ট URL। stream_manifest ব্যবহার করুন। শুধুমাত্র HLS।
stream_manifest string

স্রোত প্রকাশ। HLS-এ মাস্টার প্লেলিস্ট এবং DASH-এ MPD-এর সাথে মিলে যায়। এটি "স্ট্রিম_আইডি" ছাড়াও একমাত্র ক্ষেত্র যা একটি সার্ভার-সাইড-বীকনিং স্ট্রীম তৈরি করার সময় প্রতিক্রিয়াতে উপস্থিত থাকে।
media_verification_url string

মিডিয়া যাচাইকরণ URL।
apple_tv object(AppleTV)

AppleTV ডিভাইসের জন্য নির্দিষ্ট ঐচ্ছিক তথ্য। শুধুমাত্র HLS।
ad_breaks [object(AdBreak)]

অ্যাডব্রেকগুলির একটি তালিকা৷ খালি থাকলে বাদ দেওয়া হয়।

অ্যাপলটিভি

AppleTV অ্যাপল টিভি ডিভাইসের জন্য নির্দিষ্ট তথ্য ধারণ করে।
JSON প্রতিনিধিত্ব
{
  "interstitials_url": string,
}
ক্ষেত্র
interstitials_url string

ইন্টারস্টিশিয়াল URL।

অ্যাডব্রেক

অ্যাডব্রেক স্ট্রীমে একটি একক বিজ্ঞাপন বিরতি বর্ণনা করে। এটিতে একটি অবস্থান, একটি সময়কাল, একটি প্রকার (মাঝ/প্রাক/পোস্ট) এবং বিজ্ঞাপনগুলির একটি তালিকা রয়েছে৷
JSON প্রতিনিধিত্ব
{
  "type": string,
  "start": number,
  "duration": number,
  "ads": [object(Ad)],
}
ক্ষেত্র
type string

বৈধ বিরতির প্রকারগুলি হল: মধ্য, পূর্ব এবং পোস্ট।
start number

স্ট্রীমের অবস্থান যেখানে বিরতি শুরু হয়, সেকেন্ডে।
duration number

বিজ্ঞাপন বিরতির সময়কাল, সেকেন্ডে।
ads [object(Ad)]

বিজ্ঞাপনের একটি তালিকা। খালি থাকলে বাদ দেওয়া হয়।
বিজ্ঞাপন প্রবাহে একটি বিজ্ঞাপন বর্ণনা করে। এটি বিরতিতে বিজ্ঞাপনের অবস্থান, বিজ্ঞাপনের সময়কাল এবং কিছু ঐচ্ছিক মেটাডেটা ধারণ করে।
JSON প্রতিনিধিত্ব
{
  "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),
}
ক্ষেত্র
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

ঐচ্ছিক ক্লিকথ্রু URL।
icons [object(Icon)]

আইকনগুলির একটি তালিকা, খালি থাকলে বাদ দেওয়া হয়।
wrappers [object(Wrapper)]

মোড়কের একটি তালিকা। খালি থাকলে বাদ দেওয়া হয়।
events [object(Event)]

বিজ্ঞাপনের ঘটনাগুলির একটি তালিকা।
verifications [object(Verification)]

ঐচ্ছিক ওপেন মেজারমেন্ট যাচাইকরণ এন্ট্রি যা সৃজনশীল প্লেব্যাক যাচাই করার জন্য তৃতীয় পক্ষের পরিমাপ কোড চালানোর জন্য প্রয়োজনীয় সংস্থান এবং মেটাডেটা তালিকাভুক্ত করে।
universal_ad_id object(UniversalAdID)

ঐচ্ছিক সার্বজনীন বিজ্ঞাপন আইডি।
companions [object(Companion)]

ঐচ্ছিক সঙ্গী যা এই বিজ্ঞাপনের সাথে প্রদর্শিত হতে পারে।
interactive_file object(InteractiveFile)

ঐচ্ছিক ইন্টারেক্টিভ ক্রিয়েটিভ (SIMID) যা বিজ্ঞাপন প্লেব্যাকের সময় প্রদর্শিত হওয়া উচিত।

ঘটনা

ইভেন্টে একটি ইভেন্টের ধরন এবং একটি ইভেন্টের উপস্থাপনার সময় থাকে।
JSON প্রতিনিধিত্ব
{
  "time": number,
  "type": string,
}
ক্ষেত্র
time number

এই ইভেন্ট এর উপস্থাপনা সময়.
type string

এই ঘটনার ধরন.

সাবটাইটেল

সাবটাইটেল ভিডিও স্ট্রিমের জন্য একটি সাইডকার সাবটাইটেল ট্র্যাক বর্ণনা করে। এটি দুটি সাবটাইটেল ফর্ম্যাট সঞ্চয় করে: TTML এবং WebVTT। TTMLPath অ্যাট্রিবিউটে TTML সাইডকার ফাইলের URL থাকে এবং WebVTTPath অ্যাট্রিবিউটে একইভাবে WebVTT সাইডকার ফাইলের URL থাকে।
JSON প্রতিনিধিত্ব
{
  "language": string,
  "language_name": string,
  "ttml": string,
  "webvtt": string,
}
ক্ষেত্র
language string

একটি ভাষা কোড, যেমন 'en' বা 'de'।
language_name string

ভাষার বর্ণনামূলক নাম। একই ভাষার জন্য একাধিক সেট বিদ্যমান থাকলে এটি সাবটাইটেলের নির্দিষ্ট সেটকে আলাদা করে
ttml string

TTML সাইডকার ফাইলের ঐচ্ছিক URL।
webvtt string

WebVTT সাইডকার ফাইলের ঐচ্ছিক URL।

আইকন

আইকনে একটি 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 একটি আইকন ক্লিকথ্রু সম্পর্কে তথ্য রয়েছে।
JSON প্রতিনিধিত্ব
{
  "url": string,
}
ক্ষেত্র
url string

ফলব্যাক ইমেজ

ফলব্যাক ইমেজে একটি 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

মোড়ক

র‍্যাপারে একটি র‍্যাপার বিজ্ঞাপন সম্পর্কে তথ্য রয়েছে৷ এটি বিদ্যমান না থাকলে এটি একটি ডিল আইডি অন্তর্ভুক্ত করে না।
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

মোড়ক বিজ্ঞাপনের জন্য ঐচ্ছিক ডিল আইডি।

প্রতিপাদন

যাচাইকরণে খোলা পরিমাপের তথ্য রয়েছে, যা তৃতীয় পক্ষের দর্শনযোগ্যতা এবং যাচাইকরণ পরিমাপকে সহজতর করে। বর্তমানে, শুধুমাত্র জাভাস্ক্রিপ্ট সম্পদ সমর্থিত. 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)]

যাচাইকরণের জন্য জাভাস্ক্রিপ্ট সম্পদের তালিকা।
tracking_events [object(TrackingEvent)]

যাচাইকরণের জন্য ট্র্যাকিং ইভেন্টের তালিকা।
parameters string

বুটস্ট্র্যাপ যাচাইকরণ কোডে একটি অস্বচ্ছ স্ট্রিং পাস করা হয়েছে।

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

JavaScriptResource জাভাস্ক্রিপ্টের মাধ্যমে যাচাইকরণের জন্য তথ্য রয়েছে।
JSON প্রতিনিধিত্ব
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
ক্ষেত্র
script_url string

জাভাস্ক্রিপ্ট পেলোড থেকে ইউআরআই।
api_framework string

APIFramework হল ভিডিও ফ্রেমওয়ার্কের নাম যা যাচাইকরণ কোড ব্যবহার করে।
browser_optional boolean

এই স্ক্রিপ্ট ব্রাউজারের বাইরে চালানো যাবে কিনা।

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

TrackingEvent-এ এমন URL রয়েছে যা নির্দিষ্ট পরিস্থিতিতে ক্লায়েন্টের দ্বারা পিং করা উচিত।
JSON প্রতিনিধিত্ব
{
  "event": string,
  "uri": string,
}
ক্ষেত্র
event string

ট্র্যাকিং ইভেন্টের ধরন, বর্তমানে একমাত্র বিকল্প হল "verificationNotExecuted" যেমন VAST 4.1 স্পেসিফিকেশনে উল্লেখ করা হয়েছে।
uri string

ট্র্যাকিং ইভেন্টটি পিং করা হবে৷

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

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,
}
ক্ষেত্র
click_data object(ClickData)

এই সঙ্গীর জন্য ক্লিক ডেটা.
creative_type string

VAST-এ <StaticResource> নোডে CreativeType অ্যাট্রিবিউট যদি এটি স্ট্যাটিক টাইপের সহচর হয়।
height int32

এই সঙ্গীর পিক্সেলে উচ্চতা।
width int32

এই সঙ্গীর পিক্সেলে প্রস্থ।
resource string

স্ট্যাটিক এবং আইফ্রেম সঙ্গীদের জন্য এটি লোড এবং প্রদর্শিত URL হবে। HTML সহচরদের জন্য, এটি হবে HTML স্নিপেট যা সহচর হিসাবে দেখানো উচিত৷
type string

এই সঙ্গীর প্রকার। এটি স্ট্যাটিক, আইফ্রেম বা এইচটিএমএল হতে পারে।

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

ইন্টারেক্টিভফাইলে ইন্টারেক্টিভ ক্রিয়েটিভ (অর্থাৎ SIMID) এর তথ্য রয়েছে যা বিজ্ঞাপন প্লেব্যাকের সময় প্রদর্শিত হওয়া উচিত।
JSON প্রতিনিধিত্ব
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
ক্ষেত্র
resource string

ইন্টারেক্টিভ ক্রিয়েটিভের URL।
type string

সম্পদ হিসাবে প্রদত্ত ফাইলের MIME প্রকার।
variable_duration boolean

এই সৃজনশীল সময়কাল বাড়ানোর জন্য জিজ্ঞাসা করতে পারে কিনা।
ad_parameters string

VAST-এ <AdParameters> নোডের মান।