ডায়নামিক অ্যাড ইনসার্শন 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} বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক শনাক্তকারী। বিজ্ঞাপন পড আইডিগুলি ad_break_id/{string} বর্তমান বিজ্ঞাপন বিরতির জন্য স্ট্রিং শনাক্তকারী। একজন প্রকাশক প্রদত্ত বিজ্ঞাপন বিরতি আইডিতে বিজ্ঞাপন পড আইডির মতো একই সীমাবদ্ধতা নেই। সেই এন্ডপয়েন্টে দেওয়া যেকোন অজানা অ্যাড ব্রেক আইডি লাইভস্ট্রিম ইভেন্টের জন্য একটি নতুন অ্যাড ব্রেক তৈরি করে। |
profile_name | string অনুরোধ করা Google অ্যাড ম্যানেজার DAI এনকোডিং প্রোফাইলের নাম । এনকোডিং প্রোফাইলটি নির্বাচিত ইভেন্টের জন্য কনফিগার করা এনকোডিং প্রোফাইলগুলির মধ্যে একটি হতে হবে৷ |
segment_number | integer বর্তমান বিজ্ঞাপন পডের মধ্যে অনুরোধ করা অংশের সূচী, শূন্য থেকে শুরু। |
segment_format | string অনুরোধকৃত সেগমেন্ট বিন্যাসের সাথে সম্পর্কিত ফাইল এক্সটেনশন। গৃহীত এক্সটেনশনগুলি হল: |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
stream_id | প্রয়োজনীয় | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি | ||||
sd | required 1 | integer অনুরোধ করা অংশের সময়কাল, মিলিসেকেন্ডে। | ||||
so | ঐচ্ছিক | মিলিসেকেন্ডে বিজ্ঞাপন পডের মধ্যে অনুরোধ করা সেগমেন্টের অফসেট। আপনি যদি | ||||
pd | প্রয়োজনীয় 2 | integer বিজ্ঞাপন পডের সময়কাল, মিলিসেকেন্ডে। | ||||
auth-token | প্রয়োজনীয় | string বর্তমান বিজ্ঞাপন পডের জন্য একটি স্বাক্ষরিত, url-এনকোড করা HMAC টোকেন ৷ | ||||
last | ঐচ্ছিক | boolean বিজ্ঞাপন বিরতিতে শেষ সেগমেন্ট নির্দেশ করে। অন্যান্য সমস্ত বিভাগের জন্য এই প্যারামিটারটি বাদ দিন। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস64-এনকোডেড SCTE-35 সংকেত। | ||||
cust_params | ঐচ্ছিক | string Ad Manager প্রচারাভিযান টার্গেটিং এর জন্য ব্যবহৃত মূল-মান জোড়ার একটি সেট। এই জোড়া একটি url-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে উপস্থাপন করা আবশ্যক. উদাহরণ:
|
পাদটীকা
- সূচনা অংশগুলির জন্য
sd
প্রয়োজন হয় না। ↩ - সময়হীন বিজ্ঞাপন বিরতি সক্ষম ইভেন্টের জন্য
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-99d7a4STa467:
পান https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profi le/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-840a4STa6:
প্রতিক্রিয়া শরীর
সফল হলে, রেসপন্স বডি একটি প্লেযোগ্য স্ট্রীম সেগমেন্ট হবে যা অনুরোধে উল্লেখ করা ফরম্যাট এবং প্যারামিটারের সাথে মেলে।
পদ্ধতি: 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} বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক শনাক্তকারী। বিজ্ঞাপন পড আইডিগুলি ad_break_id/{string} বর্তমান বিজ্ঞাপন বিরতির জন্য স্ট্রিং শনাক্তকারী। একজন প্রকাশক প্রদত্ত বিজ্ঞাপন বিরতি আইডিতে বিজ্ঞাপন পড আইডির মতো একই সীমাবদ্ধতা নেই। সেই এন্ডপয়েন্টে দেওয়া যেকোন অজানা অ্যাড ব্রেক আইডি লাইভস্ট্রিম ইভেন্টের জন্য একটি নতুন অ্যাড ব্রেক তৈরি করে। |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
stream_id | প্রয়োজন | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি | ||||
pd | প্রয়োজন | integer বিজ্ঞাপন পডের সময়কাল, মিলিসেকেন্ডে। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস64-এনকোডেড SCTE-35 সংকেত। | ||||
cust_params | ঐচ্ছিক | string Ad Manager প্রচারাভিযান টার্গেটিং এর জন্য ব্যবহৃত মূল-মান জোড়ার একটি সেট। এই জোড়া একটি url-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে উপস্থাপন করা আবশ্যক. উদাহরণ:
|
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডি একটি 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 বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি |
pod_id | integer বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক শনাক্তকারী। বিজ্ঞাপন পড আইডিগুলি |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
pd | প্রয়োজন | integer বিজ্ঞাপন পডের সময়কাল, মিলিসেকেন্ডে। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস64-এনকোডেড SCTE-35 সংকেত। | ||||
cust_params | ঐচ্ছিক | string Ad Manager প্রচারাভিযান টার্গেটিং এর জন্য ব্যবহৃত মূল-মান জোড়ার একটি সেট। এই জোড়া একটি url-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে উপস্থাপন করা আবশ্যক. উদাহরণ:
|
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডি একটি 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 বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি |
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে একটি নতুন 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 সেগমেন্ট ডিউরেশনএমএস হল মিলিসেকেন্ডে পিরিয়ড সেগমেন্টের সময়কাল। |
AdpodTimingMetadataResponse
AdpodTimingMetadataResponse এ অ্যাড পড সম্পর্কে তথ্য রয়েছে এবং কীভাবে এটির জন্য সেগমেন্ট 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)] বিজ্ঞাপন সেগমেন্টের ইউআরএল কীভাবে রেন্ডার করতে হয় তা বর্ণনা করে বিজ্ঞাপন অবজেক্টের অ্যারে, ০ থেকে শুরু করে ইন্ডেক্স করা হয়েছে। |
slate | object(SlateRendering) স্লেট বর্ণনা করে কিভাবে স্লেট সেগমেন্ট ইউআরএল রেন্ডার করা যায়। |
dash_representations | map[string, object(DASHRepresentation)] DASH ম্যানিফেস্টে রেন্ডার করা সেই বিজ্ঞাপন পডের জন্য DASH প্রতিনিধিত্বের তালিকা৷ |
dash_adaptation_sets | map[string, object(DASHAdaptationSet)] DASH ম্যানিফেস্টে রেন্ডার করা বিজ্ঞাপন পডের জন্য DASH অ্যাডাপ্টেশন সেটগুলির তালিকা৷ |
AdRendering
AdRendering বর্ণনা করে কিভাবে একটি সিদ্ধান্ত নেওয়া বিজ্ঞাপন রেন্ডার করতে হয়।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) প্রত্যাশিত: 1000 HLS (মিলিসেকেন্ড) এর জন্য 90000 DASH ভিডিও (PTS) DASH অডিওর জন্য অডিও নমুনা হার৷ |
values | number টাইমস্কেল ইউনিটে int সেগমেন্টের সময়কালের অ্যারে। |
DASH প্রতিনিধিত্ব
DASH রিপ্রেজেন্টেশন 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 ম্যানিফেস্টে রেন্ডার করা অ্যাডাপ্টেশনসেট নোডগুলি বর্ণনা করে।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 অভিযোজন সেট প্রতিনিধিত্ব. |
স্কিম আইডিউরিয়া এবং মান
SchemeIDURIAandValue হল একটি স্কিম আইডি এবং এর মান।JSON প্রতিনিধিত্ব |
---|
{ "scheme_id_uri": string, "value": string, } |
ক্ষেত্র | |
---|---|
scheme_id_uri | string মানের স্কিম ID URI। |
value | string স্কিম ID URI-এর মান। |
আইকন
আইকনে একটি 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> নোডের মান। |
ডায়নামিক অ্যাড ইনসার্শন 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} বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক শনাক্তকারী। বিজ্ঞাপন পড আইডিগুলি ad_break_id/{string} বর্তমান বিজ্ঞাপন বিরতির জন্য স্ট্রিং শনাক্তকারী। একজন প্রকাশক প্রদত্ত বিজ্ঞাপন বিরতি আইডিতে বিজ্ঞাপন পড আইডির মতো একই সীমাবদ্ধতা নেই। সেই এন্ডপয়েন্টে দেওয়া যেকোন অজানা অ্যাড ব্রেক আইডি লাইভস্ট্রিম ইভেন্টের জন্য একটি নতুন অ্যাড ব্রেক তৈরি করে। |
profile_name | string অনুরোধ করা Google অ্যাড ম্যানেজার DAI এনকোডিং প্রোফাইলের নাম । এনকোডিং প্রোফাইলটি নির্বাচিত ইভেন্টের জন্য কনফিগার করা এনকোডিং প্রোফাইলগুলির মধ্যে একটি হতে হবে৷ |
segment_number | integer বর্তমান বিজ্ঞাপন পডের মধ্যে অনুরোধ করা অংশের সূচী, শূন্য থেকে শুরু। |
segment_format | string অনুরোধকৃত সেগমেন্ট বিন্যাসের সাথে সম্পর্কিত ফাইল এক্সটেনশন। গৃহীত এক্সটেনশনগুলি হল: |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
stream_id | প্রয়োজনীয় | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি | ||||
sd | required 1 | integer অনুরোধ করা অংশের সময়কাল, মিলিসেকেন্ডে। | ||||
so | ঐচ্ছিক | মিলিসেকেন্ডে বিজ্ঞাপন পডের মধ্যে অনুরোধ করা সেগমেন্টের অফসেট। আপনি যদি | ||||
pd | প্রয়োজনীয় 2 | integer বিজ্ঞাপন পডের সময়কাল, মিলিসেকেন্ডে। | ||||
auth-token | প্রয়োজনীয় | string বর্তমান বিজ্ঞাপন পডের জন্য একটি স্বাক্ষরিত, url-এনকোড করা HMAC টোকেন ৷ | ||||
last | ঐচ্ছিক | boolean বিজ্ঞাপন বিরতিতে শেষ সেগমেন্ট নির্দেশ করে। অন্যান্য সমস্ত বিভাগের জন্য এই প্যারামিটারটি বাদ দিন। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস64-এনকোডেড SCTE-35 সংকেত। | ||||
cust_params | ঐচ্ছিক | string Ad Manager প্রচারাভিযান টার্গেটিং এর জন্য ব্যবহৃত মূল-মান জোড়ার একটি সেট। এই জোড়া একটি url-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে উপস্থাপন করা আবশ্যক. উদাহরণ:
|
পাদটীকা
- সূচনা অংশগুলির জন্য
sd
প্রয়োজন হয় না। ↩ - সময়হীন বিজ্ঞাপন বিরতি সক্ষম ইভেন্টের জন্য
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-99d7a4STa467:
পান https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profi le/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-840a4STa6:
প্রতিক্রিয়া শরীর
সফল হলে, রেসপন্স বডি একটি প্লেযোগ্য স্ট্রীম সেগমেন্ট হবে যা অনুরোধে উল্লেখ করা ফরম্যাট এবং প্যারামিটারের সাথে মেলে।
পদ্ধতি: 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} বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক শনাক্তকারী। বিজ্ঞাপন পড আইডিগুলি ad_break_id/{string} বর্তমান বিজ্ঞাপন বিরতির জন্য স্ট্রিং শনাক্তকারী। একজন প্রকাশক প্রদত্ত বিজ্ঞাপন বিরতি আইডিতে বিজ্ঞাপন পড আইডির মতো একই সীমাবদ্ধতা নেই। সেই এন্ডপয়েন্টে দেওয়া যেকোন অজানা অ্যাড ব্রেক আইডি লাইভস্ট্রিম ইভেন্টের জন্য একটি নতুন অ্যাড ব্রেক তৈরি করে। |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
stream_id | প্রয়োজন | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি | ||||
pd | প্রয়োজন | integer বিজ্ঞাপন পডের সময়কাল, মিলিসেকেন্ডে। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস64-এনকোডেড SCTE-35 সংকেত। | ||||
cust_params | ঐচ্ছিক | string Ad Manager প্রচারাভিযান টার্গেটিং এর জন্য ব্যবহৃত মূল-মান জোড়ার একটি সেট। এই জোড়া একটি url-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে উপস্থাপন করা আবশ্যক. উদাহরণ:
|
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডি একটি 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 বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি |
pod_id | integer বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক শনাক্তকারী। বিজ্ঞাপন পড আইডিগুলি |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
pd | প্রয়োজন | integer বিজ্ঞাপন পডের সময়কাল, মিলিসেকেন্ডে। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস64-এনকোডেড SCTE-35 সংকেত। | ||||
cust_params | ঐচ্ছিক | string Ad Manager প্রচারাভিযান টার্গেটিং এর জন্য ব্যবহৃত মূল-মান জোড়ার একটি সেট। এই জোড়া একটি url-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে উপস্থাপন করা আবশ্যক. উদাহরণ:
|
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডি একটি 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 বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি |
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে একটি নতুন 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 সেগমেন্ট ডিউরেশনএমএস হল মিলিসেকেন্ডে পিরিয়ড সেগমেন্টের সময়কাল। |
AdpodTimingMetadataResponse
AdpodTimingMetadataResponse এ অ্যাড পড সম্পর্কে তথ্য রয়েছে এবং কীভাবে এটির জন্য সেগমেন্ট 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)] বিজ্ঞাপন সেগমেন্টের ইউআরএল কীভাবে রেন্ডার করতে হয় তা বর্ণনা করে বিজ্ঞাপন অবজেক্টের অ্যারে, ০ থেকে শুরু করে ইন্ডেক্স করা হয়েছে। |
slate | object(SlateRendering) স্লেট বর্ণনা করে কিভাবে স্লেট সেগমেন্ট ইউআরএল রেন্ডার করা যায়। |
dash_representations | map[string, object(DASHRepresentation)] DASH ম্যানিফেস্টে রেন্ডার করা সেই বিজ্ঞাপন পডের জন্য DASH প্রতিনিধিত্বের তালিকা৷ |
dash_adaptation_sets | map[string, object(DASHAdaptationSet)] DASH ম্যানিফেস্টে রেন্ডার করা বিজ্ঞাপন পডের জন্য DASH অ্যাডাপ্টেশন সেটগুলির তালিকা৷ |
AdRendering
অ্যাড্রেন্ডারিং কীভাবে সিদ্ধান্ত নেওয়া বিজ্ঞাপন রেন্ডার করবেন তা বর্ণনা করে।JSON প্রতিনিধিত্ব |
---|
{ "duration_ms": number, "variants": map[string, object(VariantRendering)], } |
ক্ষেত্র | |
---|---|
duration_ms | number বিজ্ঞাপনের সময়কাল, মিলিসেকেন্ডে (ইনট)। |
variants | map[string, object(VariantRendering)] ভেরিয়েন্ট অবজেক্টের অভিধান (নীচে দেখুন), ইউআই থেকে কনফিগার করা হিসাবে বৈকল্পিক/প্রোফাইল আইডি দ্বারা সূচকযুক্ত। |
স্লেটারেন্ডারিং
স্লেটারেন্ডারিং কীভাবে স্লেট সামগ্রী রেন্ডার করবেন তা বর্ণনা করে।JSON প্রতিনিধিত্ব |
---|
{ "duration_ms": number, "variants": map[string, object(VariantRendering)], } |
ক্ষেত্র | |
---|---|
duration_ms | number স্লেটের সময়কাল, মিলিসেকেন্ডে (ইনট)। |
variants | map[string, object(VariantRendering)] বৈকল্পিক/প্রোফাইল আইডি দ্বারা সূচকযুক্ত বৈকল্পিক অবজেক্টের অভিধান। প্রয়োজনীয় স্লেটের দৈর্ঘ্য না পৌঁছানো পর্যন্ত স্লেটের সময়সীমাগুলি অবশ্যই লুপ করতে হবে, পুনরাবৃত্তির মধ্যে এইচএলএস বিচ্ছিন্নতা সন্নিবেশ করা বা এমপিইজি-ড্যাশের জন্য নতুন পিরিয়ডগুলি লুপ করে। |
বৈকল্পিক
ভেরিয়েন্ট্রেন্ডারিং বিজ্ঞাপন/স্লেটের মধ্যে একটি বৈকল্পিক/প্রোফাইল বর্ণনা করে।JSON প্রতিনিধিত্ব |
---|
{ "segment_extension": string, "segment_durations": object(SegmentDurations), } |
ক্ষেত্র | |
---|---|
segment_extension | string স্ট্রিং, একটি: টিএস, এমপি 4, এএসি, এসি 3, ইসি 3, এম 4 এ, এম 4 ভি। বিভাগের ইউআরএলগুলির ফাইলের নাম এক্সটেনশন অংশ। |
segment_durations | object(SegmentDurations) সেগমেন্টডিউরেশন অবজেক্টস। প্রতিটি বিভাগের সময়কাল একটি বিভাগের ইউআরএল অনুবাদ করা যেতে পারে। |
সেগমেন্টডিউরেশনস
সেগমেন্ট ডিউরেশনগুলি নির্দিষ্ট সময় ইউনিটে বিভাগগুলির ক্রমের সময়কাল বর্ণনা করে।JSON প্রতিনিধিত্ব |
---|
{ "timescale": number, "values": [], } |
ক্ষেত্র | |
---|---|
timescale | number টাইমস্কেল হ'ল প্রতি সেকেন্ডে (ইনট) ইউনিটগুলির সংখ্যা (ইনট) হবে: এইচএলএসের জন্য 1000 (মিলিসেকেন্ডস) 90000 ড্যাশ ভিডিওর জন্য 90000 (পিটিএস) ড্যাশ অডিওর জন্য অডিও নমুনা হারের জন্য। |
values | number টাইমস্কেল ইউনিটগুলিতে আইএনটি বিভাগের সময়কালের অ্যারে। |
ড্যাশপ্রেসেন্টেশন
ড্যাশপ্রেসেন্টেশন ড্যাশ প্রকাশে রেন্ডার করার জন্য উপস্থাপনা নোডগুলি বর্ণনা করে।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) উপস্থাপনের অডিও চ্যানেল কনফিগারেশন। |
ড্যাশডাপ্টেশনসেট
ড্যাশএডাপ্টেশনসেট ড্যাশ প্রকাশে রেন্ডার করার জন্য অভিযোজিত নোডগুলি বর্ণনা করে।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 অভিযোজন সেটের মাইম প্রকার। |
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 | string অভিযোজন সেট উপস্থাপনা। |
স্কিমিডুরিয়ানডভ্যালু
স্কিমিডুরিয়ানডভ্যালু হ'ল একটি স্কিম আইডি এবং এর মান।JSON প্রতিনিধিত্ব |
---|
{ "scheme_id_uri": string, "value": string, } |
ক্ষেত্র | |
---|---|
scheme_id_uri | string মানটির স্কিম আইডি ইউআরআই। |
value | string স্কিম আইডি ইউআরআই এর মান। |
আইকন
আইকনে একটি বিশাল আইকন সম্পর্কিত তথ্য রয়েছে।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 |
ক্লিকডাটা
ক্লিকডাতে আইকন ক্লিকথ্রু সম্পর্কিত তথ্য রয়েছে।JSON প্রতিনিধিত্ব |
---|
{ "url": string, } |
ক্ষেত্র | |
---|---|
url | string |
ফ্যালব্যাকিমেজ
ফ্যালব্যাকিমেজে একটি বিশাল ফ্যালব্যাক চিত্র সম্পর্কিত তথ্য রয়েছে।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 র্যাপার বিজ্ঞাপনের জন্য al চ্ছিক ডিল আইডি। |
যাচাইকরণ
যাচাইকরণে উন্মুক্ত পরিমাপের জন্য তথ্য রয়েছে, যা তৃতীয় পক্ষের দৃশ্যমানতা এবং যাচাইকরণ পরিমাপের সুবিধার্থে। বর্তমানে, কেবল জাভাস্ক্রিপ্ট সংস্থানগুলি সমর্থিত। Https://iabtechlab.com/standards/open-mesurement-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 একটি অস্বচ্ছ স্ট্রিং বুটস্ট্র্যাপ যাচাইকরণ কোডে পাস করেছে। |
জাভাস্ক্রিপ্টট্রেসোর্স
জাভাস্ক্রিপ্টট্রেসোর্সে জাভাস্ক্রিপ্টের মাধ্যমে যাচাইয়ের জন্য তথ্য রয়েছে।JSON প্রতিনিধিত্ব |
---|
{ "script_url": string, "api_framework": string, "browser_optional": boolean, } |
ক্ষেত্র | |
---|---|
script_url | string ইউআরআই থেকে জাভাস্ক্রিপ্ট পে -লোড। |
api_framework | string এপিফ্রেমওয়ার্ক হ'ল ভিডিও ফ্রেমওয়ার্কের যা যাচাইকরণ কোডটি অনুশীলন করে। |
browser_optional | boolean এই স্ক্রিপ্টটি কোনও ব্রাউজারের বাইরে চালানো যেতে পারে কিনা। |
ট্র্যাকিংএভেন্ট
ট্র্যাকিংএভেন্টে ইউআরএল রয়েছে যা নির্দিষ্ট পরিস্থিতিতে ক্লায়েন্ট দ্বারা পিন করা উচিত।JSON প্রতিনিধিত্ব |
---|
{ "event": string, "uri": string, } |
ক্ষেত্র | |
---|---|
event | string ট্র্যাকিং ইভেন্টের ধরণ। |
uri | string ট্র্যাকিং ইভেন্টটি পিন করা হবে। |
ইউনিভার্সালডিড
ইউনিভার্সালডিড একটি অনন্য সৃজনশীল শনাক্তকারী সরবরাহ করতে ব্যবহৃত হয় যা বিজ্ঞাপন সিস্টেমগুলিতে রক্ষণাবেক্ষণ করা হয়।JSON প্রতিনিধিত্ব |
---|
{ "id_value": string, "id_registry": string, } |
ক্ষেত্র | |
---|---|
id_value | string বিজ্ঞাপনের জন্য নির্বাচিত সৃজনশীলতার সর্বজনীন বিজ্ঞাপন আইডি। |
id_registry | string রেজিস্ট্রি ওয়েবসাইটের জন্য ইউআরএল সনাক্ত করতে ব্যবহৃত একটি স্ট্রিং যেখানে নির্বাচিত সৃজনশীল ইউনিভার্সাল এডি আইডি ক্যাটালোজ করা আছে। |
সহচর
সঙ্গী সহচর বিজ্ঞাপনগুলির জন্য তথ্য রয়েছে যা বিজ্ঞাপনের সাথে প্রদর্শিত হতে পারে।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 ক্রিয়েটিভ টাইপ অ্যাট্রিবিউট <স্ট্যাটিকরেসোর্স> নোডের উপর যদি এটি স্ট্যাটিক টাইপের সহযোগী হয়। |
height | int32 এই সঙ্গীর পিক্সেল উচ্চতা। |
width | int32 এই সঙ্গীর পিক্সেলের প্রস্থ। |
resource | string স্ট্যাটিক এবং আইফ্রেম সহচরদের জন্য এটি লোড এবং প্রদর্শিত হবে URL। এইচটিএমএল সঙ্গীদের জন্য, এটি এইচটিএমএল স্নিপেট হবে যা সহচর হিসাবে দেখানো উচিত। |
type | string এই সঙ্গীর ধরণ। এটি স্ট্যাটিক, আইফ্রেম বা এইচটিএমএল হতে পারে। |
ad_slot_id | string এই সঙ্গীর জন্য স্লট আইডি। |
api_framework | string এই সঙ্গীর জন্য এপিআই কাঠামো। |
tracking_events | [object(TrackingEvent)] এই সঙ্গীর জন্য ট্র্যাকিং ইভেন্টগুলির তালিকা। |
ইন্টারেক্টিভ ফাইল
ইন্টারেক্টিভ ফাইলটিতে ইন্টারেক্টিভ ক্রিয়েটিভ (অর্থাত্ সিমিড) এর জন্য তথ্য রয়েছে যা বিজ্ঞাপন প্লেব্যাকের সময় প্রদর্শিত হবে।JSON প্রতিনিধিত্ব |
---|
{ "resource": string, "type": string, "variable_duration": boolean, "ad_parameters": string, } |
ক্ষেত্র | |
---|---|
resource | string ইন্টারেক্টিভ ক্রিয়েটিভের জন্য ইউআরএল। |
type | string রিসোর্স হিসাবে সরবরাহ করা ফাইলের মাইম টাইপ। |
variable_duration | boolean এই সৃজনশীল সময়কাল বাড়ানোর জন্য জিজ্ঞাসা করতে পারে কিনা। |
ad_parameters | string বিশাল আকারে <অ্যাডপ্যারামিটার> নোডের মান। |
গতিশীল বিজ্ঞাপন সন্নিবেশ এপিআই আপনাকে অনুরোধ এবং ডাই লাইভস্ট্রিমগুলি ট্র্যাক করতে দেয়।
পরিষেবা: dai.google.com
সমস্ত ইউআরআই https://dai.google.com
এর সাথে সম্পর্কিত।
পদ্ধতি: স্ট্রিম
পদ্ধতি | |
---|---|
stream | POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream লাইভস্ট্রিম সেশন পরিবেশনকারী একটি ডাই ডাই পড নিবন্ধন করে। |
HTTP অনুরোধ
POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream
পাথ প্যারামিটার
পরামিতি | |
---|---|
network_code | string প্রকাশকের গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড। |
custom_asset_key | string কাস্টম আইডেন্টিফায়ার এই ইভেন্টটি গুগল অ্যাড ম্যানেজারে যুক্ত করেছে। |
শরীরের অনুরোধ
অনুরোধ বডিটি টাইপ application/x-www-form-urlencoded
এবং নিম্নলিখিত পরামিতিগুলি রয়েছে:
পরামিতি | ||
---|---|---|
ডিএফপি টার্গেটিং পরামিতি | ঐচ্ছিক | অতিরিক্ত টার্গেটিং পরামিতি। |
ওভাররাইড স্ট্রিম প্যারামিটার | ঐচ্ছিক | একটি স্ট্রিম তৈরির প্যারামিটারের ডিফল্ট মানগুলি ওভাররাইড করুন। |
এইচএমএসি প্রমাণীকরণ | ঐচ্ছিক | এইচএমএসি-ভিত্তিক টোকেন ব্যবহার করে প্রমাণীকরণ করুন। |
প্রতিক্রিয়া শরীর
যদি সফল হয় তবে প্রতিক্রিয়া বডিতে একটি নতুন Stream
অবজেক্ট রয়েছে।
ওপেন পরিমাপ
ডিএআই এপিআইতে Verifications
ক্ষেত্রে উন্মুক্ত পরিমাপ যাচাইয়ের জন্য তথ্য রয়েছে। এই ক্ষেত্রটিতে এক বা একাধিক Verification
উপাদান রয়েছে যা সৃজনশীল প্লেব্যাক যাচাই করার জন্য তৃতীয় পক্ষের পরিমাপ কোড কার্যকর করতে প্রয়োজনীয় সংস্থান এবং মেটাডেটা তালিকাভুক্ত করে। কেবল JavaScriptResource
সমর্থিত। আরও তথ্যের জন্য, দয়া করে আইএবি টেক ল্যাব এবং বিশাল 4.1 স্পেস দেখুন।
পদ্ধতি: পড বিভাগ
পদ্ধতি | |
---|---|
pod segment | GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format} প্রদত্ত ইভেন্ট আইডির জন্য একটি ডাই স্ট্রিম তৈরি করে। |
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 প্রকাশকের গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড। |
custom_asset_key | string কাস্টম আইডেন্টিফায়ার এই ইভেন্টটি গুগল অ্যাড ম্যানেজারে যুক্ত করেছে। |
pod_identifier | নিম্নলিখিত বিন্যাস সমর্থিত: pod/{integer} বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক সনাক্তকারী। এডি পিওডি আইডিগুলি প্রতিটি বিজ্ঞাপন বিরতি ইভেন্টের জন্য ক্রমবর্ধমানভাবে নির্ধারিত হয়, ad_break_id/{string} বর্তমান বিজ্ঞাপন বিরতির জন্য স্ট্রিং আইডেন্টিফায়ার। একটি প্রকাশক প্রদত্ত বিজ্ঞাপন বিরতি আইডির বিজ্ঞাপন পিওডি আইডি হিসাবে একই সীমাবদ্ধতা নেই। সেই শেষ পয়েন্টে সরবরাহ করা কোনও অজানা বিজ্ঞাপন বিরতি আইডি লাইভস্ট্রিম ইভেন্টের জন্য একটি নতুন বিজ্ঞাপন বিরতি তৈরি করে। |
profile_name | string অনুরোধ করা গুগল অ্যাড ম্যানেজার ডাই এনকোডিং প্রোফাইলের নাম । এনকোডিং প্রোফাইল অবশ্যই নির্বাচিত ইভেন্টের জন্য কনফিগার করা এনকোডিং প্রোফাইলগুলির মধ্যে একটি হতে হবে। |
segment_number | integer শূন্যের শুরুতে বর্তমান বিজ্ঞাপন পডের মধ্যে অনুরোধ করা বিভাগের সূচক। |
segment_format | string অনুরোধ করা বিভাগের বিন্যাসের সাথে যুক্ত ফাইল এক্সটেনশন। স্বীকৃত এক্সটেনশনগুলি হ'ল: |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
stream_id | প্রয়োজনীয় | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি | ||||
sd | required 1 | integer মিলিসেকেন্ডে অনুরোধ করা বিভাগের সময়কাল। | ||||
so | ঐচ্ছিক | মিলিসেকেন্ডে বিজ্ঞাপন পডের মধ্যে অনুরোধ করা বিভাগের অফসেট। আপনি যদি | ||||
pd | প্রয়োজনীয় 2 | integer মিলিসেকেন্ডে বিজ্ঞাপন পডের সময়কাল। | ||||
auth-token | প্রয়োজনীয় | string বর্তমান বিজ্ঞাপন পডের জন্য একটি স্বাক্ষরিত, ইউআরএল-এনকোডেড এইচএমএসি টোকেন । | ||||
last | ঐচ্ছিক | boolean বিজ্ঞাপন বিরতির শেষ বিভাগটি নির্দেশ করে। অন্যান্য সমস্ত বিভাগের জন্য এই প্যারামিটারটি বাদ দিন। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস 64-এনকোডেড এসসিটিই -35 সিগনাল। | ||||
cust_params | ঐচ্ছিক | string কী-মান জোড়গুলির একটি সেট, বিজ্ঞাপন পরিচালক প্রচারের জন্য টার্গেটিংয়ের জন্য ব্যবহৃত। এই জোড়াগুলি অবশ্যই একটি ইউআরএল-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে প্রতিনিধিত্ব করতে হবে। উদাহরণ:
|
পাদটীকা
- সূচনা বিভাগগুলির জন্য
sd
প্রয়োজন হয় না। ↩ - সময়কালহীন বিজ্ঞাপন বিরতি সক্ষম করা ইভেন্টগুলির জন্য
pd
প্রয়োজন হয় না। ↩
উদাহরণ
পান https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbrek -2/প্রোফাইল/8B8888CF79AD43F0800482FFC035A1AC_TS_A/1.TS? সুতরাং = 0 & এসডি = 10000 এবং পিডি = 30000 এবং স্ট্রিম_আইডি = 8E19CBC6-850B-404C-99D7-86060A4CB: Test
পান https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/2/2/2/2/2/2/2/2/Profi LE/8B8888CF79AD43F0800482FFC035A1AC_TS_A/1.TS? সুতরাং = 0 & এসডি = 10000 এবং পিডি = 30000 এবং স্ট্রিম_আইডি = 8E19CBC6-850B-404C-99D7-860A4A4A4A67440CB: টেস্ট
প্রতিক্রিয়া শরীর
যদি সফল হয় তবে প্রতিক্রিয়া বডিটি অনুরোধে নির্দিষ্ট ফর্ম্যাট এবং পরামিতিগুলির সাথে মেলে একটি প্লেযোগ্য স্ট্রিম বিভাগ হবে।
পদ্ধতি: এইচএলএস পড ম্যানিফেস্ট
একটি লাইভস্ট্রিমের এইচএলএস বিজ্ঞাপন পড ম্যানিফেস্ট পুনরুদ্ধার করে যা ক্লায়েন্ট ভিডিও প্লেয়ারকে লোড এবং খেলতে প্রস্তুত।
পদ্ধতি | |
---|---|
GET | GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/{pod_identifier}.m3u8; এপিআই একটি বিজ্ঞাপন পডের জন্য এইচএলএস মাল্টিভারিয়ান্ট প্লেলিস্ট পুনরুদ্ধার করতে। |
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 প্রকাশকের গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড। |
custom_asset_key | string কাস্টম আইডেন্টিফায়ার এই ইভেন্টটি গুগল বিজ্ঞাপন পরিচালকের সাথে যুক্ত |
pod_identifier | নিম্নলিখিত বিন্যাস সমর্থিত: pod/{integer} বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক সনাক্তকারী। এডি পিওডি আইডিগুলি প্রতিটি বিজ্ঞাপন বিরতি ইভেন্টের জন্য ক্রমবর্ধমানভাবে নির্ধারিত হয়, ad_break_id/{string} বর্তমান বিজ্ঞাপন বিরতির জন্য স্ট্রিং আইডেন্টিফায়ার। একটি প্রকাশক প্রদত্ত বিজ্ঞাপন বিরতি আইডির বিজ্ঞাপন পিওডি আইডি হিসাবে একই সীমাবদ্ধতা নেই। সেই শেষ পয়েন্টে সরবরাহ করা কোনও অজানা বিজ্ঞাপন বিরতি আইডি লাইভস্ট্রিম ইভেন্টের জন্য একটি নতুন বিজ্ঞাপন বিরতি তৈরি করে। |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
stream_id | প্রয়োজন | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি | ||||
pd | প্রয়োজন | integer মিলিসেকেন্ডে বিজ্ঞাপন পডের সময়কাল। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস 64-এনকোডেড এসসিটিই -35 সিগনাল। | ||||
cust_params | ঐচ্ছিক | string কী-মান জোড়গুলির একটি সেট, বিজ্ঞাপন পরিচালক প্রচারের জন্য টার্গেটিংয়ের জন্য ব্যবহৃত। এই জোড়াগুলি অবশ্যই একটি ইউআরএল-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে প্রতিনিধিত্ব করতে হবে। উদাহরণ:
|
প্রতিক্রিয়া শরীর
যদি সফল হয় তবে প্রতিক্রিয়া বডি একটি এইচএলএস মাল্টিভারিয়ান্ট প্লেলিস্ট।
পদ্ধতি: ড্যাশ পড ম্যানিফেস্ট
কোনও লাইভস্ট্রিমের এমপিইজি-ড্যাশ বিজ্ঞাপন পড ম্যানিফেস্ট পুনরুদ্ধার করে যা ক্লায়েন্ট ভিডিও প্লেয়ারকে লোড এবং খেলতে প্রস্তুত।
পদ্ধতি | |
---|---|
GET | GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/manifest.mpd এপিআই একটি বিজ্ঞাপন পডের জন্য এমপিইজি-ড্যাশ এমপিডি প্লেলিস্ট পুনরুদ্ধার করতে। |
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 প্রকাশকের গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড। |
custom_asset_key | string কাস্টম আইডেন্টিফায়ার এই ইভেন্টটি গুগল বিজ্ঞাপন পরিচালকের সাথে যুক্ত |
stream_id | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি |
pod_id | integer বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক সনাক্তকারী। এডি পিওডি আইডিগুলি প্রতিটি বিজ্ঞাপন বিরতি ইভেন্টের জন্য ক্রমবর্ধমানভাবে নির্ধারিত হয়, |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
pd | প্রয়োজন | integer মিলিসেকেন্ডে বিজ্ঞাপন পডের সময়কাল। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস 64-এনকোডেড এসসিটিই -35 সিগনাল। | ||||
cust_params | ঐচ্ছিক | string কী-মান জোড়গুলির একটি সেট, বিজ্ঞাপন পরিচালক প্রচারের জন্য টার্গেটিংয়ের জন্য ব্যবহৃত। এই জোড়াগুলি অবশ্যই একটি ইউআরএল-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে প্রতিনিধিত্ব করতে হবে। উদাহরণ:
|
প্রতিক্রিয়া শরীর
যদি সফল হয় তবে প্রতিক্রিয়া বডিটি এমপিইজি-ড্যাশ এমপিডি প্লেলিস্ট।
পদ্ধতি: ড্যাশ পড পিরিয়ড টেম্পলেট
পদ্ধতি | |
---|---|
pods | GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json গুগল বিজ্ঞাপন পরিচালকের কাছ থেকে ড্যাশ পিরিয়ড টেম্পলেট অনুরোধ করে। এই টেমপ্লেটে ম্যাক্রো রয়েছে যা আপনাকে অবশ্যই আপনার স্ট্রিম প্যারামিটারগুলির সাথে পপুলেট করতে হবে। একবার এই ম্যাক্রোগুলি জনবহুল হয়ে গেলে, টেমপ্লেটটি আপনার বিজ্ঞাপন বিরতির সময় হয়ে যায় এবং আপনার ড্যাশ ম্যানিফেস্টে সেলাই করা যায়। |
HTTP অনুরোধ
GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json
পাথ প্যারামিটার
পরামিতি | |
---|---|
network_code | string প্রকাশকের গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড। |
custom_asset_key | string কাস্টম আইডেন্টিফায়ার এই ইভেন্টটি গুগল অ্যাড ম্যানেজারে যুক্ত করেছে। |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||
---|---|---|
stream_id | প্রয়োজনীয় | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি |
প্রতিক্রিয়া শরীর
যদি সফল হয় তবে প্রতিক্রিয়া বডিতে একটি নতুন PodTemplateResponse
অবজেক্ট রয়েছে।
পদ্ধতি: মিডিয়া যাচাইকরণ
প্লেব্যাক চলাকালীন কোনও বিজ্ঞাপন মিডিয়া আইডেন্টিফায়ারের মুখোমুখি হওয়ার পরে, তত্ক্ষণাত্ উপরের স্ট্রিমের শেষ পয়েন্ট থেকে প্রাপ্ত মিডিয়া_ভারিফিকেশন_আরএল ব্যবহার করে একটি অনুরোধ করুন। এই অনুরোধগুলি সার্ভার-সাইড-বেয়ারকনিং স্ট্রিমগুলির জন্য প্রয়োজনীয় নয়, যেখানে সার্ভার মিডিয়া যাচাইয়ের সূচনা করে।
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
যদি এই সময়ে ইতিমধ্যে অন্য কোনও অনুরোধ পিংস প্রেরণ করে।
বিজ্ঞাপন মিডিয়া আইডিএস
এডি মিডিয়া শনাক্তকারীগুলি একটি পৃথক মেটাডেটা ট্র্যাক - এইচএলএস ট্রান্সপোর্ট স্ট্রিমের জন্য সময়োচিত মেটাডেটা, বা এমপি 4 ফাইলগুলির জন্য ইএমএসজি এনকোড করা হবে। বিজ্ঞাপন মিডিয়া শনাক্তকারীরা সর্বদা স্ট্রিং google_
দিয়ে শুরু হবে।
মেটাডেটা এন্ট্রির পুরো পাঠ্য সামগ্রীগুলি প্রতিটি বিজ্ঞাপন যাচাইয়ের অনুরোধ করার আগে বিজ্ঞাপন যাচাইকরণ ইউআরএলে যুক্ত করা উচিত।
পদ্ধতি: মেটাডেটা
metadata_url
মেটাডেটা শেষ পয়েন্টটি একটি বিজ্ঞাপন ইউআই তৈরির জন্য ব্যবহৃত তথ্য দেয়। মেটাডেটা এন্ডপয়েন্টটি সার্ভার-সাইড-বেকনিং স্ট্রিমগুলির জন্য উপলভ্য নয়, যেখানে সার্ভার বিজ্ঞাপন মিডিয়া যাচাইকরণ শুরু করার জন্য দায়বদ্ধ।
পদ্ধতি | |
---|---|
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 প্রতিনিধিত্ব |
---|
{ "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 গ্যাম স্ট্রিম শনাক্তকারী। |
media_verification_url | string মিডিয়া যাচাইকরণ ইউআরএল প্লেব্যাক ইভেন্টগুলি ট্র্যাক করার জন্য বেস এন্ডপয়েন্ট হিসাবে ব্যবহৃত হয়। |
metadata_url | string মেটাডেটা ইউআরএল আসন্ন স্ট্রিম বিজ্ঞাপন ইভেন্টগুলি সম্পর্কে পর্যায়ক্রমিক তথ্যের জন্য জরিপ করত। |
session_update_url | string সেশনটির আপডেট ইউআরএল এই স্ট্রিমের জন্য টার্গেটিং প্যারামিটারগুলি আপডেট করতে ব্যবহৃত হয়েছিল। লক্ষ্যমাত্রার পরামিতিগুলির মূল মানগুলি প্রাথমিক স্ট্রিম তৈরি করার অনুরোধের সময় ক্যাপচার করা হয়। |
heartbeat_url | string হার্টবিট ইউআরএল, সার্ভার সাইড বিককনিং স্ট্রিমকে বাঁচিয়ে রাখতে ব্যবহৃত হয়, এটি অবশ্যই প্রতি {পোলিংফ্রিকোয়েন্সি} সেকেন্ডে পিন করা উচিত। সার্ভার সাইড বিকনিং স্ট্রিমগুলির জন্য জনবহুল। |
polling_frequency | number পোলিং ফ্রিকোয়েন্সি, সেকেন্ডে, যখন মেটাডেটা_আরল বা হার্টবিট_আরএলকে অনুরোধ করে। |
pod_manifest_url | string পিওডি ম্যানিফেস্ট ইউআরএল টেম্পলেটটি এইচএলএসে মাল্টিভারিয়ান্ট প্লেলিস্টের ইউআরএল বা ড্যাশের এমপিডি এর সাথে সম্পর্কিত, স্ট্রিমের পড ম্যানিফেস্ট পুনরুদ্ধার করতে ইউআরএল উত্পন্ন করতে ব্যবহৃত হয়। ডায়নামিক বিজ্ঞাপন সন্নিবেশের প্রকারের লাইভস্ট্রিম ইভেন্টগুলির জন্য জনবহুল POD_serving_manifest। https://developers.google.com/ad-manager/api/reference/v202305/livestreameventservice.dynamicadinsertiontype |
manifest_format | string ম্যানিফেস্ট ফর্ম্যাটটি POD_MANIFEST_URL, ড্যাশ বা এইচএলএস থেকে প্রাপ্ত ম্যানিফেস্টের ফর্ম্যাট। |
পডমেটাটাটা
পডমেটাডেটাতে বিজ্ঞাপন, বিজ্ঞাপন বিরতি এবং মিডিয়া আইডি ট্যাগগুলিতে মেটাডেটা তথ্য রয়েছে।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)] বিজ্ঞাপন বিরতির মানচিত্র বিজ্ঞাপন বিরতি আইডি দ্বারা সূচিযুক্ত। |
ট্যাগসমেন্ট
ট্যাগসমেন্টে একটি বিজ্ঞাপন, এর বিজ্ঞাপন বিরতি এবং ইভেন্টের ধরণে একটি রেফারেন্স রয়েছে। টাইপ সহ ট্যাগসমেন্ট = "অগ্রগতি" বিজ্ঞাপন মিডিয়া যাচাইকরণের শেষ পয়েন্টে পিন করা উচিত নয়।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 বিজ্ঞাপনের al চ্ছিক শিরোনাম। |
description | string বিজ্ঞাপনের al চ্ছিক বিবরণ। |
advertiser | string Ption চ্ছিক বিজ্ঞাপনদাতা সনাক্তকারী। |
ad_system | string Ad চ্ছিক বিজ্ঞাপন সিস্টেম। |
ad_id | string Ad চ্ছিক বিজ্ঞাপন আইডি। |
creative_id | string Al চ্ছিক সৃজনশীল আইডি। |
creative_ad_id | string Al চ্ছিক সৃজনশীল বিজ্ঞাপন আইডি। |
deal_id | string Al চ্ছিক ডিল আইডি। |
clickthrough_url | string Al চ্ছিক ক্লিকথ্রু ইউআরএল। |
click_tracking_urls | string Clack চ্ছিক ট্র্যাকিং ইউআরএল ক্লিক করুন। |
verifications | [object(Verification)] Open চ্ছিক ওপেন পরিমাপ যাচাইকরণ এন্ট্রিগুলি যা সৃজনশীল প্লেব্যাক যাচাই করতে তৃতীয় পক্ষের পরিমাপ কোড কার্যকর করতে প্রয়োজনীয় সংস্থান এবং মেটাডেটাকে তালিকাভুক্ত করে। |
slate | boolean বর্তমান এন্ট্রি নির্দেশ করে al চ্ছিক বুল স্লেট। |
icons | [object(Icon)] আইকনগুলির একটি তালিকা, খালি থাকলে বাদ দেওয়া হয়েছে। |
wrappers | [object(Wrapper)] খালি থাকলে বাদ দেওয়া মোড়কের একটি তালিকা। |
universal_ad_id | object(UniversalAdID) Al চ্ছিক সর্বজনীন বিজ্ঞাপন আইডি। |
extensions | string বিস্তৃত সমস্ত <এক্সটেনশন> নোডের al চ্ছিক তালিকা। |
companions | [object(Companion)] এই বিজ্ঞাপনের সাথে প্রদর্শিত হতে পারে al চ্ছিক সাহাবী। |
interactive_file | object(InteractiveFile) Apple চ্ছিক ইন্টারেক্টিভ ক্রিয়েটিভ (সিমিড) যা বিজ্ঞাপন প্লেব্যাকের সময় প্রদর্শিত হবে। |
পোডটেমপ্লটারস্পোনস
পডটেমপ্লটারস্পোনস পিওড সেলাইয়ের জন্য ভিটিপিতে ফিরে আসা জেএসওএন পে -লোডকে উপস্থাপন করে।JSON প্রতিনিধিত্ব |
---|
{ "dash_period_template": string, "segment_duration_ms": int64, } |
ক্ষেত্র | |
---|---|
dash_period_template | string ড্যাশপিরিওডটেমপ্লেটটি সেলাইয়ের আগে উপযুক্ত ডেটা দিয়ে পিরিয়ডের জন্য এক্সএমএল টেম্পলেট। |
segment_duration_ms | int64 সেগমেন্টডিউরেশনস হ'ল মিলিসেকেন্ডে পিরিয়ড বিভাগগুলির সময়কাল। |
অ্যাডপডটাইমিংমেটাড্যাটারস্পোনস
অ্যাডপডটাইমিংমেটাড্যাটারস্পোনগুলিতে বিজ্ঞাপন পড এবং এর জন্য কীভাবে বিভাগের ইউআরএলগুলি তৈরি করা যায় সে সম্পর্কে তথ্য রয়েছে।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) স্লেট কীভাবে স্লেট বিভাগের urls রেন্ডার করবেন তা বর্ণনা করে। |
dash_representations | map[string, object(DASHRepresentation)] ড্যাশ প্রকাশে রেন্ডার করার জন্য সেই বিজ্ঞাপন পডের জন্য ড্যাশ উপস্থাপনার তালিকা। |
dash_adaptation_sets | map[string, object(DASHAdaptationSet)] সেই বিজ্ঞাপন পডের জন্য ড্যাশ অভিযোজন সেটগুলির তালিকা ড্যাশ প্রকাশে রেন্ডার করার জন্য। |
অ্যাড্রেন্ডারিং
অ্যাড্রেন্ডারিং কীভাবে সিদ্ধান্ত নেওয়া বিজ্ঞাপন রেন্ডার করবেন তা বর্ণনা করে।JSON প্রতিনিধিত্ব |
---|
{ "duration_ms": number, "variants": map[string, object(VariantRendering)], } |
ক্ষেত্র | |
---|---|
duration_ms | number বিজ্ঞাপনের সময়কাল, মিলিসেকেন্ডে (ইনট)। |
variants | map[string, object(VariantRendering)] ভেরিয়েন্ট অবজেক্টের অভিধান (নীচে দেখুন), ইউআই থেকে কনফিগার করা হিসাবে বৈকল্পিক/প্রোফাইল আইডি দ্বারা সূচকযুক্ত। |
স্লেটারেন্ডারিং
স্লেটারেন্ডারিং কীভাবে স্লেট সামগ্রী রেন্ডার করবেন তা বর্ণনা করে।JSON প্রতিনিধিত্ব |
---|
{ "duration_ms": number, "variants": map[string, object(VariantRendering)], } |
ক্ষেত্র | |
---|---|
duration_ms | number স্লেটের সময়কাল, মিলিসেকেন্ডে (ইনট)। |
variants | map[string, object(VariantRendering)] বৈকল্পিক/প্রোফাইল আইডি দ্বারা সূচকযুক্ত বৈকল্পিক অবজেক্টের অভিধান। প্রয়োজনীয় স্লেটের দৈর্ঘ্য না পৌঁছানো পর্যন্ত স্লেটের সময়সীমাগুলি অবশ্যই লুপ করতে হবে, পুনরাবৃত্তির মধ্যে এইচএলএস বিচ্ছিন্নতা সন্নিবেশ করা বা এমপিইজি-ড্যাশের জন্য নতুন পিরিয়ডগুলি লুপ করে। |
বৈকল্পিক
ভেরিয়েন্ট্রেন্ডারিং বিজ্ঞাপন/স্লেটের মধ্যে একটি বৈকল্পিক/প্রোফাইল বর্ণনা করে।JSON প্রতিনিধিত্ব |
---|
{ "segment_extension": string, "segment_durations": object(SegmentDurations), } |
ক্ষেত্র | |
---|---|
segment_extension | string স্ট্রিং, একটি: টিএস, এমপি 4, এএসি, এসি 3, ইসি 3, এম 4 এ, এম 4 ভি। বিভাগের ইউআরএলগুলির ফাইলের নাম এক্সটেনশন অংশ। |
segment_durations | object(SegmentDurations) সেগমেন্টডিউরেশন অবজেক্টস। প্রতিটি বিভাগের সময়কাল একটি বিভাগের ইউআরএল অনুবাদ করা যেতে পারে। |
সেগমেন্টডিউরেশনস
সেগমেন্ট ডিউরেশনগুলি নির্দিষ্ট সময় ইউনিটে বিভাগগুলির ক্রমের সময়কাল বর্ণনা করে।JSON প্রতিনিধিত্ব |
---|
{ "timescale": number, "values": [], } |
ক্ষেত্র | |
---|---|
timescale | number টাইমস্কেল হ'ল প্রতি সেকেন্ডে (ইনট) ইউনিটগুলির সংখ্যা (ইনট) হবে: এইচএলএসের জন্য 1000 (মিলিসেকেন্ডস) 90000 ড্যাশ ভিডিওর জন্য 90000 (পিটিএস) ড্যাশ অডিওর জন্য অডিও নমুনা হারের জন্য। |
values | number টাইমস্কেল ইউনিটগুলিতে আইএনটি বিভাগের সময়কালের অ্যারে। |
ড্যাশপ্রেসেন্টেশন
ড্যাশপ্রেসেন্টেশন ড্যাশ প্রকাশে রেন্ডার করার জন্য উপস্থাপনা নোডগুলি বর্ণনা করে।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) উপস্থাপনের অডিও চ্যানেল কনফিগারেশন। |
ড্যাশডাপ্টেশনসেট
ড্যাশএডাপ্টেশনসেট ড্যাশ প্রকাশে রেন্ডার করার জন্য অভিযোজিত নোডগুলি বর্ণনা করে।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 অভিযোজন সেটের মাইম প্রকার। |
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 | string অভিযোজন সেট উপস্থাপনা। |
স্কিমিডুরিয়ানডভ্যালু
স্কিমিডুরিয়ানডভ্যালু হ'ল একটি স্কিম আইডি এবং এর মান।JSON প্রতিনিধিত্ব |
---|
{ "scheme_id_uri": string, "value": string, } |
ক্ষেত্র | |
---|---|
scheme_id_uri | string মানটির স্কিম আইডি ইউআরআই। |
value | string স্কিম আইডি ইউআরআই এর মান। |
আইকন
আইকনে একটি বিশাল আইকন সম্পর্কিত তথ্য রয়েছে।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 |
ক্লিকডাটা
ক্লিকডাতে আইকন ক্লিকথ্রু সম্পর্কিত তথ্য রয়েছে।JSON প্রতিনিধিত্ব |
---|
{ "url": string, } |
ক্ষেত্র | |
---|---|
url | string |
ফ্যালব্যাকিমেজ
ফ্যালব্যাকিমেজে একটি বিশাল ফ্যালব্যাক চিত্র সম্পর্কিত তথ্য রয়েছে।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 র্যাপার বিজ্ঞাপনের জন্য al চ্ছিক ডিল আইডি। |
যাচাইকরণ
যাচাইকরণে উন্মুক্ত পরিমাপের জন্য তথ্য রয়েছে, যা তৃতীয় পক্ষের দৃশ্যমানতা এবং যাচাইকরণ পরিমাপের সুবিধার্থে। বর্তমানে, কেবল জাভাস্ক্রিপ্ট সংস্থানগুলি সমর্থিত। Https://iabtechlab.com/standards/open-mesurement-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 একটি অস্বচ্ছ স্ট্রিং বুটস্ট্র্যাপ যাচাইকরণ কোডে পাস করেছে। |
জাভাস্ক্রিপ্টট্রেসোর্স
জাভাস্ক্রিপ্টট্রেসোর্সে জাভাস্ক্রিপ্টের মাধ্যমে যাচাইয়ের জন্য তথ্য রয়েছে।JSON প্রতিনিধিত্ব |
---|
{ "script_url": string, "api_framework": string, "browser_optional": boolean, } |
ক্ষেত্র | |
---|---|
script_url | string ইউআরআই থেকে জাভাস্ক্রিপ্ট পে -লোড। |
api_framework | string এপিফ্রেমওয়ার্ক হ'ল ভিডিও ফ্রেমওয়ার্কের যা যাচাইকরণ কোডটি অনুশীলন করে। |
browser_optional | boolean এই স্ক্রিপ্টটি কোনও ব্রাউজারের বাইরে চালানো যেতে পারে কিনা। |
ট্র্যাকিংএভেন্ট
ট্র্যাকিংএভেন্টে ইউআরএল রয়েছে যা নির্দিষ্ট পরিস্থিতিতে ক্লায়েন্ট দ্বারা পিন করা উচিত।JSON প্রতিনিধিত্ব |
---|
{ "event": string, "uri": string, } |
ক্ষেত্র | |
---|---|
event | string ট্র্যাকিং ইভেন্টের ধরণ। |
uri | string ট্র্যাকিং ইভেন্টটি পিন করা হবে। |
ইউনিভার্সালডিড
ইউনিভার্সালডিড একটি অনন্য সৃজনশীল শনাক্তকারী সরবরাহ করতে ব্যবহৃত হয় যা বিজ্ঞাপন সিস্টেমগুলিতে রক্ষণাবেক্ষণ করা হয়।JSON প্রতিনিধিত্ব |
---|
{ "id_value": string, "id_registry": string, } |
ক্ষেত্র | |
---|---|
id_value | string বিজ্ঞাপনের জন্য নির্বাচিত সৃজনশীলতার সর্বজনীন বিজ্ঞাপন আইডি। |
id_registry | string রেজিস্ট্রি ওয়েবসাইটের জন্য ইউআরএল সনাক্ত করতে ব্যবহৃত একটি স্ট্রিং যেখানে নির্বাচিত সৃজনশীল ইউনিভার্সাল এডি আইডি ক্যাটালোজ করা আছে। |
সহচর
সঙ্গী সহচর বিজ্ঞাপনগুলির জন্য তথ্য রয়েছে যা বিজ্ঞাপনের সাথে প্রদর্শিত হতে পারে।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 ক্রিয়েটিভ টাইপ অ্যাট্রিবিউট <স্ট্যাটিকরেসোর্স> নোডের উপর যদি এটি স্ট্যাটিক টাইপের সহযোগী হয়। |
height | int32 এই সঙ্গীর পিক্সেল উচ্চতা। |
width | int32 এই সঙ্গীর পিক্সেলের প্রস্থ। |
resource | string স্ট্যাটিক এবং আইফ্রেম সহচরদের জন্য এটি লোড এবং প্রদর্শিত হবে URL। এইচটিএমএল সঙ্গীদের জন্য, এটি এইচটিএমএল স্নিপেট হবে যা সহচর হিসাবে দেখানো উচিত। |
type | string এই সঙ্গীর ধরণ। এটি স্ট্যাটিক, আইফ্রেম বা এইচটিএমএল হতে পারে। |
ad_slot_id | string এই সঙ্গীর জন্য স্লট আইডি। |
api_framework | string এই সঙ্গীর জন্য এপিআই কাঠামো। |
tracking_events | [object(TrackingEvent)] এই সঙ্গীর জন্য ট্র্যাকিং ইভেন্টগুলির তালিকা। |
ইন্টারেক্টিভ ফাইল
ইন্টারেক্টিভ ফাইলটিতে ইন্টারেক্টিভ ক্রিয়েটিভ (অর্থাত্ সিমিড) এর জন্য তথ্য রয়েছে যা বিজ্ঞাপন প্লেব্যাকের সময় প্রদর্শিত হবে।JSON প্রতিনিধিত্ব |
---|
{ "resource": string, "type": string, "variable_duration": boolean, "ad_parameters": string, } |
ক্ষেত্র | |
---|---|
resource | string ইন্টারেক্টিভ ক্রিয়েটিভের জন্য ইউআরএল। |
type | string রিসোর্স হিসাবে সরবরাহ করা ফাইলের মাইম টাইপ। |
variable_duration | boolean এই সৃজনশীল সময়কাল বাড়ানোর জন্য জিজ্ঞাসা করতে পারে কিনা। |
ad_parameters | string বিশাল আকারে <অ্যাডপ্যারামিটার> নোডের মান। |
গতিশীল বিজ্ঞাপন সন্নিবেশ এপিআই আপনাকে অনুরোধ এবং ডাই লাইভস্ট্রিমগুলি ট্র্যাক করতে দেয়।
পরিষেবা: dai.google.com
সমস্ত ইউআরআই https://dai.google.com
এর সাথে সম্পর্কিত।
পদ্ধতি: স্ট্রিম
পদ্ধতি | |
---|---|
stream | POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream লাইভস্ট্রিম সেশন পরিবেশনকারী একটি ডাই ডাই পড নিবন্ধন করে। |
HTTP অনুরোধ
POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream
পাথ প্যারামিটার
পরামিতি | |
---|---|
network_code | string প্রকাশকের গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড। |
custom_asset_key | string কাস্টম আইডেন্টিফায়ার এই ইভেন্টটি গুগল অ্যাড ম্যানেজারে যুক্ত করেছে। |
শরীরের অনুরোধ
অনুরোধ বডিটি টাইপ application/x-www-form-urlencoded
এবং নিম্নলিখিত পরামিতিগুলি রয়েছে:
পরামিতি | ||
---|---|---|
ডিএফপি টার্গেটিং পরামিতি | ঐচ্ছিক | অতিরিক্ত টার্গেটিং পরামিতি। |
ওভাররাইড স্ট্রিম প্যারামিটার | ঐচ্ছিক | একটি স্ট্রিম তৈরির প্যারামিটারের ডিফল্ট মানগুলি ওভাররাইড করুন। |
এইচএমএসি প্রমাণীকরণ | ঐচ্ছিক | এইচএমএসি-ভিত্তিক টোকেন ব্যবহার করে প্রমাণীকরণ করুন। |
প্রতিক্রিয়া শরীর
যদি সফল হয় তবে প্রতিক্রিয়া বডিতে একটি নতুন Stream
অবজেক্ট রয়েছে।
ওপেন পরিমাপ
ডিএআই এপিআইতে Verifications
ক্ষেত্রে উন্মুক্ত পরিমাপ যাচাইয়ের জন্য তথ্য রয়েছে। এই ক্ষেত্রটিতে এক বা একাধিক Verification
উপাদান রয়েছে যা সৃজনশীল প্লেব্যাক যাচাই করার জন্য তৃতীয় পক্ষের পরিমাপ কোড কার্যকর করতে প্রয়োজনীয় সংস্থান এবং মেটাডেটা তালিকাভুক্ত করে। কেবল JavaScriptResource
সমর্থিত। আরও তথ্যের জন্য, দয়া করে আইএবি টেক ল্যাব এবং বিশাল 4.1 স্পেস দেখুন।
পদ্ধতি: পড বিভাগ
পদ্ধতি | |
---|---|
pod segment | GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format} প্রদত্ত ইভেন্ট আইডির জন্য একটি ডাই স্ট্রিম তৈরি করে। |
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 প্রকাশকের গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড। |
custom_asset_key | string কাস্টম আইডেন্টিফায়ার এই ইভেন্টটি গুগল অ্যাড ম্যানেজারে যুক্ত করেছে। |
pod_identifier | নিম্নলিখিত বিন্যাস সমর্থিত: pod/{integer} বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক সনাক্তকারী। এডি পিওডি আইডিগুলি প্রতিটি বিজ্ঞাপন বিরতি ইভেন্টের জন্য ক্রমবর্ধমানভাবে নির্ধারিত হয়, ad_break_id/{string} বর্তমান বিজ্ঞাপন বিরতির জন্য স্ট্রিং আইডেন্টিফায়ার। একটি প্রকাশক প্রদত্ত বিজ্ঞাপন বিরতি আইডির বিজ্ঞাপন পিওডি আইডি হিসাবে একই সীমাবদ্ধতা নেই। সেই শেষ পয়েন্টে সরবরাহ করা কোনও অজানা বিজ্ঞাপন বিরতি আইডি লাইভস্ট্রিম ইভেন্টের জন্য একটি নতুন বিজ্ঞাপন বিরতি তৈরি করে। |
profile_name | string অনুরোধ করা গুগল অ্যাড ম্যানেজার ডাই এনকোডিং প্রোফাইলের নাম । এনকোডিং প্রোফাইল অবশ্যই নির্বাচিত ইভেন্টের জন্য কনফিগার করা এনকোডিং প্রোফাইলগুলির মধ্যে একটি হতে হবে। |
segment_number | integer শূন্যের শুরুতে বর্তমান বিজ্ঞাপন পডের মধ্যে অনুরোধ করা বিভাগের সূচক। |
segment_format | string অনুরোধ করা বিভাগের বিন্যাসের সাথে যুক্ত ফাইল এক্সটেনশন। স্বীকৃত এক্সটেনশনগুলি হ'ল: |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
stream_id | প্রয়োজনীয় | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি | ||||
sd | required 1 | integer মিলিসেকেন্ডে অনুরোধ করা বিভাগের সময়কাল। | ||||
so | ঐচ্ছিক | মিলিসেকেন্ডে বিজ্ঞাপন পডের মধ্যে অনুরোধ করা বিভাগের অফসেট। আপনি যদি | ||||
pd | প্রয়োজনীয় 2 | integer মিলিসেকেন্ডে বিজ্ঞাপন পডের সময়কাল। | ||||
auth-token | প্রয়োজনীয় | string বর্তমান বিজ্ঞাপন পডের জন্য একটি স্বাক্ষরিত, ইউআরএল-এনকোডেড এইচএমএসি টোকেন । | ||||
last | ঐচ্ছিক | boolean বিজ্ঞাপন বিরতির শেষ বিভাগটি নির্দেশ করে। অন্যান্য সমস্ত বিভাগের জন্য এই প্যারামিটারটি বাদ দিন। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস 64-এনকোডেড এসসিটিই -35 সিগনাল। | ||||
cust_params | ঐচ্ছিক | string কী-মান জোড়গুলির একটি সেট, বিজ্ঞাপন পরিচালক প্রচারের জন্য টার্গেটিংয়ের জন্য ব্যবহৃত। এই জোড়াগুলি অবশ্যই একটি ইউআরএল-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে প্রতিনিধিত্ব করতে হবে। উদাহরণ:
|
পাদটীকা
- সূচনা বিভাগগুলির জন্য
sd
প্রয়োজন হয় না। ↩ - সময়কালহীন বিজ্ঞাপন বিরতি সক্ষম করা ইভেন্টগুলির জন্য
pd
প্রয়োজন হয় না। ↩
উদাহরণ
পান https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbrek -2/প্রোফাইল/8B8888CF79AD43F0800482FFC035A1AC_TS_A/1.TS? সুতরাং = 0 & এসডি = 10000 এবং পিডি = 30000 এবং স্ট্রিম_আইডি = 8E19CBC6-850B-404C-99D7-86060A4CB: Test
পান https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/2/2/2/2/2/2/2/2/Profi LE/8B8888CF79AD43F0800482FFC035A1AC_TS_A/1.TS? সুতরাং = 0 & এসডি = 10000 এবং পিডি = 30000 এবং স্ট্রিম_আইডি = 8E19CBC6-850B-404C-99D7-860A4A4A4A67440CB: টেস্ট
প্রতিক্রিয়া শরীর
যদি সফল হয় তবে প্রতিক্রিয়া বডিটি অনুরোধে নির্দিষ্ট ফর্ম্যাট এবং পরামিতিগুলির সাথে মেলে একটি প্লেযোগ্য স্ট্রিম বিভাগ হবে।
পদ্ধতি: এইচএলএস পড ম্যানিফেস্ট
একটি লাইভস্ট্রিমের এইচএলএস বিজ্ঞাপন পড ম্যানিফেস্ট পুনরুদ্ধার করে যা ক্লায়েন্ট ভিডিও প্লেয়ারকে লোড এবং খেলতে প্রস্তুত।
পদ্ধতি | |
---|---|
GET | GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/{pod_identifier}.m3u8; এপিআই একটি বিজ্ঞাপন পডের জন্য এইচএলএস মাল্টিভারিয়ান্ট প্লেলিস্ট পুনরুদ্ধার করতে। |
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 প্রকাশকের গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড। |
custom_asset_key | string কাস্টম আইডেন্টিফায়ার এই ইভেন্টটি গুগল বিজ্ঞাপন পরিচালকের সাথে যুক্ত |
pod_identifier | নিম্নলিখিত বিন্যাস সমর্থিত: pod/{integer} বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক সনাক্তকারী। এডি পিওডি আইডিগুলি প্রতিটি বিজ্ঞাপন বিরতি ইভেন্টের জন্য ক্রমবর্ধমানভাবে নির্ধারিত হয়, ad_break_id/{string} বর্তমান বিজ্ঞাপন বিরতির জন্য স্ট্রিং আইডেন্টিফায়ার। একটি প্রকাশক প্রদত্ত বিজ্ঞাপন বিরতি আইডির বিজ্ঞাপন পিওডি আইডি হিসাবে একই সীমাবদ্ধতা নেই। সেই শেষ পয়েন্টে সরবরাহ করা কোনও অজানা বিজ্ঞাপন বিরতি আইডি লাইভস্ট্রিম ইভেন্টের জন্য একটি নতুন বিজ্ঞাপন বিরতি তৈরি করে। |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
stream_id | প্রয়োজন | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি | ||||
pd | প্রয়োজন | integer মিলিসেকেন্ডে বিজ্ঞাপন পডের সময়কাল। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস 64-এনকোডেড এসসিটিই -35 সিগনাল। | ||||
cust_params | ঐচ্ছিক | string কী-মান জোড়গুলির একটি সেট, বিজ্ঞাপন পরিচালক প্রচারের জন্য টার্গেটিংয়ের জন্য ব্যবহৃত। এই জোড়াগুলি অবশ্যই একটি ইউআরএল-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে প্রতিনিধিত্ব করতে হবে। উদাহরণ:
|
প্রতিক্রিয়া শরীর
যদি সফল হয় তবে প্রতিক্রিয়া বডি একটি এইচএলএস মাল্টিভারিয়ান্ট প্লেলিস্ট।
পদ্ধতি: ড্যাশ পড ম্যানিফেস্ট
কোনও লাইভস্ট্রিমের এমপিইজি-ড্যাশ বিজ্ঞাপন পড ম্যানিফেস্ট পুনরুদ্ধার করে যা ক্লায়েন্ট ভিডিও প্লেয়ারকে লোড এবং খেলতে প্রস্তুত।
পদ্ধতি | |
---|---|
GET | GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/manifest.mpd এপিআই একটি বিজ্ঞাপন পডের জন্য এমপিইজি-ড্যাশ এমপিডি প্লেলিস্ট পুনরুদ্ধার করতে। |
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 প্রকাশকের গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড। |
custom_asset_key | string কাস্টম আইডেন্টিফায়ার এই ইভেন্টটি গুগল বিজ্ঞাপন পরিচালকের সাথে যুক্ত |
stream_id | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি |
pod_id | integer বর্তমান বিজ্ঞাপন বিরতির জন্য সংখ্যাসূচক সনাক্তকারী। এডি পিওডি আইডিগুলি প্রতিটি বিজ্ঞাপন বিরতি ইভেন্টের জন্য ক্রমবর্ধমানভাবে নির্ধারিত হয়, |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||||||
---|---|---|---|---|---|---|
pd | প্রয়োজন | integer মিলিসেকেন্ডে বিজ্ঞাপন পডের সময়কাল। | ||||
scte35 | ঐচ্ছিক | string এই বিজ্ঞাপন বিরতির জন্য বেস 64-এনকোডেড এসসিটিই -35 সিগনাল। | ||||
cust_params | ঐচ্ছিক | string কী-মান জোড়গুলির একটি সেট, বিজ্ঞাপন পরিচালক প্রচারের জন্য টার্গেটিংয়ের জন্য ব্যবহৃত। এই জোড়াগুলি অবশ্যই একটি ইউআরএল-এনকোডেড ক্যোয়ারী স্ট্রিং হিসাবে প্রতিনিধিত্ব করতে হবে। উদাহরণ:
|
প্রতিক্রিয়া শরীর
যদি সফল হয় তবে প্রতিক্রিয়া বডিটি এমপিইজি-ড্যাশ এমপিডি প্লেলিস্ট।
পদ্ধতি: ড্যাশ পড পিরিয়ড টেম্পলেট
পদ্ধতি | |
---|---|
pods | GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json গুগল বিজ্ঞাপন পরিচালকের কাছ থেকে ড্যাশ পিরিয়ড টেম্পলেট অনুরোধ করে। এই টেমপ্লেটে ম্যাক্রো রয়েছে যা আপনাকে অবশ্যই আপনার স্ট্রিম প্যারামিটারগুলির সাথে পপুলেট করতে হবে। একবার এই ম্যাক্রোগুলি জনবহুল হয়ে গেলে, টেমপ্লেটটি আপনার বিজ্ঞাপন বিরতির সময় হয়ে যায় এবং আপনার ড্যাশ ম্যানিফেস্টে সেলাই করা যায়। |
HTTP অনুরোধ
GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json
পাথ প্যারামিটার
পরামিতি | |
---|---|
network_code | string প্রকাশকের গুগল অ্যাড ম্যানেজার নেটওয়ার্ক কোড। |
custom_asset_key | string কাস্টম আইডেন্টিফায়ার এই ইভেন্টটি গুগল অ্যাড ম্যানেজারে যুক্ত করেছে। |
ক্যোয়ারী প্যারামিটার
পরামিতি | ||
---|---|---|
stream_id | প্রয়োজনীয় | string বর্তমান ব্যবহারকারীর সেশনের জন্য স্ট্রিম আইডি। এই মানটি |
প্রতিক্রিয়া শরীর
যদি সফল হয় তবে প্রতিক্রিয়া বডিতে একটি নতুন PodTemplateResponse
অবজেক্ট রয়েছে।
পদ্ধতি: মিডিয়া যাচাইকরণ
প্লেব্যাক চলাকালীন কোনও বিজ্ঞাপন মিডিয়া আইডেন্টিফায়ারের মুখোমুখি হওয়ার পরে, তত্ক্ষণাত্ উপরের স্ট্রিমের শেষ পয়েন্ট থেকে প্রাপ্ত মিডিয়া_ভারিফিকেশন_আরএল ব্যবহার করে একটি অনুরোধ করুন। এই অনুরোধগুলি সার্ভার-সাইড-বেয়ারকনিং স্ট্রিমগুলির জন্য প্রয়োজনীয় নয়, যেখানে সার্ভার মিডিয়া যাচাইয়ের সূচনা করে।
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
যদি এই সময়ে ইতিমধ্যে অন্য কোনও অনুরোধ পিংস প্রেরণ করে।
বিজ্ঞাপন মিডিয়া আইডিএস
এডি মিডিয়া শনাক্তকারীগুলি একটি পৃথক মেটাডেটা ট্র্যাক - এইচএলএস ট্রান্সপোর্ট স্ট্রিমের জন্য সময়োচিত মেটাডেটা, বা এমপি 4 ফাইলগুলির জন্য ইএমএসজি এনকোড করা হবে। বিজ্ঞাপন মিডিয়া শনাক্তকারীরা সর্বদা স্ট্রিং google_
দিয়ে শুরু হবে।
মেটাডেটা এন্ট্রির পুরো পাঠ্য সামগ্রীগুলি প্রতিটি বিজ্ঞাপন যাচাইয়ের অনুরোধ করার আগে বিজ্ঞাপন যাচাইকরণ ইউআরএলে যুক্ত করা উচিত।
পদ্ধতি: মেটাডেটা
metadata_url
মেটাডেটা শেষ পয়েন্টটি একটি বিজ্ঞাপন ইউআই তৈরির জন্য ব্যবহৃত তথ্য দেয়। The metadata endpoint isn't available for server-side-beaconing streams, where the server is responsible for initiating ad media verification.
পদ্ধতি | |
---|---|
metadata | GET /{metadata_url}/{ad-media-id} GET /{metadata_url} Retrieves ad metadata information. |
HTTP অনুরোধ
GET https://{metadata_url}/{ad-media-id}
GET https://{metadata_url}
প্রতিক্রিয়া শরীর
If successful, the response returns an instance of PodMetadata
.
Parsing Metadata
Metadata has three discrete sections: tags
, ads
, and ad breaks
. The entry point into the data is the tags
section. From there, iterate through the tags and find the first entry whose name is a prefix for the ad media ID found in the video stream. For example, you might have an ad media ID that looks like:
google_1234567890
Then you find a tag object named google_12345
. In this case, it matches your ad media id. Once you find the correct ad media prefix object, you can look up ad ids, ad break ids, and the event type. Ad ids are then used to index the ads
objects and ad break ids are used to index the breaks
objects.
প্রতিক্রিয়া তথ্য
প্রবাহ
Stream is used to render a list of resources for a newly created stream in JSON format.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 The GAM stream identifier. |
media_verification_url | string The media verification URL used as base endpoint for tracking playback events. |
metadata_url | string Metadata URL used to poll for periodic information about upcoming stream ad events. |
session_update_url | string The session's update URL used to update the targeting parameters for this stream. The original values for the targeting parameters are captured during the initial stream create request. |
heartbeat_url | string The heartbeat URL, used to keep the server side beaconing stream alive, it must be pinged every {PollingFrequency} seconds. Populated for server side beaconing streams. |
polling_frequency | number The polling frequency, in seconds, when requesting metadata_url or heartbeat_url. |
pod_manifest_url | string The pod manifest URL template is used to generate the URL to retrieve a stream's pod manifest, corresponding to the URL of the multivariant playlist in HLS or the MPD in DASH. Populated for Livestream events of Dynamic Ad Insertion type POD_SERVING_MANIFEST. https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType |
manifest_format | string Manifest format is the format of the manifest retrieved from pod_manifest_url, either dash or hls. |
PodMetadata
PodMetadata contains metadata information on ads, ad breaks, and media ID tags.JSON প্রতিনিধিত্ব |
---|
{ "tags": map[string, object(TagSegment)], "ads": map[string, object(Ad)], "ad_breaks": map[string, object(AdBreak)], } |
ক্ষেত্র | |
---|---|
tags | map[string, object(TagSegment)] Map of tag segments indexed by tag prefix. |
ads | map[string, object(Ad)] Map of ads indexed by ad ID. |
ad_breaks | map[string, object(AdBreak)] Map of ad breaks indexed by ad break ID. |
TagSegment
TagSegment contains a reference to an ad, its ad break, and event type. TagSegment with type="progress" should not be pinged to the ad media verification endpoint.JSON প্রতিনিধিত্ব |
---|
{ "ad": string, "ad_break_id": string, "type": string, } |
ক্ষেত্র | |
---|---|
ad | string The ID of this tag's ad. |
ad_break_id | string The ID of this tag's ad break. |
type | string This tag's event type. |
AdBreak
AdBreak describes a single ad break in the stream. It contains a duration, a type (mid/pre/post) and the number of ads.JSON প্রতিনিধিত্ব |
---|
{ "type": string, "duration": number, "expected_duration": number, "ads": number, } |
ক্ষেত্র | |
---|---|
type | string Valid break types are: pre, mid, and post. |
duration | number Total ad duration for this ad break, in seconds. |
expected_duration | number Expected duration of the ad break (in seconds), including all ads and any slate. |
ads | number Number of ads in the ad break. |
বিজ্ঞাপন
Ad describes an ad in the stream.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 The ID of this ad's ad break. |
position | number Position of this ad in the ad break, starting at 1. |
duration | number Duration of the ad, in seconds. |
title | string Optional title of the ad. |
description | string Optional description of the ad. |
advertiser | string Optional advertiser identifier. |
ad_system | string Optional ad system. |
ad_id | string Optional ad ID. |
creative_id | string Optional creative ID. |
creative_ad_id | string Optional creative ad ID. |
deal_id | string Optional deal ID. |
clickthrough_url | string Optional clickthrough URL. |
click_tracking_urls | string Optional click tracking URLs. |
verifications | [object(Verification)] Optional Open Measurement verification entries which list the resources and metadata required to execute third-party measurement code to verify creative playback. |
slate | boolean Optional bool indicating the current entry is slate. |
icons | [object(Icon)] A list of icons, omitted if empty. |
wrappers | [object(Wrapper)] A list of Wrappers, omitted if empty. |
universal_ad_id | object(UniversalAdID) Optional universal ad ID. |
extensions | string Optional list of all <Extension> nodes in the VAST. |
companions | [object(Companion)] Optional companions that may be displayed along with this ad. |
interactive_file | object(InteractiveFile) Optional interactive creative (SIMID) that should be displayed during ad playback. |
PodTemplateResponse
PodTemplateResponse represents the JSON payload returned to a VTP for pod stitching.JSON প্রতিনিধিত্ব |
---|
{ "dash_period_template": string, "segment_duration_ms": int64, } |
ক্ষেত্র | |
---|---|
dash_period_template | string DashPeriodTemplate is the xml template for the period to be filled with appropriate data before stitching. |
segment_duration_ms | int64 SegmentDurationMS is the duration of the period segments in milliseconds. |
AdpodTimingMetadataResponse
AdpodTimingMetadataResponse contains information about the Ad Pod and how to build segment URLs for it.JSON প্রতিনিধিত্ব |
---|
{ "status": string, "ads": [object(AdRendering)], "slate": object(SlateRendering), "dash_representations": map[string, object(DASHRepresentation)], "dash_adaptation_sets": map[string, object(DASHAdaptationSet)], } |
ক্ষেত্র | |
---|---|
status | string Decision status for the ad pod. |
ads | [object(AdRendering)] Array of Ad objects describing how to render the ad segment urls, indexed starting at 0. |
slate | object(SlateRendering) Slate describing how to render the slate segment urls. |
dash_representations | map[string, object(DASHRepresentation)] List of DASH Representations for that ad pod to be rendered in DASH manifests. |
dash_adaptation_sets | map[string, object(DASHAdaptationSet)] List of DASH Adaptation Sets for that ad pod to be rendered in DASH manifests. |
AdRendering
AdRendering describes how to render a decisioned ad.JSON প্রতিনিধিত্ব |
---|
{ "duration_ms": number, "variants": map[string, object(VariantRendering)], } |
ক্ষেত্র | |
---|---|
duration_ms | number Duration of the ad, in milliseconds (int). |
variants | map[string, object(VariantRendering)] Dictionary of Variant objects (see below), indexed by the variant/profile ID, as configured from the UI. |
SlateRendering
SlateRendering describes how to render slate content.JSON প্রতিনিধিত্ব |
---|
{ "duration_ms": number, "variants": map[string, object(VariantRendering)], } |
ক্ষেত্র | |
---|---|
duration_ms | number Duration of the slate, in milliseconds (int). |
variants | map[string, object(VariantRendering)] Dictionary of Variant objects, indexed by variant/profile ID. Slate durations must be looped until the required slate length is reached, inserting HLS discontinuities between iterations, or looping new periods for MPEG-DASH. |
VariantRendering
VariantRendering describes one variant/profile within the ad/slate.JSON প্রতিনিধিত্ব |
---|
{ "segment_extension": string, "segment_durations": object(SegmentDurations), } |
ক্ষেত্র | |
---|---|
segment_extension | string String, one of: ts, mp4, aac, ac3, ec3, m4a, m4v. Filename extension part of the segment URLs. |
segment_durations | object(SegmentDurations) SegmentDurations objects. Each segment duration can be translated into a segment URL. |
SegmentDurations
SegmentDurations describes the duration of a sequence of segments, in a specified time unit.JSON প্রতিনিধিত্ব |
---|
{ "timescale": number, "values": [], } |
ক্ষেত্র | |
---|---|
timescale | number Timescale is the number of units per second (int) Expected to be: 1000 for HLS (milliseconds) 90000 for DASH video (PTS) Audio sample rate for DASH audio. |
values | number Array of int segment durations, in timescale units. |
DASHRepresentation
DASHRepresentation describes Representation nodes to be rendered in DASH manifests.JSON প্রতিনিধিত্ব |
---|
{ "codecs": string, "bandwidth": number, "width": number, "height": number, "frame_rate": string, "audio_sampling_rate": number, "audio_channel_config": object(SchemeIDURIAndValue), } |
ক্ষেত্র | |
---|---|
codecs | string Codecs of the representation. |
bandwidth | number Bandwidth of the representation. |
width | number Width of the representation. |
height | number Height of the representation. |
frame_rate | string Frame rate of the representation. |
audio_sampling_rate | number Audio sampling rate of the representation. |
audio_channel_config | object(SchemeIDURIAndValue) Audio channel configuration of the representation. |
DASHAdaptationSet
DASHAdaptationSet describes AdaptationSet nodes to be rendered in DASH manifests.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 Content type of the adaptation set. |
mime_type | string MIME type of the adaptation set. |
role | object(SchemeIDURIAndValue) Role of the adaptation set. |
inband_event_stream | object(SchemeIDURIAndValue) Inband event stream of the adaptation set. |
min_frame_rate | string Minimum frame rate of the adaptation set. |
max_frame_rate | string Maximum frame rate of the adaptation set. |
scan_type | string Scan type of the adaptation set. |
start_with_sap | string Start with SAP of the adaptation set. |
segment_alignment | boolean Segment alignment of the adaptation set. |
representations | string Representations of the adaptation set. |
SchemeIDURIAndValue
SchemeIDURIAndValue is a pair of a scheme ID and its value.JSON প্রতিনিধিত্ব |
---|
{ "scheme_id_uri": string, "value": string, } |
ক্ষেত্র | |
---|---|
scheme_id_uri | string Scheme ID URI of the value. |
value | string Value of the scheme ID URI. |
আইকন
Icon contains information about a VAST Icon.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
ClickData contains information about an icon clickthrough.JSON প্রতিনিধিত্ব |
---|
{ "url": string, } |
ক্ষেত্র | |
---|---|
url | string |
FallbackImage
FallbackImage contains information about a VAST fallback image.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 |
মোড়ক
Wrapper contains information about a wrapper ad. It does not include a Deal ID if it does not exist.JSON প্রতিনিধিত্ব |
---|
{ "system": string, "ad_id": string, "creative_id": string, "creative_ad_id": string, "deal_id": string, } |
ক্ষেত্র | |
---|---|
system | string Ad system identifier. |
ad_id | string Ad ID used for the wrapper ad. |
creative_id | string Creative ID used for the wrapper ad. |
creative_ad_id | string Creative Ad ID used for the wrapper ad. |
deal_id | string Optional deal ID for the wrapper ad. |
যাচাইকরণ
Verification contains information for Open Measurement, which facilitates third-party viewability and verification measurement. Currently, only JavaScript resources are supported. See https://iabtechlab.com/standards/open-measurement-sdk/JSON প্রতিনিধিত্ব |
---|
{ "vendor": string, "java_script_resources": [object(JavaScriptResource)], "tracking_events": [object(TrackingEvent)], "parameters": string, } |
ক্ষেত্র | |
---|---|
vendor | string The verification vendor. |
java_script_resources | [object(JavaScriptResource)] List of JavaScript resources for the verification. |
tracking_events | [object(TrackingEvent)] List of tracking events for the verification. |
parameters | string An opaque string passed to bootstrap verification code. |
JavaScriptResource
JavaScriptResource contains information for verification via JavaScript.JSON প্রতিনিধিত্ব |
---|
{ "script_url": string, "api_framework": string, "browser_optional": boolean, } |
ক্ষেত্র | |
---|---|
script_url | string URI to javascript payload. |
api_framework | string APIFramework is the name of the video framework exercising the verification code. |
browser_optional | boolean Whether this script can be run outside of a browser. |
TrackingEvent
TrackingEvent contains URLs that should be pinged by the client in certain situations.JSON প্রতিনিধিত্ব |
---|
{ "event": string, "uri": string, } |
ক্ষেত্র | |
---|---|
event | string The type of the tracking event. |
uri | string The tracking event to be pinged. |
UniversalAdID
UniversalAdID is used to provide a unique creative identifier that is maintained across ad systems.JSON প্রতিনিধিত্ব |
---|
{ "id_value": string, "id_registry": string, } |
ক্ষেত্র | |
---|---|
id_value | string The Universal Ad ID of the selected creative for the ad. |
id_registry | string A string used to identify the URL for the registry website where the selected creative's Universal Ad ID is cataloged. |
সহচর
Companion contains information for companion ads that may be displayed along with ad.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) The click data for this companion. |
creative_type | string The CreativeType attribute on the <StaticResource> node in the VAST if this is a companion of type static. |
height | int32 The height in pixels of this companion. |
width | int32 The width in pixels of this companion. |
resource | string For static and iframe companions this will be the URL to be loaded and displayed. For HTML companions, this will be the HTML snippet that should be shown as the companion. |
type | string Type of this companion. It can be either static, iframe or HTML. |
ad_slot_id | string The slot ID for this companion. |
api_framework | string The API framework for this companion. |
tracking_events | [object(TrackingEvent)] List of tracking events for this companion. |
InteractiveFile
InteractiveFile contains information for interactive creative (ie SIMID) that should be displayed during ad playback.JSON প্রতিনিধিত্ব |
---|
{ "resource": string, "type": string, "variable_duration": boolean, "ad_parameters": string, } |
ক্ষেত্র | |
---|---|
resource | string The URL to the interactive creative. |
type | string The MIME type of the file provided as the resource. |
variable_duration | boolean Whether this creative may ask for the duration to be extended. |
ad_parameters | string The value of the <AdParameters> node in the VAST. |