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

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

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

নীচের সমস্ত URIগুলি https://dai.google.com এর সাথে সম্পর্কিত৷

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

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

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

HTTP অনুরোধ

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

শিরোনাম অনুরোধ করুন

পরামিতি
api‑key string

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

অনুরোধের অংশে এটি প্রদান করার পরিবর্তে, API কী নিম্নলিখিত বিন্যাস সহ HTTP অনুমোদন শিরোনামে পাস করা যেতে পারে:

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

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

পরামিতি
assetKey string

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

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

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

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

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

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

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

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

খোলা পরিমাপ

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

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

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

বিজ্ঞাপন মিডিয়া শনাক্তকারীগুলি "ব্যবহারকারী-সংজ্ঞায়িত পাঠ্য তথ্য" ফ্রেমের জন্য সংরক্ষিত TXXX কী ব্যবহার করে HLS টাইমড মেটাডেটাতে এনকোড করা হবে৷ ফ্রেমের বিষয়বস্তু এনক্রিপ্ট করা হবে না এবং সর্বদা "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,
  "stream_manifest": string,
  "hls_master_playlist": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "polling_frequency": number,
}
ক্ষেত্র
stream_id string

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

স্ট্রিমের ম্যানিফেস্ট, HLS-এ মাস্টার প্লেলিস্ট বা DASH-এর MPD-এর সাথে সম্পর্কিত। এটি "স্ট্রিম_আইডি" ছাড়াও একমাত্র ক্ষেত্র যা একটি সার্ভার-সাইড-বীকনিং স্ট্রীম তৈরি করার সময় প্রতিক্রিয়াতে উপস্থিত থাকে।
hls_master_playlist string

(অপ্রচলিত) HLS মাস্টার প্লেলিস্ট URL। পরিবর্তে "স্ট্রিম_ম্যানিফেস্ট" ব্যবহার করুন।
media_verification_url string

মিডিয়া যাচাইকরণ URL।
metadata_url string

বিজ্ঞাপন মিডিয়া মেটাডেটা URL.
session_update_url string

সেশন আপডেট URL.
polling_frequency number

প্রস্তাবিত মেটাডেটা ইউআরএল পোলিং ফ্রিকোয়েন্সি, সেকেন্ডে।

পডমেটাডেটা

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) যা বিজ্ঞাপন প্লেব্যাকের সময় প্রদর্শিত হওয়া উচিত।

আইকন

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

ট্র্যাকিং ইভেন্টের ধরন, বর্তমানে একমাত্র বিকল্প হল "verificationNotExecuted" যেমন VAST 4.1 স্পেসিফিকেশনে উল্লেখ করা হয়েছে।
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,
}
ক্ষেত্র
click_data object(ClickData)

এই সঙ্গীর জন্য ক্লিক ডেটা.
creative_type string

VAST-এ <StaticResource> নোডে CreativeType অ্যাট্রিবিউট যদি এটি স্ট্যাটিক টাইপের সহচর হয়।
height int32

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

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

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

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

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

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