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

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

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

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

পদ্ধতি: স্ট্রিম

পদ্ধতি
stream POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

লাইভস্ট্রিম সেশন পরিবেশনকারী একটি DAI পড নিবন্ধন করে।

HTTP অনুরোধ 

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

পথের পরামিতি

পরামিতি
network_code string

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

custom_asset_key string

Google বিজ্ঞাপন ম্যানেজারে এই ইভেন্টের সাথে সম্পর্কিত কাস্টম শনাক্তকারী।

অনুরোধের মূল অংশ

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

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

প্রতিক্রিয়া মূল অংশ

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

পরিমাপ খুলুন

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

পদ্ধতি: পড সেগমেন্ট

পদ্ধতি
pod segment GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

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

HTTP অনুরোধ 

GET https://dai.google.com/linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

পথের পরামিতি

পরামিতি
network_code string

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

custom_asset_key string

Google বিজ্ঞাপন ম্যানেজারে এই ইভেন্টের সাথে সম্পর্কিত কাস্টম শনাক্তকারী।

pod_identifier

নিম্নলিখিত ফর্ম্যাটগুলি সমর্থিত:

pod/{integer}

বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক শনাক্তকারী। প্রতিটি বিজ্ঞাপন বিরতি ইভেন্টের জন্য অ্যাড পড আইডি ক্রমবর্ধমানভাবে বরাদ্দ করা হয়, 1 থেকে শুরু করে।

ad_break_id/{string}

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

কাস্টম অ্যাডব্রেক আইডির ক্ষেত্রে নিম্নলিখিত বিধিনিষেধ প্রযোজ্য:

  • ১ থেকে ৬৩ অক্ষরের মধ্যে হতে হবে
  • শুধুমাত্র ছোট হাতের অক্ষর, সংখ্যা এবং হাইফেন থাকতে হবে।
profile_name string

অনুরোধ করা Google বিজ্ঞাপন ম্যানেজার DAI এনকোডিং প্রোফাইলের নাম । এনকোডিং প্রোফাইলটি নির্বাচিত ইভেন্টের জন্য কনফিগার করা এনকোডিং প্রোফাইলগুলির মধ্যে একটি হতে হবে।

segment_number integer

বর্তমান বিজ্ঞাপন পডের মধ্যে অনুরোধকৃত অংশের সূচক, শূন্য থেকে শুরু।

segment_format string

অনুরোধকৃত সেগমেন্ট ফর্ম্যাটের সাথে সম্পর্কিত ফাইল এক্সটেনশন। গৃহীত এক্সটেনশনগুলি হল: ts , mp4 , vtt , aac , ac3 বা eac3 ।

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

পরামিতি
stream_id প্রয়োজনীয় string

বর্তমান ব্যবহারকারীর সেশনের স্ট্রিম আইডি। stream এন্ডপয়েন্টে একটি সফল অনুরোধের মাধ্যমে এই মানটি ফেরত পাঠানো হয়।

sd required 1 integer

অনুরোধকৃত অংশের সময়কাল, মিলিসেকেন্ডে।

so ঐচ্ছিক

অ্যাড পডের মধ্যে অনুরোধকৃত সেগমেন্টের অফসেট, মিলিসেকেন্ডে। যদি আপনি so প্যারামিটারটি বাদ দেন, তাহলে সেগমেন্টের সময়কালকে সেগমেন্ট সংখ্যা দিয়ে গুণ করে এটি গণনা করা হবে।

pd প্রয়োজন ২ integer

মিলিসেকেন্ডে অ্যাড পডের সময়কাল।

auth-token প্রয়োজনীয় string

auth-token নিম্নলিখিত তথ্য সহ একটি এনকোডেড HMAC টোকেন থাকে:

  • pod_id অথবা ad_break_id
  • network_code
  • custom_asset_key
  • cust_params
  • pd
  • scte35
  • exp
last ঐচ্ছিক boolean

বিজ্ঞাপন বিরতির শেষ অংশটি নির্দেশ করে। অন্যান্য সমস্ত অংশের জন্য এই প্যারামিটারটি বাদ দিন।

scte35 ঐচ্ছিক string

এই বিজ্ঞাপন বিরতির জন্য Base64-এনকোডেড SCTE-35signal।

cust_params ঐচ্ছিক string

বিজ্ঞাপন ম্যানেজার ক্যাম্পেইন টার্গেটিং এর জন্য ব্যবহৃত কী-মান জোড়ার একটি সেট। এই জোড়াগুলিকে অবশ্যই একটি url-এনকোডেড কোয়েরি স্ট্রিং হিসেবে উপস্থাপন করতে হবে।

উদাহরণ:
পরামিতি
  • বিভাগ = sports
  • পাতা = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

পাদটীকা

  1. আরম্ভিক অংশগুলির জন্য sd প্রয়োজন হয় না। ↩
  2. সময়কালহীন বিজ্ঞাপন বিরতি সক্ষম থাকা ইভেন্টগুলির জন্য pd প্রয়োজন হয় না। ↩

উদাহরণ

https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbreak-2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST পান

https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST পান

প্রতিক্রিয়া মূল অংশ

যদি সফল হয়, তাহলে রেসপন্স বডিটি একটি প্লেযোগ্য স্ট্রিম সেগমেন্ট হবে যা অনুরোধে উল্লেখিত ফর্ম্যাট এবং প্যারামিটারের সাথে মিলে যাবে।

পদ্ধতি: HLS পড ম্যানিফেস্ট

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

পদ্ধতি
GET GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/{pod_identifier}.m3u8;

একটি বিজ্ঞাপন পডের জন্য একটি HLS মাল্টিভেরিয়েন্ট প্লেলিস্ট পুনরুদ্ধার করার জন্য API।

HTTP অনুরোধ 

GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}.m3u8?stream_id={stream_id}&pd={pod_duration}

পথের পরামিতি

পরামিতি
network_code string

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

custom_asset_key string

Google বিজ্ঞাপন ম্যানেজারে এই ইভেন্টের সাথে সম্পর্কিত কাস্টম শনাক্তকারী

pod_identifier

নিম্নলিখিত ফর্ম্যাটগুলি সমর্থিত:

pod/{integer}

বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক শনাক্তকারী। প্রতিটি বিজ্ঞাপন বিরতি ইভেন্টের জন্য অ্যাড পড আইডি ক্রমবর্ধমানভাবে বরাদ্দ করা হয়, 1 থেকে শুরু করে।

ad_break_id/{string}

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

কাস্টম অ্যাডব্রেক আইডির ক্ষেত্রে নিম্নলিখিত বিধিনিষেধ প্রযোজ্য:

  • ১ থেকে ৬৩ অক্ষরের মধ্যে হতে হবে
  • শুধুমাত্র ছোট হাতের অক্ষর, সংখ্যা এবং হাইফেন থাকতে হবে।

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

পরামিতি
stream_id প্রয়োজনীয় string

বর্তমান ব্যবহারকারীর সেশনের স্ট্রিম আইডি। stream এন্ডপয়েন্টে একটি সফল অনুরোধের মাধ্যমে এই মানটি ফেরত পাঠানো হয়।

pd প্রয়োজনীয় integer

মিলিসেকেন্ডে অ্যাড পডের সময়কাল।

scte35 ঐচ্ছিক string

এই বিজ্ঞাপন বিরতির জন্য Base64-এনকোডেড SCTE-35signal।

cust_params ঐচ্ছিক string

বিজ্ঞাপন ম্যানেজার ক্যাম্পেইন টার্গেটিং এর জন্য ব্যবহৃত কী-মান জোড়ার একটি সেট। এই জোড়াগুলিকে অবশ্যই একটি url-এনকোডেড কোয়েরি স্ট্রিং হিসেবে উপস্থাপন করতে হবে।

উদাহরণ:
পরামিতি
  • বিভাগ = sports
  • পাতা = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...
auth-token প্রয়োজনীয় string

auth-token নিম্নলিখিত তথ্য সহ একটি এনকোডেড HMAC টোকেন থাকে:

  • pod_id অথবা ad_break_id
  • network_code
  • custom_asset_key
  • cust_params
  • pd
  • scte35
  • exp

প্রতিক্রিয়া মূল অংশ

যদি সফল হয়, তাহলে রেসপন্স বডিটি একটি HLS মাল্টিভেরিয়েন্ট প্লেলিস্ট হবে।

পদ্ধতি: DASH পড ম্যানিফেস্ট

একটি লাইভস্ট্রিমের একটি MPEG-DASH বিজ্ঞাপন পড ম্যানিফেস্ট পুনরুদ্ধার করে যা একটি ক্লায়েন্ট ভিডিও প্লেয়ার লোড এবং চালানোর জন্য প্রস্তুত।

পদ্ধতি
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/{pod_identifier}/manifest.mpd

একটি বিজ্ঞাপন পডের জন্য একটি MPEG-DASH mpd প্লেলিস্ট পুনরুদ্ধার করার জন্য API।

HTTP অনুরোধ 

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/stream/{stream_id}/pod/{pod_id}/manifest.mpd?pd={pod_duration}

পথের পরামিতি

পরামিতি
network_code string

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

custom_asset_key string

Google বিজ্ঞাপন ম্যানেজারে এই ইভেন্টের সাথে সম্পর্কিত কাস্টম শনাক্তকারী

stream_id string

বর্তমান ব্যবহারকারীর সেশনের স্ট্রিম আইডি। stream এন্ডপয়েন্টে একটি সফল অনুরোধের মাধ্যমে এই মানটি ফেরত পাঠানো হয়।

pod_identifier

নিম্নলিখিত ফর্ম্যাটগুলি সমর্থিত:

pod/{integer}

বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক শনাক্তকারী। প্রতিটি বিজ্ঞাপন বিরতি ইভেন্টের জন্য অ্যাড পড আইডি ক্রমবর্ধমানভাবে বরাদ্দ করা হয়, 1 থেকে শুরু করে।

ad_break_id/{string}

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

কাস্টম অ্যাডব্রেক আইডির ক্ষেত্রে নিম্নলিখিত বিধিনিষেধ প্রযোজ্য:

  • ১ থেকে ৬৩ অক্ষরের মধ্যে হতে হবে
  • শুধুমাত্র ছোট হাতের অক্ষর, সংখ্যা এবং হাইফেন থাকতে হবে।

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

পরামিতি
pd প্রয়োজনীয় integer

মিলিসেকেন্ডে অ্যাড পডের সময়কাল।

scte35 ঐচ্ছিক string

এই বিজ্ঞাপন বিরতির জন্য Base64-এনকোডেড SCTE-35signal।

cust_params ঐচ্ছিক string

বিজ্ঞাপন ম্যানেজার ক্যাম্পেইন টার্গেটিং এর জন্য ব্যবহৃত কী-মান জোড়ার একটি সেট। এই জোড়াগুলিকে অবশ্যই একটি url-এনকোডেড কোয়েরি স্ট্রিং হিসেবে উপস্থাপন করতে হবে।

উদাহরণ:
পরামিতি
  • বিভাগ = sports
  • পাতা = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...
auth-token প্রয়োজনীয় string

auth-token নিম্নলিখিত তথ্য সহ একটি এনকোডেড HMAC টোকেন থাকে:

  • pod_id অথবা ad_break_id
  • network_code
  • custom_asset_key
  • cust_params
  • pd
  • scte35
  • exp

প্রতিক্রিয়া মূল অংশ

যদি সফল হয়, তাহলে রেসপন্স বডিটি একটি MPEG-DASH mpd প্লেলিস্ট হবে।

পদ্ধতি: DASH পড পিরিয়ড টেমপ্লেট

পদ্ধতি
pods GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Google Ad Manager থেকে একটি DASH পিরিয়ড টেমপ্লেটের অনুরোধ করছে। এই টেমপ্লেটে ম্যাক্রো রয়েছে যা আপনাকে আপনার স্ট্রিম প্যারামিটার দিয়ে পূরণ করতে হবে। এই ম্যাক্রোগুলি পূরণ হয়ে গেলে, টেমপ্লেটটি আপনার বিজ্ঞাপন বিরতির সময় হয়ে ওঠে এবং আপনার DASH ম্যানিফেস্টে সেলাই করা যেতে পারে।

HTTP অনুরোধ 

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

পথের পরামিতি

পরামিতি
network_code string

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

custom_asset_key string

Google বিজ্ঞাপন ম্যানেজারে এই ইভেন্টের সাথে সম্পর্কিত কাস্টম শনাক্তকারী।

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

পরামিতি
stream_id প্রয়োজনীয় string

বর্তমান ব্যবহারকারীর সেশনের স্ট্রিম আইডি। stream এন্ডপয়েন্টে একটি সফল অনুরোধের মাধ্যমে এই মানটি ফেরত পাঠানো হয়।

tv ঐচ্ছিক integer

টেমপ্লেট সংস্করণ। ডিফল্ট 0 ফেরত পাঠানোর জন্য পড টেমপ্লেট সংস্করণ নির্দিষ্ট করে।

  • 0 : পড সিকোয়েন্স আইডেন্টিফায়ার ব্যবহার করে এমন একটি টেমপ্লেটের অনুরোধ করে।
  • 1 : এমন একটি টেমপ্লেটের অনুরোধ করে যা পড সিকোয়েন্স এবং অ্যাড ব্রেক আইডেন্টিফায়ার উভয়কেই সমর্থন করে।

প্রতিক্রিয়া মূল অংশ

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

পদ্ধতি: অ্যাড পড টাইমিং মেটাডেটা

পদ্ধতি
ad pod timing metadata GET /linear/pods/v1/adv/network/{network_code}/custom_asset/{custom_asset_key}/pod.json

অ্যাড পড টাইমিং মেটাডেটা পুনরুদ্ধার করে।

HTTP অনুরোধ 

GET https://dai.google.com/linear/pods/v1/adv/network/{network_code}/custom_asset/{custom_asset_key}/pod.json

পথের পরামিতি

পরামিতি
network_code string

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

custom_asset_key string

Google বিজ্ঞাপন ম্যানেজারে এই লাইভস্ট্রিমের সাথে যুক্ত কাস্টম শনাক্তকারী।

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

পরামিতি
stream_id প্রয়োজনীয় string

ক্লায়েন্ট ভিডিও প্লেয়ার অ্যাপের বিজ্ঞাপন ম্যানেজার স্ট্রিম আইডি।

ad_break_id প্রয়োজনীয় string

পরবর্তী আসন্ন বিজ্ঞাপন বিরতি আইডি।

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

কাস্টম অ্যাডব্রেক আইডির ক্ষেত্রে নিম্নলিখিত বিধিনিষেধ প্রযোজ্য:

  • ১ থেকে ৬৩ অক্ষরের মধ্যে হতে হবে
  • শুধুমাত্র ছোট হাতের অক্ষর, সংখ্যা এবং হাইফেন থাকতে হবে।
  • অ্যাড ব্রেক আইডি preroll প্রিরোল অ্যাড পড পুনরুদ্ধারের জন্য সংরক্ষিত। এটি অন্য কোনও অ্যাড পড সনাক্ত করতে ব্যবহার করা যাবে না।
auth-token প্রয়োজনীয় string

auth-token নিম্নলিখিত তথ্য সহ একটি এনকোডেড HMAC টোকেন থাকে:

  • ad_break_id
  • network_code
  • custom_asset_key
  • cust_params
  • pd
  • scte35
  • exp
timeout ঐচ্ছিক integer

বিজ্ঞাপনের সিদ্ধান্তের জন্য অপেক্ষা করার জন্য DAI এই অনুরোধটি কত মিলিসেকেন্ডে ব্লক করতে পারে। প্রি-রোল বিজ্ঞাপন বিরতির মতো, প্রথম অনুরোধে যেসব অনুরোধে বিজ্ঞাপন দেখাতে হবে, সেইসব অনুরোধের ক্ষেত্রে এই প্যারামিটারটি ব্যবহার করুন।

যদি সময়সীমা অতিক্রম করা হয়, তাহলে অনুরোধটি মুলতুবি অবস্থা ফেরত পাঠাবে।

যদি অন্তর্ভুক্ত করা হয়, তাহলে টাইমআউট মান অবশ্যই ১০০০ থেকে ১৫০০০ মিলিসেকেন্ডের মধ্যে হতে হবে। যদি বাদ দেওয়া হয়, তাহলে বিজ্ঞাপনের সিদ্ধান্তের জন্য অপেক্ষা করার জন্য প্রতিক্রিয়াগুলিকে বিলম্বিত করা হবে না।

final ঐচ্ছিক boolean

এই বিজ্ঞাপন পডের জন্য VTP যে শেষ অনুরোধটি করতে ইচ্ছুক, তা DAI-কে বোঝাতে true সেট করুন। যদি বিজ্ঞাপনের সিদ্ধান্ত এখনও উপলব্ধ না হয় (ঐচ্ছিক সময়সীমার মধ্যে), তাহলে DAI এই অনুরোধের জন্য স্থায়ীভাবে স্লেট ফেরত দেবে।

ডিফল্ট হিসেবে false থাকে।

বিজ্ঞাপন সিদ্ধান্ত নেওয়ার প্যারামিটার

pd ঐচ্ছিক integer

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

যদি EABN ব্যবহার করা হয়, তাহলে pd মানটি অবশ্যই আপনার বিজ্ঞাপন বিরতির বিজ্ঞপ্তিতে প্রদত্ত সময়কালের সাথে মিলতে হবে। যদি সময়কালগুলি মিল না করে, তাহলে EABN মানটিকে অগ্রাধিকার দেওয়া হবে।

cust_params ঐচ্ছিক string

বিজ্ঞাপন ম্যানেজার সহায়তা কেন্দ্রে বর্ণিত বিজ্ঞাপন বিরতি লক্ষ্যবস্তুর জন্য কাস্টম প্যারামিটার।

scte35 ঐচ্ছিক string

একটি base64-এনকোডেড SCTE-35 সিগন্যাল।

যদি সিগন্যালটি অবৈধ হয়, তাহলে প্রতিক্রিয়ার X-Ad-Manager-Dai-Warning HTTP হেডারে একটি বার্তা পাঠানো হবে এবং অনুরোধটি অবৈধ scte35 মান ছাড়াই পাঠানো হবে।

প্রতিক্রিয়া মূল অংশ

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

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

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

media verification শেষ বিন্দুতে অনুরোধগুলি অযোগ্য।

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

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

HTTP অনুরোধ 

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

প্রতিক্রিয়া মূল অংশ

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

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

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

বিজ্ঞাপন মিডিয়া শনাক্তকারীগুলিকে একটি পৃথক মেটাডেটা ট্র্যাকে এনকোড করা হবে — HLS ট্রান্সপোর্ট স্ট্রিমের জন্য টাইমড মেটাডেটা, অথবা mp4 ফাইলের জন্য emsg। বিজ্ঞাপন মিডিয়া শনাক্তকারীরা সর্বদা 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}

প্রতিক্রিয়া মূল অংশ

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

মেটাডেটা পার্সিং

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

google_1234567890

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

API অবজেক্টস

প্রবাহ

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

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

প্লেব্যাক ইভেন্ট ট্র্যাক করার জন্য বেস এন্ডপয়েন্ট হিসেবে ব্যবহৃত মিডিয়া যাচাইকরণ URL।
metadata_url string

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

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

সার্ভার সাইড বিকনিং স্ট্রিমকে জীবন্ত রাখতে ব্যবহৃত হার্টবিট URL, এটি প্রতি {PollingFrequency} সেকেন্ডে পিং করতে হবে। সার্ভার সাইড বিকনিং স্ট্রিমগুলির জন্য পূর্ণ।
polling_frequency number

মেটাডেটা_ইউআরএল বা হার্টবিট_ইউআরএল অনুরোধ করার সময়, সেকেন্ডে ভোটদানের ফ্রিকোয়েন্সি।
pod_manifest_url string

পড ম্যানিফেস্ট URL টেমপ্লেটটি একটি স্ট্রিমের পড ম্যানিফেস্ট পুনরুদ্ধার করার জন্য URL তৈরি করতে ব্যবহৃত হয়, যা HLS-এ মাল্টিভেরিয়েন্ট প্লেলিস্টের URL বা DASH-এ MPD-এর সাথে সম্পর্কিত। POD_SERVING_MANIFEST টাইপের ডাইনামিক অ্যাড ইনসার্শনের লাইভস্ট্রিম ইভেন্টের জন্য পপুলেট করা হয়েছে। https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType
manifest_format string

ম্যানিফেস্ট ফর্ম্যাট হল pod_manifest_url থেকে প্রাপ্ত ম্যানিফেস্টের ফর্ম্যাট, হয় ড্যাশ অথবা hls।

পডমেটাডেটা

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

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

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

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

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

TagSegment-এ একটি বিজ্ঞাপন, তার বিজ্ঞাপন বিরতি এবং ইভেন্টের ধরণের রেফারেন্স থাকে। 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

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

ঐচ্ছিক ক্লিক ট্র্যাকিং URL গুলি।
verifications [object(Verification)]

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

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

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

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

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

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

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

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

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

PodTemplateResponse পড সেলাইয়ের জন্য একটি VTP-তে ফেরত পাঠানো JSON পেলোডকে প্রতিনিধিত্ব করে।
JSON উপস্থাপনা
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
ক্ষেত্র
dash_period_template string

DashPeriodTemplate হল xml টেমপ্লেট যার মাধ্যমে সেলাই করার আগে পিরিয়ডটি যথাযথ ডেটা দিয়ে পূরণ করতে হবে।
segment_duration_ms int64

সেগমেন্টড্যুরেশনএমএস হলো মিলিসেকেন্ডে পিরিয়ড সেগমেন্টের সময়কাল।

অ্যাডপডটাইমিংমেটাডেটাপ্রতিক্রিয়া

AdpodTimingMetadataResponse-এ Ad Pod এবং এর জন্য সেগমেন্ট URL তৈরি করার পদ্ধতি সম্পর্কে তথ্য রয়েছে।
JSON উপস্থাপনা
{
  "status": string,
  "ads": [object(AdRendering)],
  "slate": object(SlateRendering),
  "dash_representations": map[string, object(DASHRepresentation)],
  "dash_adaptation_sets": map[string, object(DASHAdaptationSet)],
}
ক্ষেত্র
status string

বিজ্ঞাপন পডের সিদ্ধান্তের অবস্থা।
ads [object(AdRendering)]

বিজ্ঞাপনের অবজেক্টের অ্যারে যেখানে বিজ্ঞাপন বিভাগের ইউআরএলগুলি কীভাবে রেন্ডার করতে হয় তা বর্ণনা করা হয়েছে, 0 থেকে শুরু করে সূচীবদ্ধ করা হয়েছে।
slate object(SlateRendering)

স্লেট সেগমেন্টের ইউআরএলগুলি কীভাবে রেন্ডার করতে হয় তা বর্ণনা করছে।
dash_representations map[string, object(DASHRepresentation)]

DASH ম্যানিফেস্টে রেন্ডার করা বিজ্ঞাপন পডের জন্য DASH প্রতিনিধিত্বের তালিকা।
dash_adaptation_sets map[string, object(DASHAdaptationSet)]

DASH ম্যানিফেস্টে রেন্ডার করা বিজ্ঞাপন পডের জন্য DASH অভিযোজন সেটের তালিকা।

অ্যাডরেন্ডারিং

অ্যাডরেন্ডারিং বর্ণনা করে কিভাবে একটি সিদ্ধান্ত নেওয়া বিজ্ঞাপন রেন্ডার করতে হয়।
JSON উপস্থাপনা
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
ক্ষেত্র
duration_ms number

বিজ্ঞাপনের সময়কাল, মিলিসেকেন্ডে (int)।
variants map[string, object(VariantRendering)]

UI থেকে কনফিগার করা ভেরিয়েন্ট/প্রোফাইল আইডি দ্বারা সূচীকৃত ভেরিয়েন্ট অবজেক্টের অভিধান (নীচে দেখুন)।

স্লেটরেন্ডারিং

স্লেটরেন্ডারিং বর্ণনা করে কিভাবে স্লেট কন্টেন্ট রেন্ডার করতে হয়।
JSON উপস্থাপনা
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
ক্ষেত্র
duration_ms number

স্লেটের সময়কাল, মিলিসেকেন্ডে (int)।
variants map[string, object(VariantRendering)]

ভেরিয়েন্ট/প্রোফাইল আইডি অনুসারে সূচীকৃত ভেরিয়েন্ট অবজেক্টের অভিধান। স্লেটের সময়কালগুলি প্রয়োজনীয় স্লেট দৈর্ঘ্যে পৌঁছানো পর্যন্ত লুপ করতে হবে, পুনরাবৃত্তির মধ্যে HLS বিচ্ছিন্নতা সন্নিবেশ করাতে হবে, অথবা MPEG-DASH-এর জন্য নতুন পিরিয়ড লুপ করতে হবে।

বৈকল্পিক রেন্ডারিং

ভ্যারিয়েন্টরেন্ডারিং বিজ্ঞাপন/স্লেটের মধ্যে একটি ভ্যারিয়েন্ট/প্রোফাইল বর্ণনা করে।
JSON উপস্থাপনা
{
  "segment_extension": string,
  "segment_durations": object(SegmentDurations),
}
ক্ষেত্র
segment_extension string

স্ট্রিং, এর মধ্যে একটি: ts, mp4, aac, ac3, ec3, m4a, m4v। ফাইলের নাম এক্সটেনশন অংশ URL গুলির অংশ।
segment_durations object(SegmentDurations)

সেগমেন্টড্যুরেশন অবজেক্ট। প্রতিটি সেগমেন্টের সময়কাল একটি সেগমেন্ট URL-এ অনুবাদ করা যেতে পারে।

বিভাগসময়কাল

সেগমেন্টড্যুরেশন একটি নির্দিষ্ট সময় ইউনিটে সেগমেন্টের ক্রমের সময়কাল বর্ণনা করে।
JSON উপস্থাপনা
{
  "timescale": number,
  "values": [],
}
ক্ষেত্র
timescale number

টাইমস্কেল হল প্রতি সেকেন্ডে ইউনিটের সংখ্যা (int) প্রত্যাশিত: HLS এর জন্য 1000 (মিলিসেকেন্ড) DASH ভিডিওর জন্য 90000 (PTS) DASH অডিওর জন্য অডিও নমুনা হার।
values number

টাইমস্কেল ইউনিটে, int সেগমেন্টের সময়কালের অ্যারে।

DASHপ্রতিনিধিত্ব

DASHRepresentation DASH ম্যানিফেস্টে রেন্ডার করা প্রতিনিধিত্ব নোডগুলিকে বর্ণনা করে।
JSON উপস্থাপনা
{
  "codecs": string,
  "bandwidth": number,
  "width": number,
  "height": number,
  "frame_rate": string,
  "audio_sampling_rate": number,
  "audio_channel_config": object(SchemeIDURIAndValue),
}
ক্ষেত্র
codecs string

উপস্থাপনার কোডেক।
bandwidth number

উপস্থাপনার ব্যান্ডউইথ।
width number

উপস্থাপনার প্রস্থ।
height number

উপস্থাপনার উচ্চতা।
frame_rate string

উপস্থাপনার ফ্রেম রেট।
audio_sampling_rate number

উপস্থাপনার অডিও নমুনা হার।
audio_channel_config object(SchemeIDURIAndValue)

উপস্থাপনার অডিও চ্যানেল কনফিগারেশন।

DASHAডাপ্টেশনসেট

DASHAdaptationSet DASH ম্যানিফেস্টে রেন্ডার করা AdaptationSet নোডগুলি বর্ণনা করে।
JSON উপস্থাপনা
{
  "content_type": string,
  "mime_type": string,
  "role": object(SchemeIDURIAndValue),
  "inband_event_stream": object(SchemeIDURIAndValue),
  "min_frame_rate": string,
  "max_frame_rate": string,
  "scan_type": string,
  "start_with_sap": string,
  "segment_alignment": boolean,
  "representations": [],
}
ক্ষেত্র
content_type string

অভিযোজন সেটের বিষয়বস্তুর ধরণ।
mime_type string

অভিযোজন সেটের MIME প্রকার।
role object(SchemeIDURIAndValue)

অভিযোজন সেটের ভূমিকা।
inband_event_stream object(SchemeIDURIAndValue)

অভিযোজন সেটের ইনব্যান্ড ইভেন্ট স্ট্রিম।
min_frame_rate string

অভিযোজন সেটের সর্বনিম্ন ফ্রেম রেট।
max_frame_rate string

অভিযোজন সেটের সর্বোচ্চ ফ্রেম রেট।
scan_type string

অভিযোজন সেটের স্ক্যানের ধরণ।
start_with_sap string

অভিযোজন সেটের SAP দিয়ে শুরু করুন।
segment_alignment boolean

অভিযোজন সেটের সেগমেন্ট সারিবদ্ধকরণ।
representations string

অভিযোজন সেটের উপস্থাপনা।

স্কিমআইডিইউআরআইএবংমান

SchemeIDURIAndValue হল একটি স্কিম আইডি এবং এর মানের একজোড়া।
JSON উপস্থাপনা
{
  "scheme_id_uri": string,
  "value": string,
}
ক্ষেত্র
scheme_id_uri string

মানের স্কিম আইডি URI।
value string

স্কিমের মান আইডি ইউআরআই।

আইকন

আইকনে একটি 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-এ JavaScript এর মাধ্যমে যাচাইকরণের জন্য তথ্য রয়েছে।
JSON উপস্থাপনা
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
ক্ষেত্র
script_url string

জাভাস্ক্রিপ্ট পেলোডে URI।
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

এই সঙ্গীর ধরণ। এটি স্ট্যাটিক, আইফ্রেম অথবা HTML হতে পারে।
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> নোডের মান।