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

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

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

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

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

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

লাইভস্ট্রিম সেশন পরিবেশনকারী একটি DAI 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 প্রয়োজনীয় 2 integer

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

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

বর্তমান বিজ্ঞাপন পডের জন্য একটি স্বাক্ষরিত, url-এনকোড করা HMAC টোকেন

last ঐচ্ছিক boolean

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

scte35 ঐচ্ছিক string

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

cust_params ঐচ্ছিক string

Ad Manager প্রচারাভিযান টার্গেটিং এর জন্য ব্যবহৃত মূল-মান জোড়ার একটি সেট। এই জোড়া একটি 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/8b8888cf79ad43f0800482ffcts_ts_ts_1035a? =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_ts&0p0d=0d_so=? =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/{pod_id}.m3u8;

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

HTTP অনুরোধ

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

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

পরামিতি
network_code string

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

custom_asset_key string

কাস্টম শনাক্তকারী Google অ্যাড ম্যানেজারে এই ইভেন্টটিকে যুক্ত করেছে৷

pod_id integer

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

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

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

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

pd প্রয়োজন integer

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

scte35 ঐচ্ছিক string

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

cust_params ঐচ্ছিক string

Ad Manager প্রচারাভিযান টার্গেটিং এর জন্য ব্যবহৃত মূল-মান জোড়ার একটি সেট। এই জোড়া একটি url-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে উপস্থাপন করা আবশ্যক.

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

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

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

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

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

পদ্ধতি
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/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_id integer

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

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

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

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

scte35 ঐচ্ছিক string

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

cust_params ঐচ্ছিক string

Ad Manager প্রচারাভিযান টার্গেটিং এর জন্য ব্যবহৃত মূল-মান জোড়ার একটি সেট। এই জোড়া একটি url-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে উপস্থাপন করা আবশ্যক.

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

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

সফল হলে, প্রতিক্রিয়া বডি একটি 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 এন্ডপয়েন্টে একটি সফল অনুরোধ দ্বারা ফেরত দেওয়া হয়।

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

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

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

প্লেব্যাকের সময় একটি বিজ্ঞাপন মিডিয়া শনাক্তকারীর সম্মুখীন হওয়ার পরে, উপরে, স্ট্রীম এন্ডপয়েন্ট থেকে প্রাপ্ত 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 অবজেক্টগুলিকে সূচী করতে ব্যবহৃত হয়।

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

প্রবাহ

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

হার্টবিট ইউআরএল, সার্ভার সাইড বীকনিং স্ট্রীমকে জীবিত রাখতে ব্যবহৃত হয়, এটি অবশ্যই প্রতি {PollingFrequency} সেকেন্ডে পিং করা উচিত। সার্ভার সাইড বীকনিং স্ট্রীমের জন্য জনবহুল।
polling_frequency number

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

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

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

পডমেটাডেটা

PodMetadata বিজ্ঞাপন, বিজ্ঞাপন বিরতি, এবং মিডিয়া আইডি ট্যাগের মেটাডেটা তথ্য ধারণ করে।
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)]

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

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

ট্যাগসেগমেন্টে একটি বিজ্ঞাপনের একটি রেফারেন্স, এর বিজ্ঞাপন বিরতি এবং ইভেন্টের ধরন রয়েছে। 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) যা বিজ্ঞাপন প্লেব্যাকের সময় প্রদর্শিত হওয়া উচিত।

PodTemplateResponse

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

DashPeriodTemplate হল সেলাই করার আগে উপযুক্ত ডেটা দিয়ে পূরণ করার সময়কালের জন্য xml টেমপ্লেট।
segment_duration_ms int64

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

আইকন

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