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

ডাইনামিক অ্যাড ইনসারশন এপিআই আপনাকে ডিএআই ভিডিও-অন-ডিমান্ড (ভিওডি) স্ট্রিম অনুরোধ ও ট্র্যাক করার সুযোগ দেয়। এইচএলএস এবং ড্যাশ স্ট্রিম সমর্থিত।

পরিষেবা: 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

প্রদত্ত কন্টেন্ট সোর্স এবং ভিডিও আইডির জন্য একটি ড্যাশ ডাই স্ট্রিম তৈরি করে।

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

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

রিকোয়েস্ট বডিতে দেওয়ার পরিবর্তে, এপিআই কী-টি নিম্নলিখিত ফরম্যাটে HTTP Authorization হেডারে পাস করা যেতে পারে:

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

পথের পরামিতি

প্যারামিটার
content-source string

স্ট্রিমটির সিএমএস আইডি।

video-id string

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

অনুরোধকারী শরীর

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

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

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

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

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

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

উন্মুক্ত পরিমাপ

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

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

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

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

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

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

HTTP অনুরোধ

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

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

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

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

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

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

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

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

DASH-এর EventStream এলিমেন্ট ব্যবহারের মাধ্যমে অ্যাড মিডিয়া আইডেন্টিফায়ারগুলো ম্যানিফেস্টে অন্তর্ভুক্ত করা হবে।

প্রতিটি EventStream একটি স্কিম আইডি ইউআরআই থাকবে যা হলো urn:google:dai:2018 । এগুলিতে এমন ইভেন্ট থাকবে যার messageData অ্যাট্রিবিউটে "google_" দিয়ে শুরু হওয়া একটি অ্যাড মিডিয়া আইডি থাকবে। প্রতিটি অ্যাড ভেরিফিকেশন রিকোয়েস্টের জন্য 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

স্ট্রিমটির সময়কাল "০০ ঘণ্টা ০০ মিনিট ০০ সেকেন্ড" ফরম্যাটে বৈধ।
valid_until string

স্ট্রিমটি যে তারিখ পর্যন্ত বৈধ থাকবে, RFC 3339 ফরম্যাটে।
subtitles [object(Subtitle)]

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

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

স্ট্রিমের ম্যানিফেস্ট। এটি HLS-এর মাস্টার প্লেলিস্ট এবং DASH-এর MPD-এর সাথে সঙ্গতিপূর্ণ। একটি সার্ভার-সাইড-বিকনিং স্ট্রিম তৈরি করার সময় রেসপন্সে "stream_id" ছাড়াও এটিই একমাত্র ফিল্ড যা উপস্থিত থাকে।
media_verification_url string

মিডিয়া যাচাইকরণ ইউআরএল।
apple_tv object(AppleTV)

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

বিজ্ঞাপন বিরতির তালিকা। খালি থাকলে বাদ দেওয়া হবে।

অ্যাপলটিভি

AppleTV-তে Apple TV ডিভাইস-সম্পর্কিত নির্দিষ্ট তথ্য থাকে।
JSON উপস্থাপনা
{
  "interstitials_url": string,
}
ক্ষেত্র
interstitials_url string

ইন্টারস্টিশিয়াল ইউআরএল।

বিজ্ঞাপন বিরতি

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

বৈধ বিরতির ধরণগুলো হলো: মধ্যবর্তী, পূর্ববর্তী এবং পরবর্তী।
start number

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

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

বিজ্ঞাপনের তালিকা। খালি থাকলে বাদ দেওয়া হবে।
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),
  "skip_metadata": object(SkipMetadata),
  "extensions": [],
}
ক্ষেত্র
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)

ঐচ্ছিক ইন্টারেক্টিভ ক্রিয়েটিভ (SIMID) যা বিজ্ঞাপন চলার সময় দেখানো হবে।
skip_metadata object(SkipMetadata)

স্কিপযোগ্য বিজ্ঞাপনের জন্য ঐচ্ছিক মেটাডেটা। এটি সেট করা থাকলে, বিজ্ঞাপনটি স্কিপযোগ্য বলে গণ্য হয় এবং স্কিপ UI ও ট্র্যাকিং ইভেন্ট কীভাবে পরিচালনা করতে হবে তার নির্দেশাবলী অন্তর্ভুক্ত থাকে।
extensions string

VAST-এর অন্তর্গত সকল <Extension> নোডের ঐচ্ছিক তালিকা।

অনুষ্ঠান

ইভেন্টে একটি ইভেন্টের ধরণ এবং একটি উপস্থাপনার সময় থাকে।
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

টিটিএমএল সাইডকার ফাইলের ঐচ্ছিক ইউআরএল।
webvtt string

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

স্কিপমেটাডেটা

SkipMetadata ক্লায়েন্টদের স্কিপযোগ্য বিজ্ঞাপনের স্কিপ ইভেন্টগুলো পরিচালনা করার জন্য প্রয়োজনীয় তথ্য সরবরাহ করে।
JSON উপস্থাপনা
{
  "offset": number,
  "tracking_url": string,
}
ক্ষেত্র
offset number

অফসেট নির্দেশ করে যে, বিজ্ঞাপন শুরু হওয়ার পর স্কিপ বাটনটি প্রদর্শিত হওয়ার জন্য প্লেয়ারকে কত সেকেন্ড অপেক্ষা করতে হবে। VAST-এ এটি উল্লেখ না করা থাকলে বাদ দেওয়া হয়।
tracking_url string

TrackingURL-এ এমন একটি URL থাকে, যেটিকে skip ইভেন্টে পিং করা উচিত।

আইকন

আইকনটিতে একটি 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

ফলব্যাকইমেজ

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

মোড়ক

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

ট্র্যাকিং ইভেন্টের ধরণ।
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,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}
ক্ষেত্র
click_data object(ClickData)

এই সঙ্গীর ক্লিক ডেটা।
creative_type string

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

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

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

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

এই কম্প্যানিয়নের ধরণ। এটি স্ট্যাটিক, আইফ্রেম বা এইচটিএমএল হতে পারে।
ad_slot_id string

এই সঙ্গীর জন্য স্লট আইডি।
api_framework string

এই সহায়কটির জন্য এপিআই ফ্রেমওয়ার্ক।
tracking_events [object(TrackingEvent)]

এই সহচরের জন্য ট্র্যাকিং ইভেন্টগুলির তালিকা।

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

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

ইন্টারেক্টিভ ক্রিয়েটিভটির ইউআরএল।
type string

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

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

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

ডাইনামিক অ্যাড ইনসারশন এপিআই আপনাকে ডিএআই ভিডিও-অন-ডিমান্ড (ভিওডি) স্ট্রিম অনুরোধ ও ট্র্যাক করার সুযোগ দেয়। এইচএলএস এবং ড্যাশ স্ট্রিম সমর্থিত।

পরিষেবা: 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

প্রদত্ত কন্টেন্ট সোর্স এবং ভিডিও আইডির জন্য একটি ড্যাশ ডাই স্ট্রিম তৈরি করে।

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

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

রিকোয়েস্ট বডিতে দেওয়ার পরিবর্তে, এপিআই কী-টি নিম্নলিখিত ফরম্যাটে HTTP Authorization হেডারে পাস করা যেতে পারে:

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

পথের পরামিতি

প্যারামিটার
content-source string

স্ট্রিমটির সিএমএস আইডি।

video-id string

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

অনুরোধকারী শরীর

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

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

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

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

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

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

উন্মুক্ত পরিমাপ

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

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

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

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

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

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

HTTP অনুরোধ

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

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

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

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

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

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

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

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

DASH-এর EventStream এলিমেন্ট ব্যবহারের মাধ্যমে অ্যাড মিডিয়া আইডেন্টিফায়ারগুলো ম্যানিফেস্টে অন্তর্ভুক্ত করা হবে।

প্রতিটি EventStream একটি স্কিম আইডি ইউআরআই থাকবে যা হলো urn:google:dai:2018 । এগুলিতে এমন ইভেন্ট থাকবে যার messageData অ্যাট্রিবিউটে "google_" দিয়ে শুরু হওয়া একটি অ্যাড মিডিয়া আইডি থাকবে। প্রতিটি অ্যাড ভেরিফিকেশন রিকোয়েস্টের জন্য 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

স্ট্রিমটির সময়কাল "০০ ঘণ্টা ০০ মিনিট ০০ সেকেন্ড" ফরম্যাটে বৈধ।
valid_until string

স্ট্রিমটি যে তারিখ পর্যন্ত বৈধ থাকবে, RFC 3339 ফরম্যাটে।
subtitles [object(Subtitle)]

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

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

স্ট্রিমের ম্যানিফেস্ট। এটি HLS-এর মাস্টার প্লেলিস্ট এবং DASH-এর MPD-এর সাথে সঙ্গতিপূর্ণ। একটি সার্ভার-সাইড-বিকনিং স্ট্রিম তৈরি করার সময় রেসপন্সে "stream_id" ছাড়াও এটিই একমাত্র ফিল্ড যা উপস্থিত থাকে।
media_verification_url string

মিডিয়া যাচাইকরণ ইউআরএল।
apple_tv object(AppleTV)

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

বিজ্ঞাপন বিরতির তালিকা। খালি থাকলে বাদ দেওয়া হবে।

অ্যাপলটিভি

AppleTV-তে Apple TV ডিভাইস-সম্পর্কিত নির্দিষ্ট তথ্য থাকে।
JSON উপস্থাপনা
{
  "interstitials_url": string,
}
ক্ষেত্র
interstitials_url string

ইন্টারস্টিশিয়াল ইউআরএল।

বিজ্ঞাপন বিরতি

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

বৈধ বিরতির ধরণগুলো হলো: মধ্যবর্তী, পূর্ববর্তী এবং পরবর্তী।
start number

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

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

বিজ্ঞাপনের তালিকা। খালি থাকলে বাদ দেওয়া হবে।
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),
  "skip_metadata": object(SkipMetadata),
  "extensions": [],
}
ক্ষেত্র
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)

ঐচ্ছিক ইন্টারেক্টিভ ক্রিয়েটিভ (SIMID) যা বিজ্ঞাপন চলার সময় দেখানো হবে।
skip_metadata object(SkipMetadata)

স্কিপযোগ্য বিজ্ঞাপনের জন্য ঐচ্ছিক মেটাডেটা। এটি সেট করা থাকলে, বিজ্ঞাপনটি স্কিপযোগ্য বলে গণ্য হয় এবং স্কিপ UI ও ট্র্যাকিং ইভেন্ট কীভাবে পরিচালনা করতে হবে তার নির্দেশাবলী অন্তর্ভুক্ত থাকে।
extensions string

VAST-এর অন্তর্গত সকল <Extension> নোডের ঐচ্ছিক তালিকা।

অনুষ্ঠান

ইভেন্টে একটি ইভেন্টের ধরণ এবং একটি উপস্থাপনার সময় থাকে।
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

টিটিএমএল সাইডকার ফাইলের ঐচ্ছিক ইউআরএল।
webvtt string

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

স্কিপমেটাডেটা

SkipMetadata ক্লায়েন্টদের স্কিপযোগ্য বিজ্ঞাপনের স্কিপ ইভেন্টগুলো পরিচালনা করার জন্য প্রয়োজনীয় তথ্য সরবরাহ করে।
JSON উপস্থাপনা
{
  "offset": number,
  "tracking_url": string,
}
ক্ষেত্র
offset number

অফসেট নির্দেশ করে যে, বিজ্ঞাপন শুরু হওয়ার পর স্কিপ বাটনটি প্রদর্শিত হওয়ার জন্য প্লেয়ারকে কত সেকেন্ড অপেক্ষা করতে হবে। VAST-এ এটি উল্লেখ না করা থাকলে বাদ দেওয়া হয়।
tracking_url string

TrackingURL-এ এমন একটি URL থাকে, যেটিকে skip ইভেন্টে পিং করা উচিত।

আইকন

আইকনটিতে একটি 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

ফলব্যাকইমেজ

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

মোড়ক

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

ট্র্যাকিং ইভেন্টের ধরণ।
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,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}
ক্ষেত্র
click_data object(ClickData)

এই সঙ্গীর ক্লিক ডেটা।
creative_type string

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

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

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

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

এই কম্প্যানিয়নের ধরণ। এটি স্ট্যাটিক, আইফ্রেম বা এইচটিএমএল হতে পারে।
ad_slot_id string

এই সঙ্গীর জন্য স্লট আইডি।
api_framework string

এই সহায়কটির জন্য এপিআই ফ্রেমওয়ার্ক।
tracking_events [object(TrackingEvent)]

এই সহচরের জন্য ট্র্যাকিং ইভেন্টগুলির তালিকা।

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

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

ইন্টারেক্টিভ ক্রিয়েটিভটির ইউআরএল।
type string

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

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

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