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

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

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

সমস্ত ইউআরআই https://dai.google.com এর সাপেক্ষে আপেক্ষিক।

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

পদ্ধতি
stream POST /linear/v1/hls/event/{assetKey}/stream

প্রদত্ত ইভেন্ট আইডির জন্য একটি DAI স্ট্রিম তৈরি করে।

HTTP অনুরোধ 

POST https://dai.google.com/linear/v1/hls/event/{assetKey}/stream

অনুরোধ হেডার

প্যারামিটার
api‑key string

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

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

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

পথের পরামিতি

প্যারামিটার
assetKey string

স্ট্রিমটির ইভেন্ট আইডি।
দ্রষ্টব্য: স্ট্রিম অ্যাসেট কী হলো একটি শনাক্তকারী যা অ্যাড ম্যানেজার UI- তেও পাওয়া যায়।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

HTTP অনুরোধ 

GET https://{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_" লেখাটি দিয়ে শুরু হবে।

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

পদ্ধতি: মেটাডেটা

metadata_url এ থাকা মেটাডেটা এন্ডপয়েন্টটি বিজ্ঞাপনের UI তৈরি করতে ব্যবহৃত তথ্য ফেরত দেয়। সার্ভার-সাইড-বিকনিং স্ট্রিমের জন্য মেটাডেটা এন্ডপয়েন্টটি উপলব্ধ নয়, যেখানে বিজ্ঞাপন মিডিয়া যাচাইকরণ শুরু করার দায়িত্ব সার্ভারের থাকে।

পদ্ধতি
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

বিজ্ঞাপনের মেটাডেটা তথ্য পুনরুদ্ধার করে।

HTTP অনুরোধ 

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

কোয়েরি প্যারামিটার

প্যারামিটার
delta_token ঐচ্ছিক string

একটি অস্বচ্ছ টোকেন যা ক্লায়েন্টের বর্তমান সিঙ্ক্রোনাইজেশন অবস্থা নির্দেশ করে। এটি প্রদান করা হলে, সার্ভার প্রতিক্রিয়ায় একটি নতুন next_delta_token সহ শুধুমাত্র টোকেনটি তৈরি হওয়ার পর থেকে পরিবর্তিত মেটাডেটা ফেরত দেয়। এটি বাদ দেওয়া হলে, সার্ভার সম্পূর্ণ DVR উইন্ডোর জন্য পূর্ণাঙ্গ মেটাডেটা ফেরত দেয়।

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

সফল হলে, প্রতিক্রিয়াটি PodMetadata এর একটি ইনস্ট্যান্স ফেরত দেয়।

মেটাডেটা নিয়ে কাজ করা

মেটাডেটার তিনটি স্বতন্ত্র বিভাগ রয়েছে: tags , ads এবং বিজ্ঞাপন breaks । ডেটাতে প্রবেশের পথ হলো tags বিভাগ। সেখান থেকে, ট্যাগগুলোর মধ্যে দিয়ে যান এবং প্রথম সেই এন্ট্রিটি খুঁজুন যার নামটি ভিডিও স্ট্রিমে পাওয়া বিজ্ঞাপন মিডিয়া আইডির একটি প্রিফিক্স। উদাহরণস্বরূপ, আপনার কাছে এমন একটি বিজ্ঞাপন মিডিয়া আইডি থাকতে পারে:

google_1234567890

এরপর আপনি google_12345 নামের একটি ট্যাগ অবজেক্ট খুঁজে পাবেন। এক্ষেত্রে, এটি আপনার অ্যাড মিডিয়া আইডির সাথে মিলে যায়। সঠিক অ্যাড মিডিয়া প্রিফিক্স অবজেক্টটি খুঁজে পাওয়ার পর, আপনি অ্যাড আইডি, অ্যাড ব্রেক আইডি এবং ইভেন্ট টাইপ খুঁজে বের করতে পারবেন। এরপর ads অবজেক্টগুলোকে ইন্ডেক্স করার জন্য অ্যাড আইডি এবং breaks অবজেক্টগুলোকে ইন্ডেক্স করার জন্য অ্যাড ব্রেক আইডি ব্যবহার করা হয়।

প্রতিক্রিয়া ডেটা

স্ট্রিম

নতুন তৈরি করা স্ট্রিমের রিসোর্সসমূহের তালিকা JSON ফরম্যাটে রেন্ডার করতে Stream ব্যবহৃত হয়।
JSON উপস্থাপনা 
{
  "stream_id": string,
  "stream_manifest": string,
  "hls_master_playlist": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "polling_frequency": number,
}
ক্ষেত্র
stream_id string

GAM স্ট্রিম শনাক্তকারী।
stream_manifest string

স্ট্রিমের ম্যানিফেস্ট ইউআরএল, যা HLS-এ মাল্টিভেরিয়েন্ট প্লেলিস্ট অথবা DASH-এ MPD পুনরুদ্ধার করতে ব্যবহৃত হয়।
hls_master_playlist string

(অপ্রচলিত) HLS মাল্টিভেরিয়েন্ট প্লেলিস্ট URL। এর পরিবর্তে 'stream_manifest' ব্যবহার করুন।
media_verification_url string

প্লেব্যাক ইভেন্ট ট্র্যাক করার জন্য বেস এন্ডপয়েন্ট হিসেবে মিডিয়া ভেরিফিকেশন ইউআরএল ব্যবহার করা হয়।
metadata_url string

আসন্ন স্ট্রিম বিজ্ঞাপন ইভেন্ট সম্পর্কে পর্যায়ক্রমিক তথ্য জানতে পোল করার জন্য ব্যবহৃত মেটাডেটা ইউআরএল।
session_update_url string

এই স্ট্রিমের টার্গেটিং প্যারামিটারগুলো আপডেট করতে সেশনের আপডেট ইউআরএল ব্যবহার করা হয়। প্রাথমিক স্ট্রিম তৈরির অনুরোধের সময় টার্গেটিং প্যারামিটারগুলোর মূল মানগুলো সংগ্রহ করা হয়।
polling_frequency number

metadata_url বা heartbeat_url অনুরোধ করার সময় পোলিং ফ্রিকোয়েন্সি, সেকেন্ডে।

পডমেটাডেটা

PodMetadata-তে বিজ্ঞাপন, বিজ্ঞাপন বিরতি এবং মিডিয়া আইডি ট্যাগ সম্পর্কিত মেটাডেটা তথ্য থাকে।
JSON উপস্থাপনা 
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
  "next_delta_token": string,
  "obsolete_ad_break_ids": [],
}
ক্ষেত্র
tags map[string, object(TagSegment)]

ট্যাগ প্রিফিক্স দ্বারা সূচিত ট্যাগ সেগমেন্টগুলোর মানচিত্র।
ads map[string, object(Ad)]

বিজ্ঞাপন আইডি দ্বারা সূচিবদ্ধ বিজ্ঞাপনগুলোর মানচিত্র।
ad_breaks map[string, object(AdBreak)]

বিজ্ঞাপন বিরতি আইডি দ্বারা সূচিত বিজ্ঞাপন বিরতির মানচিত্র।
next_delta_token string

পরবর্তী পোলে ব্যবহারের জন্য ক্লায়েন্টের একটি অস্বচ্ছ টোকেন।
obsolete_ad_break_ids string

অপ্রচলিত বিজ্ঞাপন বিরতি আইডিগুলোর একটি তালিকা, যেগুলো ক্লায়েন্টের ক্যাশ থেকে মুছে ফেলা উচিত।

ট্যাগসেগমেন্ট

TagSegment-এ একটি বিজ্ঞাপন, তার বিজ্ঞাপন বিরতি এবং ইভেন্টের ধরণ উল্লেখ থাকে। type="progress" যুক্ত TagSegment-কে বিজ্ঞাপন মিডিয়া যাচাইকরণ এন্ডপয়েন্টে পিং করা উচিত নয়।
JSON উপস্থাপনা 
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
ক্ষেত্র
ad string

এই ট্যাগের বিজ্ঞাপনের আইডি।
ad_break_id string

এই ট্যাগের বিজ্ঞাপন বিরতির আইডি।
type string

এই ট্যাগের ইভেন্টের ধরণ।

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

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

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

এই বিজ্ঞাপন বিরতির মোট সময়কাল, সেকেন্ডে।
expected_duration number

সমস্ত বিজ্ঞাপন এবং যেকোনো স্লেট সহ বিজ্ঞাপন বিরতির প্রত্যাশিত সময়কাল (সেকেন্ডে)।
ads number

বিজ্ঞাপন বিরতিতে বিজ্ঞাপনের সংখ্যা।
Ad স্ট্রিমে থাকা একটি বিজ্ঞাপনকে বর্ণনা করে।
JSON উপস্থাপনা
{
  "ad_break_id": string,
  "position": 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,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}
ক্ষেত্র
ad_break_id string

এই বিজ্ঞাপনের বিরতিটির আইডি।
position 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

ঐচ্ছিক ক্লিকথ্রু ইউআরএল।
click_tracking_urls string

ঐচ্ছিক ক্লিক ট্র্যাকিং ইউআরএল।
verifications [object(Verification)]

ঐচ্ছিক ওপেন মেজারমেন্ট যাচাইকরণ এন্ট্রি, যা ক্রিয়েটিভ প্লেব্যাক যাচাই করার জন্য থার্ড-পার্টি মেজারমেন্ট কোড কার্যকর করতে প্রয়োজনীয় রিসোর্স এবং মেটাডেটার তালিকা প্রদান করে।
slate boolean

ঐচ্ছিক বুলিয়ান যা নির্দেশ করে যে বর্তমান এন্ট্রিটি স্লেট।
icons [object(Icon)]

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

র‍্যাপারগুলির একটি তালিকা, যা খালি থাকলে বাদ দেওয়া হয়।
universal_ad_id object(UniversalAdID)

ঐচ্ছিক সার্বজনীন বিজ্ঞাপন আইডি।
extensions string

VAST-এর অন্তর্গত সকল <Extension> নোডের ঐচ্ছিক তালিকা।
companions [object(Companion)]

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

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

আইকন

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

সমস্ত ইউআরআই https://dai.google.com এর সাপেক্ষে আপেক্ষিক।

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

পদ্ধতি
stream POST /linear/v1/hls/event/{assetKey}/stream

প্রদত্ত ইভেন্ট আইডির জন্য একটি DAI স্ট্রিম তৈরি করে।

HTTP অনুরোধ 

POST https://dai.google.com/linear/v1/hls/event/{assetKey}/stream

অনুরোধ হেডার

প্যারামিটার
api‑key string

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

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

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

পথের পরামিতি

প্যারামিটার
assetKey string

স্ট্রিমটির ইভেন্ট আইডি।
দ্রষ্টব্য: স্ট্রিম অ্যাসেট কী হলো একটি শনাক্তকারী যা অ্যাড ম্যানেজার UI- তেও পাওয়া যায়।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

HTTP অনুরোধ 

GET https://{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_" লেখাটি দিয়ে শুরু হবে।

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

পদ্ধতি: মেটাডেটা

metadata_url এ থাকা মেটাডেটা এন্ডপয়েন্টটি বিজ্ঞাপনের UI তৈরি করতে ব্যবহৃত তথ্য ফেরত দেয়। সার্ভার-সাইড-বিকনিং স্ট্রিমের জন্য মেটাডেটা এন্ডপয়েন্টটি উপলব্ধ নয়, যেখানে বিজ্ঞাপন মিডিয়া যাচাইকরণ শুরু করার দায়িত্ব সার্ভারের থাকে।

পদ্ধতি
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

বিজ্ঞাপনের মেটাডেটা তথ্য পুনরুদ্ধার করে।

HTTP অনুরোধ 

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

কোয়েরি প্যারামিটার

প্যারামিটার
delta_token ঐচ্ছিক string

একটি অস্বচ্ছ টোকেন যা ক্লায়েন্টের বর্তমান সিঙ্ক্রোনাইজেশন অবস্থা নির্দেশ করে। এটি প্রদান করা হলে, সার্ভার প্রতিক্রিয়ায় একটি নতুন next_delta_token সহ শুধুমাত্র টোকেনটি তৈরি হওয়ার পর থেকে পরিবর্তিত মেটাডেটা ফেরত দেয়। এটি বাদ দেওয়া হলে, সার্ভার সম্পূর্ণ DVR উইন্ডোর জন্য পূর্ণাঙ্গ মেটাডেটা ফেরত দেয়।

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

সফল হলে, প্রতিক্রিয়াটি PodMetadata এর একটি ইনস্ট্যান্স ফেরত দেয়।

মেটাডেটা নিয়ে কাজ করা

মেটাডেটার তিনটি স্বতন্ত্র বিভাগ রয়েছে: tags , ads এবং বিজ্ঞাপন breaks । ডেটাতে প্রবেশের পথ হলো tags বিভাগ। সেখান থেকে, ট্যাগগুলোর মধ্যে দিয়ে যান এবং প্রথম সেই এন্ট্রিটি খুঁজুন যার নামটি ভিডিও স্ট্রিমে পাওয়া বিজ্ঞাপন মিডিয়া আইডির একটি প্রিফিক্স। উদাহরণস্বরূপ, আপনার কাছে এমন একটি বিজ্ঞাপন মিডিয়া আইডি থাকতে পারে:

google_1234567890

এরপর আপনি google_12345 নামের একটি ট্যাগ অবজেক্ট খুঁজে পাবেন। এক্ষেত্রে, এটি আপনার অ্যাড মিডিয়া আইডির সাথে মিলে যায়। সঠিক অ্যাড মিডিয়া প্রিফিক্স অবজেক্টটি খুঁজে পাওয়ার পর, আপনি অ্যাড আইডি, অ্যাড ব্রেক আইডি এবং ইভেন্ট টাইপ খুঁজে বের করতে পারবেন। এরপর ads অবজেক্টগুলোকে ইন্ডেক্স করার জন্য অ্যাড আইডি এবং breaks অবজেক্টগুলোকে ইন্ডেক্স করার জন্য অ্যাড ব্রেক আইডি ব্যবহার করা হয়।

প্রতিক্রিয়া ডেটা

স্ট্রিম

নতুন তৈরি করা স্ট্রিমের রিসোর্সসমূহের তালিকা JSON ফরম্যাটে রেন্ডার করতে Stream ব্যবহৃত হয়।
JSON উপস্থাপনা 
{
  "stream_id": string,
  "stream_manifest": string,
  "hls_master_playlist": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "polling_frequency": number,
}
ক্ষেত্র
stream_id string

GAM স্ট্রিম শনাক্তকারী।
stream_manifest string

স্ট্রিমের ম্যানিফেস্ট ইউআরএল, যা HLS-এ মাল্টিভেরিয়েন্ট প্লেলিস্ট অথবা DASH-এ MPD পুনরুদ্ধার করতে ব্যবহৃত হয়।
hls_master_playlist string

(অপ্রচলিত) HLS মাল্টিভেরিয়েন্ট প্লেলিস্ট URL। এর পরিবর্তে 'stream_manifest' ব্যবহার করুন।
media_verification_url string

প্লেব্যাক ইভেন্ট ট্র্যাক করার জন্য বেস এন্ডপয়েন্ট হিসেবে মিডিয়া ভেরিফিকেশন ইউআরএল ব্যবহার করা হয়।
metadata_url string

আসন্ন স্ট্রিম বিজ্ঞাপন ইভেন্ট সম্পর্কে পর্যায়ক্রমিক তথ্য জানতে পোল করার জন্য ব্যবহৃত মেটাডেটা ইউআরএল।
session_update_url string

এই স্ট্রিমের টার্গেটিং প্যারামিটারগুলো আপডেট করতে সেশনের আপডেট ইউআরএল ব্যবহার করা হয়। প্রাথমিক স্ট্রিম তৈরির অনুরোধের সময় টার্গেটিং প্যারামিটারগুলোর মূল মানগুলো সংগ্রহ করা হয়।
polling_frequency number

metadata_url বা heartbeat_url অনুরোধ করার সময় পোলিং ফ্রিকোয়েন্সি, সেকেন্ডে।

পডমেটাডেটা

PodMetadata-তে বিজ্ঞাপন, বিজ্ঞাপন বিরতি এবং মিডিয়া আইডি ট্যাগ সম্পর্কিত মেটাডেটা তথ্য থাকে।
JSON উপস্থাপনা 
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
  "next_delta_token": string,
  "obsolete_ad_break_ids": [],
}
ক্ষেত্র
tags map[string, object(TagSegment)]

ট্যাগ প্রিফিক্স দ্বারা সূচিত ট্যাগ সেগমেন্টগুলোর মানচিত্র।
ads map[string, object(Ad)]

বিজ্ঞাপন আইডি দ্বারা সূচিবদ্ধ বিজ্ঞাপনগুলোর মানচিত্র।
ad_breaks map[string, object(AdBreak)]

বিজ্ঞাপন বিরতি আইডি দ্বারা সূচিত বিজ্ঞাপন বিরতির মানচিত্র।
next_delta_token string

পরবর্তী পোলে ব্যবহারের জন্য ক্লায়েন্টের একটি অস্বচ্ছ টোকেন।
obsolete_ad_break_ids string

অপ্রচলিত বিজ্ঞাপন বিরতি আইডিগুলোর একটি তালিকা, যেগুলো ক্লায়েন্টের ক্যাশ থেকে মুছে ফেলা উচিত।

ট্যাগসেগমেন্ট

TagSegment-এ একটি বিজ্ঞাপন, তার বিজ্ঞাপন বিরতি এবং ইভেন্টের ধরণ উল্লেখ থাকে। type="progress" যুক্ত TagSegment-কে বিজ্ঞাপন মিডিয়া যাচাইকরণ এন্ডপয়েন্টে পিং করা উচিত নয়।
JSON উপস্থাপনা 
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
ক্ষেত্র
ad string

এই ট্যাগের বিজ্ঞাপনের আইডি।
ad_break_id string

এই ট্যাগের বিজ্ঞাপন বিরতির আইডি।
type string

এই ট্যাগের ইভেন্টের ধরণ।

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

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

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

এই বিজ্ঞাপন বিরতির মোট সময়কাল, সেকেন্ডে।
expected_duration number

সমস্ত বিজ্ঞাপন এবং যেকোনো স্লেট সহ বিজ্ঞাপন বিরতির প্রত্যাশিত সময়কাল (সেকেন্ডে)।
ads number

বিজ্ঞাপন বিরতিতে বিজ্ঞাপনের সংখ্যা।
Ad স্ট্রিমে থাকা একটি বিজ্ঞাপনকে বর্ণনা করে।
JSON উপস্থাপনা
{
  "ad_break_id": string,
  "position": 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,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}
ক্ষেত্র
ad_break_id string

এই বিজ্ঞাপনের বিরতিটির আইডি।
position 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

ঐচ্ছিক ক্লিকথ্রু ইউআরএল।
click_tracking_urls string

ঐচ্ছিক ক্লিক ট্র্যাকিং ইউআরএল।
verifications [object(Verification)]

ঐচ্ছিক ওপেন মেজারমেন্ট যাচাইকরণ এন্ট্রি, যা ক্রিয়েটিভ প্লেব্যাক যাচাই করার জন্য থার্ড-পার্টি মেজারমেন্ট কোড কার্যকর করতে প্রয়োজনীয় রিসোর্স এবং মেটাডেটার তালিকা প্রদান করে।
slate boolean

ঐচ্ছিক বুলিয়ান যা নির্দেশ করে যে বর্তমান এন্ট্রিটি স্লেট।
icons [object(Icon)]

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

র‍্যাপারগুলির একটি তালিকা, যা খালি থাকলে বাদ দেওয়া হয়।
universal_ad_id object(UniversalAdID)

ঐচ্ছিক সার্বজনীন বিজ্ঞাপন আইডি।
extensions string

VAST-এর অন্তর্গত সকল <Extension> নোডের ঐচ্ছিক তালিকা।
companions [object(Companion)]

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

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

আইকন

আইকনটিতে একটি 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> নোডের মান।