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

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

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

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

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

HTTP অনুরোধ

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

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

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

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

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

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

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

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

খোলা পরিমাপ

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

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

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

media verification এন্ডপয়েন্টে অনুরোধগুলো অদম্য।

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 তৈরি করতে ব্যবহৃত তথ্য প্রদান করে। মেটাডেটা এন্ডপয়েন্ট সার্ভার-সাইড-বীকনিং স্ট্রিমগুলির জন্য উপলব্ধ নয়, যেখানে সার্ভার বিজ্ঞাপন মিডিয়া যাচাইকরণ শুরু করার জন্য দায়ী৷

HTTP অনুরোধ

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

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

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

মেটাডেটা নিয়ে কাজ করা

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

google_1234567890

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

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

প্রবাহ

{
  "stream_id": string,
  "stream_manifest": string,
  "hls_master_playlist": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "polling_frequency": number,
}

পডমেটাডেটা

{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}

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

{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}

অ্যাডব্রেক

{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}

বিজ্ঞাপন

{
  "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),
}

আইকন

{
  "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,
}

ক্লিক ডাটা

{
  "url": string,
}

ফলব্যাক ইমেজ

{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}

মোড়ক

{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}

যাচাইকরণ

{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}

জাভাস্ক্রিপ্ট রিসোর্স

{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}

ট্র্যাকিং ইভেন্ট

{
  "event": string,
  "uri": string,
}

ইউনিভার্সালএডিআইডি

{
  "id_value": string,
  "id_registry": string,
}

সহচর

{
  "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)],
}

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

{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}