ডাইনামিক অ্যাড ইনসারশন এপিআই আপনাকে ডিএআই ভিডিও-অন-ডিমান্ড (ভিওডি) স্ট্রিম অনুরোধ ও ট্র্যাক করার সুযোগ দেয়। এইচএলএস এবং ড্যাশ স্ট্রিম সমর্থিত।
পরিষেবা: dai.google.com
stream মেথডটির পাথ https://dai.google.com এর সাপেক্ষে আপেক্ষিক।
পদ্ধতি: প্রবাহ
| পদ্ধতি | |
|---|---|
stream | POST /ondemand/v1/hls/content/{content-source}/vid/{video-id}/streamপ্রদত্ত কন্টেন্ট সোর্স এবং ভিডিও আইডির জন্য একটি HLS 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স্ট্রিম তৈরি করার সময় প্রদত্ত এপিআই কী অবশ্যই পাবলিশারের নেটওয়ার্কের জন্য বৈধ হতে হবে। রিকোয়েস্ট বডিতে দেওয়ার পরিবর্তে, এপিআই কী-টি নিম্নলিখিত ফরম্যাটে HTTP Authorization হেডারে পাস করা যেতে পারে: Authorization: DCLKDAI key="<api-key>" |
পথের পরামিতি
| প্যারামিটার | |
|---|---|
content-source | stringস্ট্রিমটির সিএমএস আইডি। |
video-id | stringস্ট্রিমটির ভিডিও আইডি। |
অনুরোধকারী শরীর
অনুরোধের বডিটি application/x-www-form-urlencoded ধরনের এবং এতে নিম্নলিখিত প্যারামিটারগুলো রয়েছে:
| প্যারামিটার | ||
|---|---|---|
dai-ssb | ঐচ্ছিক | সার্ভার-সাইড-বিকনিং স্ট্রিম তৈরি করতে এটিকে ' |
| ডিএফপি টার্গেটিং প্যারামিটার | ঐচ্ছিক | অতিরিক্ত টার্গেটিং প্যারামিটার। |
| স্ট্রিম প্যারামিটার ওভাররাইড করুন | ঐচ্ছিক | স্ট্রিম তৈরির প্যারামিটারের ডিফল্ট মানগুলো পরিবর্তন করুন। |
| 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 | stringVAST-এর অন্তর্গত সকল <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 | stringWebVTT সাইডকার ফাইলের ঐচ্ছিক URL। |
স্কিপমেটাডেটা
SkipMetadata ক্লায়েন্টদের স্কিপযোগ্য বিজ্ঞাপনের স্কিপ ইভেন্টগুলো পরিচালনা করার জন্য প্রয়োজনীয় তথ্য সরবরাহ করে।| JSON উপস্থাপনা |
|---|
{
"offset": number,
"tracking_url": string,
} |
| ক্ষেত্র | |
|---|---|
offset | numberঅফসেট নির্দেশ করে যে, বিজ্ঞাপন শুরু হওয়ার পর স্কিপ বাটনটি প্রদর্শিত হওয়ার জন্য প্লেয়ারকে কত সেকেন্ড অপেক্ষা করতে হবে। VAST-এ এটি উল্লেখ না করা থাকলে বাদ দেওয়া হয়। |
tracking_url | stringTrackingURL-এ এমন একটি 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 | stringAPIFramework হলো সেই ভিডিও ফ্রেমওয়ার্কটির নাম যা ভেরিফিকেশন কোডটি প্রয়োগ করে। |
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 | stringVAST-এর <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 | stringVAST-এ থাকা <AdParameters> নোডের মান। |
ডাইনামিক অ্যাড ইনসারশন এপিআই আপনাকে ডিএআই ভিডিও-অন-ডিমান্ড (ভিওডি) স্ট্রিম অনুরোধ ও ট্র্যাক করার সুযোগ দেয়। এইচএলএস এবং ড্যাশ স্ট্রিম সমর্থিত।
পরিষেবা: dai.google.com
stream মেথডটির পাথ https://dai.google.com এর সাপেক্ষে আপেক্ষিক।
পদ্ধতি: প্রবাহ
| পদ্ধতি | |
|---|---|
stream | POST /ondemand/v1/hls/content/{content-source}/vid/{video-id}/streamপ্রদত্ত কন্টেন্ট সোর্স এবং ভিডিও আইডির জন্য একটি HLS 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স্ট্রিম তৈরি করার সময় প্রদত্ত এপিআই কী অবশ্যই পাবলিশারের নেটওয়ার্কের জন্য বৈধ হতে হবে। রিকোয়েস্ট বডিতে দেওয়ার পরিবর্তে, এপিআই কী-টি নিম্নলিখিত ফরম্যাটে HTTP Authorization হেডারে পাস করা যেতে পারে: Authorization: DCLKDAI key="<api-key>" |
পথের পরামিতি
| প্যারামিটার | |
|---|---|
content-source | stringস্ট্রিমটির সিএমএস আইডি। |
video-id | stringস্ট্রিমটির ভিডিও আইডি। |
অনুরোধকারী শরীর
অনুরোধের বডিটি application/x-www-form-urlencoded ধরনের এবং এতে নিম্নলিখিত প্যারামিটারগুলো রয়েছে:
| প্যারামিটার | ||
|---|---|---|
dai-ssb | ঐচ্ছিক | সার্ভার-সাইড-বিকনিং স্ট্রিম তৈরি করতে এটিকে ' |
| ডিএফপি টার্গেটিং প্যারামিটার | ঐচ্ছিক | অতিরিক্ত টার্গেটিং প্যারামিটার। |
| স্ট্রিম প্যারামিটার ওভাররাইড করুন | ঐচ্ছিক | স্ট্রিম তৈরির প্যারামিটারের ডিফল্ট মানগুলো পরিবর্তন করুন। |
| 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 | stringVAST-এর অন্তর্গত সকল <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 | stringWebVTT সাইডকার ফাইলের ঐচ্ছিক URL। |
স্কিপমেটাডেটা
SkipMetadata ক্লায়েন্টদের স্কিপযোগ্য বিজ্ঞাপনের স্কিপ ইভেন্টগুলো পরিচালনা করার জন্য প্রয়োজনীয় তথ্য সরবরাহ করে।| JSON উপস্থাপনা |
|---|
{
"offset": number,
"tracking_url": string,
} |
| ক্ষেত্র | |
|---|---|
offset | numberঅফসেট নির্দেশ করে যে, বিজ্ঞাপন শুরু হওয়ার পর স্কিপ বাটনটি প্রদর্শিত হওয়ার জন্য প্লেয়ারকে কত সেকেন্ড অপেক্ষা করতে হবে। VAST-এ এটি উল্লেখ না করা থাকলে বাদ দেওয়া হয়। |
tracking_url | stringTrackingURL-এ এমন একটি 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 | stringAPIFramework হলো সেই ভিডিও ফ্রেমওয়ার্কটির নাম যা ভেরিফিকেশন কোডটি প্রয়োগ করে। |
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 | stringVAST-এর <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 | stringVAST-এ থাকা <AdParameters> নোডের মান। |