ডায়নামিক বিজ্ঞাপন সন্নিবেশ পড পরিবেশন করছে VOD API, গতিশীল বিজ্ঞাপন সন্নিবেশ পড পরিবেশন করছে VOD API

ডায়নামিক বিজ্ঞাপন সন্নিবেশ API আপনাকে DAI অন-ডিমান্ড স্ট্রীমগুলির অনুরোধ এবং ট্র্যাক করতে দেয়৷

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

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

পদ্ধতি: স্ট্রিম তৈরি করুন

এই পদ্ধতিটি ডিভাইস থেকে সরাসরি একটি স্ট্রিম তৈরি করে, ক্লায়েন্ট অ্যাপ্লিকেশনের বিজ্ঞাপনগুলি চালানো এবং ট্র্যাক করার জন্য প্রয়োজনীয় সমস্ত সংস্থান ফেরত দেয় এবং UI উপাদানগুলি প্রদর্শন করে৷

পদ্ধতি
create stream POST: /ondemand/pods/api/v1/network/{network_code}/stream

ভিওডি সেশন পরিবেশনকারী একটি DAI পড তৈরি করুন।

HTTP অনুরোধ 

POST https://dai.google.com/ondemand/pods/api/v1/network/{network_code}/stream

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

পরামিতি
network_code string

প্রকাশকের Google বিজ্ঞাপন ম্যানেজার নেটওয়ার্ক কোড।

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

অনুরোধের মূল অংশটি application/json ধরনের এবং একটি CreateStreamRequest অবজেক্ট থাকতে হবে।

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

সফল হলে, প্রতিক্রিয়া বডিতে একটি নতুন CreateStreamResponse অবজেক্ট থাকে।

পদ্ধতি: স্ট্রিম নিবন্ধন করুন

এই পদ্ধতিটি ডিভাইস থেকে Google DAI ব্যাকএন্ডে একটি স্ট্রিম নিবন্ধন করে, বিজ্ঞাপনগুলি ট্র্যাক করতে এবং UI উপাদানগুলি প্রদর্শন করার জন্য ক্লায়েন্ট অ্যাপ্লিকেশনের জন্য প্রয়োজনীয় সমস্ত সংস্থান ফেরত দেয়। create stream পদ্ধতির বিপরীতে, এই পদ্ধতিটি প্লেযোগ্য বিজ্ঞাপন মেনিফেস্ট ফেরত দেয় না। পরিবর্তে, এই ক্রিয়াটি একটি পৃথক সার্ভার কলে অর্জন করা হয়: decision ad pods ।

পদ্ধতি
register stream POST: /ondemand/pods/api/v1/network/{network_code}/stream_registration

VOD সেশন পরিবেশনকারী একটি DAI পড নিবন্ধন করে।

HTTP অনুরোধ 

POST https://dai.google.com/ondemand/pods/api/v1/network/{network_code}/stream_registration

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

পরামিতি
network_code string

প্রকাশকের Google বিজ্ঞাপন ম্যানেজার নেটওয়ার্ক কোড।

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

অনুরোধের মূল অংশটি application/json ধরনের এবং অবশ্যই একটি StreamRegistrationRequest অবজেক্ট থাকতে হবে।

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

সফল হলে, প্রতিক্রিয়া বডিতে একটি নতুন StreamRegistrationResponse অবজেক্ট থাকে।

পদ্ধতি: বিজ্ঞাপন পড পুনরুদ্ধার

এই পদ্ধতিটি একটি ডিভাইস থেকে একটি register stream কল অনুসরণ করে এবং কন্টেন্ট ম্যানিফেস্টে স্টিচ করার জন্য প্লেযোগ্য অ্যাড ম্যানিফেস্ট পুনরুদ্ধার করার জন্য প্রয়োজনীয়।

পদ্ধতি
decision ad pods POST: /ondemand/pods/api/v1/network/{network_code}/streams/{stream_id}/adpods

VOD সেশন পরিবেশনকারী DAI পডের জন্য সিদ্ধান্তের বিজ্ঞাপন পড।

HTTP অনুরোধ 

POST https://dai.google.com/ondemand/pods/api/v1/network/{network_code}/streams/{stream_id}/adpods

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

পরামিতি
network_code string

প্রকাশকের Google বিজ্ঞাপন ম্যানেজার নেটওয়ার্ক কোড।

stream_id string

একটি স্ট্রীম_রেজিস্ট্রেশন কল থেকে প্রাপ্ত স্ট্রিম_আইডি।

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

অনুরোধের মূল অংশটি application/json ধরনের এবং একটি AdPodDecisionRequest অবজেক্ট থাকতে হবে।

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

সফল হলে, প্রতিক্রিয়া বডিতে একটি নতুন AdPodDecisionResponse অবজেক্ট থাকে।

পদ্ধতি: বিজ্ঞাপন পড মেটাডেটা

এই পদ্ধতিটি বিজ্ঞাপনগুলি ট্র্যাক করতে এবং উপযুক্ত UI উপাদানগুলিকে সঠিকভাবে রেন্ডার করার জন্য ক্লায়েন্ট অ্যাপের জন্য প্রয়োজনীয় সমস্ত তথ্য প্রদান করে৷

পদ্ধতি
ad pods metadata GET: /ondemand/pods/api/v1/network/.../metadata

একটি নির্দিষ্ট সেশনের জন্য বিজ্ঞাপন পড মেটাডেটা পুনরুদ্ধার করুন। এই URLটি StreamRegistrationResponse metadata_url অ্যাট্রিবিউটে ফেরত দেওয়া হয়েছে।

HTTP অনুরোধ 

GET: /ondemand/pods/api/v1/network/.../metadata

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

সফল হলে, প্রতিক্রিয়া বডিতে একটি Ad pods metadata অবজেক্ট থাকে।

API অবজেক্ট

পডমেটাডেটা

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

ট্যাগ উপসর্গ দ্বারা সূচীকৃত ট্যাগ বিভাগের মানচিত্র।
ads map[string, object(Ad)]

বিজ্ঞাপন আইডি দ্বারা সূচীকৃত বিজ্ঞাপনের মানচিত্র।
ad_breaks map[string, object(AdBreak)]

বিজ্ঞাপন বিরতি আইডি দ্বারা সূচীকৃত বিজ্ঞাপন বিরতির মানচিত্র।
polling_frequency number

প্রস্তাবিত মেটাডেটা ইউআরএল পোলিং ফ্রিকোয়েন্সি, সেকেন্ডে। অন-ডিমান্ড ডিসিশনিং ব্যবহার করে VOD স্ট্রীমের জন্য জনবহুল।

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

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

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

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

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

অ্যাডব্রেক

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

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

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

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

বিজ্ঞাপন বিরতিতে বিজ্ঞাপনের সংখ্যা।
বিজ্ঞাপন প্রবাহে একটি বিজ্ঞাপন বর্ণনা করে।
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

বিজ্ঞাপন বিরতিতে এই বিজ্ঞাপনের অবস্থান, 1 থেকে শুরু।
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।
click_tracking_urls string

ঐচ্ছিক ক্লিক ট্র্যাকিং URLs.
verifications [object(Verification)]

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

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

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

মোড়কের একটি তালিকা, খালি থাকলে বাদ দেওয়া হয়।
universal_ad_id object(UniversalAdID)

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

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

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

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

ম্যাচঅপ্টস

MatchOpts একটি স্ট্রীমের জন্য কঠোর মিডিয়া ম্যাচিং প্রয়োজনীয়তা নির্দিষ্ট করে।
JSON প্রতিনিধিত্ব 
{
  "audio_channels": boolean,
  "audio_sample_rate": boolean,
}
ক্ষেত্র
audio_channels boolean

বিষয়বস্তু এবং বিজ্ঞাপনের মধ্যে অডিও চ্যানেল মিলান।
audio_sample_rate boolean

বিষয়বস্তু এবং বিজ্ঞাপনের মধ্যে অডিও নমুনা হার মেলান।

স্ট্রিম অনুরোধ তৈরি করুন

CreateStreamRequest VOD পড পরিবেশন API-এ HTTP অনুরোধে পাওয়া তথ্য বর্ণনা করে। প্রতিটি ব্যবহারকারীর জন্য SDK এবং প্রকাশকের পক্ষ থেকে VTP (ভিডিও প্রযুক্তি অংশীদার) দ্বারা স্ট্রিম তৈরি করা শুরু হয়েছে। স্ট্রীম VTP সেলাই করার জন্য সিদ্ধান্ত নেওয়া বিজ্ঞাপন পডের ফলাফল তৈরি করেছে৷ এটি StreamRegistrationRequest+AdPodDecisionRequest প্রবাহের বিপরীতে যা একটি স্ট্রীম নিবন্ধন করে এবং একাধিক অনুরোধে সিদ্ধান্ত গ্রহণ করে।
JSON প্রতিনিধিত্ব
{
  "encoding_profiles": [object(EncodingProfile)],
  "ad_tag": string,
  "cuepoints": [],
  "manifest_type": string,
  "enable_hls_asset_list": boolean,
  "targeting_parameters": map[string, string],
  "content_duration_seconds": number,
  "decision_timing_options": object(DecisionTimingOptions),
  "enable_inline_manifests": boolean,
  "dai_options": object(CreateStreamOptions),
}
ক্ষেত্র
encoding_profiles [object(EncodingProfile)]

এনকোডিং প্রোফাইলের একটি তালিকা। প্রয়োজন।
ad_tag string

সিদ্ধান্ত নেওয়ার জন্য বেস বিজ্ঞাপন ট্যাগ। প্রয়োজন।
cuepoints number

কিউপয়েন্টের একটি তালিকা, সেকেন্ডে। বিজ্ঞাপন ট্যাগের প্রতিক্রিয়া যখন অবস্থানগত সময়ের অফসেট ব্যবহার করে তখন প্রয়োজনীয়।
manifest_type string

বৈধ ম্যানিফেস্ট প্রকারগুলি হল: hls এবং ড্যাশ৷ ডিফল্ট: hls. ঐচ্ছিক।
enable_hls_asset_list boolean

HLS সম্পদ তালিকা ইন্টারস্টিশিয়াল সক্ষম করা আছে কিনা তা নির্দেশ করে। সক্রিয় করা হলে, DAI প্রতিটি অ্যাডব্রেকের জন্য সম্পদের তালিকার URL ফিরিয়ে দেবে, যা HLS ইন্টারস্টিশিয়ালগুলির জন্য ব্যবহার করা যেতে পারে।
targeting_parameters string

অতিরিক্ত অ্যাড ম্যানেজার টার্গেটিং প্যারাম। ঐচ্ছিক।
content_duration_seconds number

ContentDurationSeconds হল বিষয়বস্তুর সময়কাল সেকেন্ডে। বিজ্ঞাপন ট্যাগের প্রতিক্রিয়া শতাংশ সময় অফসেট ব্যবহার করলে প্রয়োজনীয়।
decision_timing_options object(DecisionTimingOptions)

কখন অ্যাডপোডের সিদ্ধান্ত নেওয়া উচিত তা নির্দেশ করে।
enable_inline_manifests boolean

JSON প্রতিক্রিয়াতে ব্রেক ম্যানিফেস্ট ইনলাইন করা উচিত কিনা তা নির্দেশ করে।
dai_options object(CreateStreamOptions)

স্ট্রীম তৈরির জন্য DAIO বিকল্প।

স্ট্রিম অপশন তৈরি করুন

CreateStreamOptions ওয়ান-স্টেপ স্ট্রীম ক্রিয়েট ওয়ার্কফ্লোতে উপলব্ধ বিকল্পগুলি উপস্থাপন করে।
JSON প্রতিনিধিত্ব
{
  "dash_profile": string,
  "match_options": object(MatchOpts),
  "data_sharing_policy_code": string,
  "sam_id": string,
  "session_title": string,
  "dash_inband_event_stream": boolean,
  "distinct_ad_profiles": boolean,
  "tracking_mode": string,
  "emsg_version": uint32,
}
ক্ষেত্র
dash_profile string

MPEG-DASH প্রোফাইল ব্যবহার করার জন্য, 'লাইভ' বা 'অন-ডিমান্ড'।
match_options object(MatchOpts)

data_sharing_policy_code string

প্রকাশকদের নেটওয়ার্ক ডিফল্ট ডেটা শেয়ারিং নীতি ওভাররাইড করার অনুমতি দেয়৷
sam_id string

sam_id হল সেশনের জন্য SAM ডিবাগ কী, ঐচ্ছিক।
session_title string

session_title হল স্ট্রিমের জন্য SAM সেশন শিরোনাম, ঐচ্ছিক।
dash_inband_event_stream boolean

dash_inband_event_stream ইঙ্গিত করে যে DAI ইভেন্টস্ট্রিম উপাদান (ইন-মেনিফেস্ট) হিসাবে না হয়ে InbandEventStream উপাদান ব্যবহার করে ইনব্যান্ড ইভেন্ট (ইন-মিডিয়া) হিসাবে ID3 বার্তা সন্নিবেশ করায়।
distinct_ad_profiles boolean

যদি সত্যে সেট করা হয়, তাহলে নির্দেশ করে যে সার্ভারটি অনুরোধ করা এনকোডিং প্রোফাইলের সাথে মিলে যাওয়ার সময় সর্বাধিক একবারে যেকোন উপলব্ধ বিজ্ঞাপন প্রোফাইল ব্যবহার করবে।
tracking_mode string

tracking_mode হল বিজ্ঞাপন ট্র্যাকিং এর ধরন যা স্ট্রীমের জন্য ব্যবহার করা যায়, ঐচ্ছিক। বৈধ মান হল: 'ad_media', 'সার্ভার', 'ক্লায়েন্ট'।
emsg_version uint32

emsg_version একটি নির্দিষ্ট emsg সংস্করণ ইন-মিডিয়া ID3-এর জন্য ব্যবহার করতে বাধ্য করে। শুধুমাত্র ড্যাশ_ইনব্যান্ড_ইভেন্ট_স্ট্রীম সত্য হলেই সমর্থিত।

স্ট্রিম নিবন্ধন অনুরোধ

StreamRegistrationRequest ভবিষ্যতে অ্যাডপড সিদ্ধান্ত নেওয়ার জন্য ডিভাইস থেকে একটি স্ট্রিম নিবন্ধন করে। এটি একটি CreateStreamRequest এর বিপরীতে যা একটি স্ট্রীম তৈরি করে এবং একটি একক অনুরোধে সিদ্ধান্ত গ্রহণ করে৷
JSON প্রতিনিধিত্ব
{
  "targeting_parameters": map[string, string],
  "dai_options": object(StreamRegistrationOptions),
}
ক্ষেত্র
targeting_parameters string

অতিরিক্ত অ্যাড ম্যানেজার টার্গেটিং প্যারাম। ঐচ্ছিক।
dai_options object(StreamRegistrationOptions)

স্ট্রিম নিবন্ধনের জন্য DAIO বিকল্পগুলি।

স্ট্রিম রেজিস্ট্রেশন অপশন

StreamRegistrationOptions স্ট্রিম তৈরির জন্য উপলব্ধ বিকল্পগুলির তালিকা করে৷
JSON প্রতিনিধিত্ব
{
  "sam_id": string,
  "tracking_mode": string,
  "emsg_version": uint32,
  "skippable_ads_supported": boolean,
}
ক্ষেত্র
sam_id string

sam_id হল সেশনের জন্য SAM ডিবাগ কী, ঐচ্ছিক।
tracking_mode string

tracking_mode হল বিজ্ঞাপন ট্র্যাকিং এর ধরন যা স্ট্রীমের জন্য ব্যবহার করা যায়, ঐচ্ছিক। বৈধ মান হল: 'ad_media', 'সার্ভার', 'ক্লায়েন্ট'।
emsg_version uint32

emsg_version একটি নির্দিষ্ট emsg সংস্করণ ইন-মিডিয়া ID3-এর জন্য ব্যবহার করতে বাধ্য করে। শুধুমাত্র ড্যাশ_ইনব্যান্ড_ইভেন্ট_স্ট্রীম সত্য হলেই সমর্থিত।
skippable_ads_supported boolean

এড়িয়ে যাওয়া বিজ্ঞাপন সমর্থিত কিনা তা নির্দেশ করে।

স্ট্রিম নিবন্ধন প্রতিক্রিয়া

StreamRegistrationResponse একটি StreamRegistrationRequest এর জবাবে ক্লায়েন্টকে ফেরত পাঠানো json প্রতিক্রিয়া প্রতিনিধিত্ব করে। এতে স্ট্রিম আইডি এবং ডিভাইসটির প্রয়োজন হবে এমন সমস্ত URL অন্তর্ভুক্ত রয়েছে৷ স্ট্রিম আইডি পরবর্তী অ্যাডপড সিদ্ধান্তের অনুরোধে উল্লেখ করা যেতে পারে। এটি একটি CreateStreamResponse এর বিপরীতে যা একই সময়ে একটি স্ট্রীম তৈরি এবং অ্যাডপড সিদ্ধান্ত নেওয়ার জন্য একটি প্রতিক্রিয়া উপস্থাপন করে।
JSON প্রতিনিধিত্ব
{
  "stream_id": string,
  "media_verification_url": string,
  "valid_for": string,
  "valid_until": string,
  "metadata_url": string,
}
ক্ষেত্র
stream_id string

স্ট্রিমআইডি হল এই দর্শকের বর্তমান স্ট্রীমের অনন্য শনাক্তকারী৷
media_verification_url string

MediaVerificationURL হল URL উপসর্গ যা নীচে বর্ণিত বিজ্ঞাপন মিডিয়া যাচাইকরণের অনুরোধে ব্যবহার করা হবে। ক্লায়েন্ট সাইড বীকনিং স্ট্রীমগুলির জন্য অনুপস্থিত৷
valid_for string

ValidFor হল সেই সময়কাল যার জন্য এই স্ট্রীমটি বৈধ, "00h00m00s" ফর্ম্যাটে৷
valid_until string

ValidUntil হল সেই তারিখ এবং সময় যেখানে এই স্ট্রীমটি বৈধ।
metadata_url string

মেটাডেটা ইউআরএল হল মেটাডেটা ইউআরএল যা অ্যাডপড মেটাডেটা অনুরোধ করতে ব্যবহার করা হবে।

ডিসিশনটাইমিং অপশন

DecisionTimingOptions স্ট্রীমের জন্য অ্যাডব্রেকের সিদ্ধান্ত নেওয়ার সময় বিকল্পগুলি বর্ণনা করে।
JSON প্রতিনিধিত্ব
{
  "type": string,
  "on_create_breaks": [],
}
ক্ষেত্র
type string

টাইপ বর্ণনা করে যখন অ্যাডপডগুলি স্ট্রিমের জন্য সিদ্ধান্ত নেওয়া হয়। বৈধ প্রকারগুলি হল: on_create (ডিফল্ট), অন_ডিমান্ড। যখন টাইপ অন_ডিমান্ড হয়, ম্যানিফেস্টকে একটি নির্দিষ্ট বিরতির জন্য অনুরোধ করা হলে বিজ্ঞাপনগুলি অলসভাবে সিদ্ধান্ত নেওয়া হয়। টাইপ on_create হলে, স্ট্রীম তৈরি হলে বিজ্ঞাপনের সব সিদ্ধান্ত নেওয়া হয়।
on_create_breaks string

OnCreateBreaks হল কেস-সংবেদনশীল VMAP ব্রেকআইডিগুলির একটি তালিকা যা স্ট্রীম তৈরির বিষয়ে সিদ্ধান্ত নেওয়া উচিত। টাইপ অন_ডিমান্ড হলেই এই ক্ষেত্রটি অনুমোদিত। বিশেষ বিজ্ঞাপন বিরতি শনাক্তকারী "প্রিরোল" এবং "পোস্ট্রোল" ব্যবহার করা যেতে পারে যে প্রিরোল বা পোস্টরোল বিরতির সিদ্ধান্ত নেওয়া উচিত স্ট্রীম তৈরির সময়ে।

এনকোডিং প্রোফাইল

EncodingProfile একটি একক বিষয়বস্তুর বৈকল্পিক এনকোডিং বর্ণনা করে। এতে শুধুমাত্র ভিডিও সেটিংস থাকতে পারে, শুধুমাত্র অডিও সেটিংস (মিডিয়া টাইপের ক্ষেত্রে), ভিডিও এবং অডিও সেটিংস উভয়ই থাকতে পারে, অথবা সাবটাইটেলের ক্ষেত্রেও নয়৷
JSON প্রতিনিধিত্ব
{
  "profile_name": string,
  "type": string,
  "container_type": string,
  "video_settings": object(VideoSettings),
  "audio_settings": object(AudioSettings),
  "subtitle_settings": object(SubtitleSettings),
}
ক্ষেত্র
profile_name string

প্রকাশক প্রোফাইলের নাম দিয়েছেন। স্ট্রীম প্রতি অনন্য. প্রয়োজন।
type string

বৈধ প্রকারগুলি হল: মিডিয়া, আইফ্রেম, সাবটাইটেল৷ প্রয়োজন।
container_type string

বৈধ প্রকারগুলি হল: mpeg2ts, fmp4cmaf এবং hls_packed_audio৷ টাইপ মিডিয়া এবং আইফ্রেমের জন্য প্রয়োজনীয়।
video_settings object(VideoSettings)

কন্টেইনারের ধরন iframe হলে ভিডিও সেটিংস প্রয়োজন। অন্যথায়, প্রোফাইলে ভিডিও থাকলেই তারা উপস্থিত থাকে।
audio_settings object(AudioSettings)

প্রোফাইলে অডিও থাকলে অডিও সেটিংস উপস্থিত থাকে। কন্টেইনার টাইপ মিডিয়া হলেই অডিও সেটিংস অনুমোদিত।
subtitle_settings object(SubtitleSettings)

টাইপ সাবটাইটেলের জন্য সাবটাইটেল সেটিংস প্রয়োজন।

ভিডিও সেটিংস

ভিডিও সেটিংস একটি এনকোডিং প্রোফাইলের ভিডিও বর্ণনা করে। যদি একটি ভিডিও সেটিং উপস্থিত থাকে, তবে অবশ্যই উপস্থিত থাকতে হবে৷
JSON প্রতিনিধিত্ব
{
  "codec": string,
  "bitrate": int32,
  "frames_per_second": number,
  "resolution": object(Resolution),
}
ক্ষেত্র
codec string

ভিডিওর RFC6381 কোডেক স্ট্রিং।
bitrate int32

এনকোডিং প্রোফাইলের সর্বোচ্চ ভিডিও বিটরেট।
frames_per_second number

ভিডিওর প্রতি সেকেন্ডে ফ্রেম।
resolution object(Resolution)

ভিডিওর প্রস্থ x উচ্চতা রেজোলিউশন।

অডিও সেটিংস

অডিওসেটিংস একটি এনকোডিং প্রোফাইলের অডিও বর্ণনা করে। একটি অডিও সেটিং উপস্থিত থাকলে, সব উপস্থিত থাকতে হবে৷
JSON প্রতিনিধিত্ব
{
  "codec": string,
  "bitrate": int32,
  "channels": int32,
  "sample_rate": int64,
}
ক্ষেত্র
codec string

অডিওর RFC6381 কোডেক স্ট্রিং।
bitrate int32

এনকোডিং প্রোফাইলের সর্বোচ্চ অডিও বিটরেট।
channels int32

অডিও চ্যানেলের সংখ্যা (নিম্ন ফ্রিকোয়েন্সি চ্যানেল সহ)।
sample_rate int64

অডিওর নমুনা হার, হার্টজে।

সাবটাইটেল সেটিংস

সাবটাইটেল সেটিংস একটি এনকোডিং প্রোফাইলের সাবটাইটেল বর্ণনা করে।
JSON প্রতিনিধিত্ব
{
  "format": string,
  "language": string,
}
ক্ষেত্র
format string

সাবটাইটেলগুলির বিন্যাস: hls-এর জন্য webvtt, ড্যাশের জন্য webvtt বা ttml৷
language string

ম্যানিফেস্টে যে ভাষা ঢোকাতে হবে।

রেজোলিউশন

রেজোলিউশন একটি ভিডিওর প্রস্থ x উচ্চতা বর্ণনা করে।
JSON প্রতিনিধিত্ব
{
  "width": int32,
  "height": int32,
}
ক্ষেত্র
width int32

ভিডিওর প্রস্থ, পিক্সেলে। প্রয়োজন।
height int32

ভিডিওর উচ্চতা, পিক্সেলে। প্রয়োজন।

AdPodDecisionRequest

AdPodDecisionRequest পূর্বে নিবন্ধিত একটি স্ট্রীমের জন্য অ্যাডপডের সিদ্ধান্ত নেওয়ার অনুরোধের প্রতিনিধিত্ব করে।
JSON প্রতিনিধিত্ব
{
  "encoding_profiles": [object(EncodingProfile)],
  "ad_tag": string,
  "cuepoints": [],
  "manifest_type": string,
  "enable_hls_asset_list": boolean,
  "targeting_parameters": map[string, string],
  "content_duration_seconds": number,
  "decision_timing_options": object(DecisionTimingOptions),
  "enable_inline_manifests": boolean,
  "dai_options": object(AdPodDecisionOptions),
}
ক্ষেত্র
encoding_profiles [object(EncodingProfile)]

এনকোডিং প্রোফাইলের একটি তালিকা। প্রয়োজন।
ad_tag string

সিদ্ধান্ত নেওয়ার জন্য বেস বিজ্ঞাপন ট্যাগ। প্রয়োজন।
cuepoints number

কিউপয়েন্টের একটি তালিকা, সেকেন্ডে। বিজ্ঞাপন ট্যাগের প্রতিক্রিয়া যখন অবস্থানগত সময়ের অফসেট ব্যবহার করে তখন প্রয়োজনীয়।
manifest_type string

বৈধ ম্যানিফেস্ট প্রকারগুলি হল: hls এবং ড্যাশ৷ ডিফল্ট: hls. ঐচ্ছিক।
enable_hls_asset_list boolean

HLS সম্পদ তালিকা ইন্টারস্টিশিয়াল সক্ষম করা আছে কিনা তা নির্দেশ করে। সক্রিয় করা হলে, DAI প্রতিটি অ্যাডব্রেকের জন্য সম্পদের তালিকার URL ফিরিয়ে দেবে, যা HLS ইন্টারস্টিশিয়ালগুলির জন্য ব্যবহার করা যেতে পারে।
targeting_parameters string

অতিরিক্ত অ্যাড ম্যানেজার টার্গেটিং প্যারাম। ঐচ্ছিক।
content_duration_seconds number

ContentDurationSeconds হল বিষয়বস্তুর সময়কাল সেকেন্ডে। বিজ্ঞাপন ট্যাগের প্রতিক্রিয়া শতাংশ সময় অফসেট ব্যবহার করলে প্রয়োজনীয়।
decision_timing_options object(DecisionTimingOptions)

কখন অ্যাডপোডের সিদ্ধান্ত নেওয়া উচিত তা নির্দেশ করে।
enable_inline_manifests boolean

JSON প্রতিক্রিয়াতে ব্রেক ম্যানিফেস্ট ইনলাইন করা উচিত কিনা তা নির্দেশ করে।
dai_options object(AdPodDecisionOptions)

বিজ্ঞাপন পড সিদ্ধান্ত জন্য DAIO বিকল্প.

AdPodDecisionResponse

AdPodDecisionResponse পূর্বে নিবন্ধিত স্ট্রীমের জন্য সিদ্ধান্ত অ্যাডপডের প্রতিক্রিয়া উপস্থাপন করে। এতে সেই স্ট্রিমের জন্য সিদ্ধান্ত নেওয়া বিজ্ঞাপন পডগুলির একটি তালিকা রয়েছে৷
JSON প্রতিনিধিত্ব
{
  "valid_for": string,
  "valid_until": string,
  "ad_pods": [object(AdPod)],
}
ক্ষেত্র
valid_for string

ValidFor হল সেই সময়কাল যার জন্য এই স্ট্রীমটি বৈধ, "00h00m00s" ফর্ম্যাটে৷
valid_until string

ValidUntil হল সেই তারিখ এবং সময় যেখানে এই স্ট্রীমটি বৈধ।
ad_pods [object(AdPod)]

সন্নিবেশ ক্রম অনুসারে বিজ্ঞাপন পডের একটি তালিকা।

স্ট্রিম রেসপন্স তৈরি করুন

CreateStreamResponse একটি CreateStreamRequest এর প্রতিক্রিয়া হিসাবে ক্লায়েন্টকে ফেরত পাঠানো json প্রতিক্রিয়া উপস্থাপন করে।
JSON প্রতিনিধিত্ব
{
  "valid_for": string,
  "valid_until": string,
  "ad_pods": [object(AdPod)],
  "stream_id": string,
  "media_verification_url": string,
  "pod_metadata": object(PodMetadata),
  "metadata_url": string,
}
ক্ষেত্র
valid_for string

ValidFor হল সেই সময়কাল যার জন্য এই স্ট্রীমটি বৈধ, "00h00m00s" ফর্ম্যাটে৷
valid_until string

ValidUntil হল সেই তারিখ এবং সময় যেখানে এই স্ট্রীমটি বৈধ।
ad_pods [object(AdPod)]

সন্নিবেশ ক্রম অনুসারে বিজ্ঞাপন পডের একটি তালিকা।
stream_id string

স্ট্রিমআইডি হল এই দর্শকের বর্তমান স্ট্রীমের অনন্য শনাক্তকারী৷
media_verification_url string

MediaVerificationURL হল URL উপসর্গ যা নীচে বর্ণিত বিজ্ঞাপন মিডিয়া যাচাইকরণের অনুরোধে ব্যবহার করা হবে। ক্লায়েন্ট সাইড বীকনিং স্ট্রীমগুলির জন্য অনুপস্থিত৷
pod_metadata object(PodMetadata)

পডমেটাডেটা ডিভাইসে পড রেন্ডার করতে এবং যাচাইকরণ ট্রিগার করতে প্রয়োজনীয় অতিরিক্ত তথ্য ধারণ করে। ডায়নামিক অ্যাড ইনসার্শন লিনিয়ার API ডক্সে বর্ণনা করা হয়েছে। শুধুমাত্র ক্লায়েন্ট সাইড বীকনিং স্ট্রীমের জন্য অন্তর্ভুক্ত।
metadata_url string

মেটাডেটা ইউআরএল হল মেটাডেটা ইউআরএল যা অ্যাডপড মেটাডেটা অনুরোধ করতে ব্যবহার করা হবে।

অ্যাডপড

AdPod প্লেব্যাকের জন্য প্রস্তুত একটি সিদ্ধান্ত নেওয়া বিজ্ঞাপন বিরতির প্রতিনিধিত্ব করে।
JSON প্রতিনিধিত্ব
{
  "manifest_uris": map[string, string],
  "multivariant_uri": string,
  "mpd_uri": string,
  "manifests": map[string, string],
  "multivariant_manifest": string,
  "mpd_manifest": string,
  "asset_list_uri": string,
  "start": number,
  "duration": number,
  "type": string,
  "midroll_index": number,
}
ক্ষেত্র
manifest_uris string

ManifestURIs হল HLS বিষয়বস্তুর জন্য HLS ভেরিয়েন্ট manifest_uris-এ প্রোফাইল নাম এনকোড করার একটি মানচিত্র।
multivariant_uri string

মাল্টিভেরিয়েন্ট ইউআরআই হল HLS কন্টেন্টের মাল্টিভেরিয়েন্ট ম্যানিফেস্টের URI।
mpd_uri string

MPDURI হল DASH সামগ্রীর জন্য MPD-এর URI৷
manifests string

ম্যানিফেস্ট হল HLS ভেরিয়েন্ট ম্যানিফেস্টে প্রোফাইল নাম এনকোড করার একটি মানচিত্র। স্ট্রীমটিতে enable_inline_manifests সত্য সেট করা থাকলেই কেবল জনসংখ্যা হয়৷
multivariant_manifest string

মাল্টিভেরিয়েন্ট ম্যানিফেস্ট হল HLS কন্টেন্টের জন্য মাল্টিভেরিয়েন্ট ম্যানিফেস্ট। স্ট্রীমটিতে enable_inline_manifests সত্য সেট করা থাকলেই কেবল জনসংখ্যা হয়৷
mpd_manifest string

MPDMmanifest হল DASH সামগ্রীর জন্য MPD ম্যানিফেস্ট৷ স্ট্রীমটিতে enable_inline_manifests সত্য সেট করা থাকলেই কেবল জনসংখ্যা হয়৷
asset_list_uri string

AssetListURI হল HLS কন্টেন্টের জন্য HLS ইন্টারস্টিশিয়াল অ্যাসেট-লিস্টের URI। স্ট্রীমটিতে HLS সম্পদ-তালিকা ইন্টারস্টিশিয়াল সক্ষম থাকলেই জনসংখ্যা হয়।
start number

সম্পদের টাইমলাইনে বিজ্ঞাপন পডের শুরুর সময় (পূর্ববর্তী বিজ্ঞাপন পডগুলি অন্তর্ভুক্ত না করে) ফ্লোটিং পয়েন্ট সেকেন্ডে।
duration number

ফ্লোটিং পয়েন্ট সেকেন্ডে বিজ্ঞাপন পডের সময়কাল।
type string

বিজ্ঞাপন বিরতির ধরন।
midroll_index number

VMAP ব্রেক আইডির উপর ভিত্তি করে একটি স্ট্রীমে মিডরোলগুলির 1-ভিত্তিক সূচক। প্রিরোল এবং পোস্টরোলের জন্য বাদ দেওয়া হয়েছে।

AdPodDecisionOptions

AdPodDecisionOptions স্ট্রিমের জন্য অতিরিক্ত বিকল্প উপস্থাপন করে।
JSON প্রতিনিধিত্ব
{
  "dash_profile": string,
  "match_options": object(MatchOpts),
  "data_sharing_policy_code": string,
  "sam_id": string,
  "session_title": string,
  "dash_inband_event_stream": boolean,
  "distinct_ad_profiles": boolean,
}
ক্ষেত্র
dash_profile string

MPEG-DASH প্রোফাইল ব্যবহার করার জন্য, 'লাইভ' বা 'অন-ডিমান্ড'।
match_options object(MatchOpts)

data_sharing_policy_code string

প্রকাশকদের নেটওয়ার্ক ডিফল্ট ডেটা শেয়ারিং নীতি ওভাররাইড করার অনুমতি দেয়৷
sam_id string

sam_id হল সেশনের জন্য SAM ডিবাগ কী, ঐচ্ছিক।
session_title string

session_title হল স্ট্রিমের জন্য SAM সেশন শিরোনাম, ঐচ্ছিক।
dash_inband_event_stream boolean

dash_inband_event_stream ইঙ্গিত করে যে DAI ইভেন্টস্ট্রিম উপাদান (ইন-মেনিফেস্ট) হিসাবে না হয়ে InbandEventStream উপাদান ব্যবহার করে ইনব্যান্ড ইভেন্ট (ইন-মিডিয়া) হিসাবে ID3 বার্তা সন্নিবেশ করায়।
distinct_ad_profiles boolean

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

প্রবাহ

JSON ফর্ম্যাটে একটি নতুন তৈরি স্ট্রিমের জন্য সমস্ত সংস্থানগুলির একটি তালিকা রেন্ডার করতে স্ট্রিম ব্যবহার করা হয়।
JSON প্রতিনিধিত্ব
{
  "stream_id": string,
  "valid_for": string,
  "valid_until": string,
  "media_verification_url": string,
}
ক্ষেত্র
stream_id string

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

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

RFC 3339 ফর্ম্যাটে স্ট্রীমটি বৈধ হওয়ার তারিখ৷
media_verification_url string

মিডিয়া যাচাইকরণ 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

ট্র্যাকিং ইভেন্টের ধরন।
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 অ্যাট্রিবিউট যদি এটি স্ট্যাটিক টাইপের সহচর হয়।
height int32

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

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

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

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

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

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

এই সঙ্গীর জন্য ট্র্যাকিং ইভেন্টের তালিকা।

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

ইন্টারেক্টিভফাইলে ইন্টারেক্টিভ ক্রিয়েটিভ (অর্থাৎ 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> নোডের মান।