প্রাথমিক ধারণা

এই পৃষ্ঠায় Google Ad Manager API-এর আর্কিটেকচারের ওভারভিউ প্রদান করা হয়েছে এবং Ad Manager-এর সাধারণ ধারণা ও পরিভাষা বর্ণনা করা হয়েছে।

API আর্কিটেকচার

Ad Manager API-এর প্রধান ক্লাসগুলির একটি সরলীকৃত ডায়াগ্রাম এবং সেগুলি একে অপরের সাথে কীভাবে সম্পর্কিত তা এখানে দেওয়া হল:

অর্ডার দিন

একটি Order অবজেক্টে অর্ডার সম্পর্কে সাধারণ তথ্য থাকে, যেমন মুদ্রা বা বিক্রয়কর্মী এবং এতে এক বা একাধিক LineItem ইনস্ট্যান্স থাকে। কোডে, প্রতিটি LineItem-এ তার Order-এর আইডি থাকে, Order-এ LineItem অবজেক্টের তালিকা থাকে না।

LineItem

একটি LineItem অবজেক্ট বিজ্ঞাপন দেখানোর জন্য প্রয়োজনীয় শর্তের সেট বর্ণনা করে, যার মধ্যে রয়েছে কীভাবে এবং কখন বিজ্ঞাপন দেখানো উচিত, এটি যে ক্রিয়েটিভ দেখাবে তার সাইজ এবং সেগুলি দেখানোর ক্রম (ক্রম, ওয়েটেড বা তাদের পারফর্ম্যান্স অনুযায়ী), এইসব বিজ্ঞাপনের অগ্রাধিকার এবং খরচ সংক্রান্ত স্ট্রাকচার বর্ণনা করে এমন অনেক প্রপার্টি। একটি LineItem-এ একটি InventoryTargeting অবজেক্ট থাকে যা বর্ণনা করে যে এটি কোন AdUnit এবং Placement অবজেক্টকে টার্গেট করতে পারে এবং ঐচ্ছিক অতিরিক্ত Targeting সাবক্লাস অবজেক্ট যা ভৌগোলিক, কাস্টম বা অন্যান্য মানদণ্ডকে উপস্থাপন করে।

LineItemCreativeAssociation

একটি LineItemCreativeAssociation (প্রায়শই LICA বলা হয়) একটি LineItem-কে একটি Creative-এর সাথে লিঙ্ক করে। একাধিক ক্রিয়েটিভের সাথে লাইন আইটেম লিঙ্ক করা যেতে পারে এবং আপনার অ্যাকাউন্টের ধরনের উপর নির্ভর করে, আপনি একাধিক লাইন আইটেমের সাথে একটি ক্রিয়েটিভ লিঙ্ক করতে পারেন। আপনি LineItemCreativeAssociation তৈরি করার সময়, Ad Manager প্রথমে চেক করে দেখে যে ক্রিয়েটিভ ও লাইন আইটেম, দুটিই মানানসই কিনা; যেমন, সাইজ আলাদা হলে, আপনি অ্যাসোসিয়েশন তৈরি বা আপডেট করার চেষ্টা করলে সমস্যা হবে। এই অবজেক্ট আপনাকে সংশ্লিষ্ট LineItem-এর কিছু ভ্যালু ওভাররাইড করার অনুমতি দেয়, যেমন শুরু/শেষের তারিখ বা সাইজ (আপনার কাছে এমন ক্রিয়েটিভ থাকলে যা লাইন আইটেমের নির্দিষ্ট করা সাইজের সাথে ঠিক মানানসই নয়, কিন্তু আপনি Ad Manager-কে অনুমতি দিতে চান যাতে এটি ক্রিয়েটিভের সাইজ অ্যাডজাস্ট করে বিজ্ঞাপন ইউনিটের সাথে মানানসই করে তোলে)। Ad Manager ইউজার ইন্টারফেসে LICA দেখানো হয় না; এটি একটি API কনভেনশন।

ক্রিয়েটিভ

একটি Creative আসল বিজ্ঞাপনকে দেখায়। Ad Manager-এর মাধ্যমে বিজ্ঞাপন হোস্ট করা হলে, এই অবজেক্টে Ad Manager-এর সার্ভারে স্টোর করা আসল ইমেজ বাইট, ফ্ল্যাশ ফাইল বা কাস্টম HTML ট্যাগ থাকে; থার্ড-পার্টি সাইটে ক্রিয়েটিভ হোস্ট করা হলে, ক্রিয়েটিভ হল একটি URL বা HTML স্নিপেট যা থার্ড-পার্টি সার্ভার থেকে অনুরোধ করে।

InventoryTargeting এবং Targeting সাবক্লাস

InventoryTargeting অবজেক্টে সেইসব বিজ্ঞাপন ইউনিটের তালিকা থাকে যেগুলি নির্দিষ্ট LineItem-এর সাথে যুক্ত। আপনি Targeting-এর উপযুক্ত সাবক্লাসের অতিরিক্ত ইনস্ট্যান্স ব্যবহার করে অতিরিক্ত, ঐচ্ছিক টার্গেটিং মাপকাঠি নির্দিষ্ট করতে পারেন।

প্লেসমেন্ট

একটি Placement অবজেক্ট হল এক বা একাধিক AdUnit অবজেক্টের সংগ্রহ।

AdUnit

একটি AdUnit এক বা একাধিক পৃষ্ঠায় বিজ্ঞাপনের লোকেশন দেখায়। AdUnit, LineItem-এর InventoryTargeting অবজেক্ট অথবা Placement অবজেক্টের টার্গেট হতে পারে। AdUnit অবজেক্টে সাইজ, আইডি ও অনন্য নাম থাকে। API-এর মধ্যে অন্যান্য AdUnit অবজেক্ট শনাক্ত করতে আইডি ব্যবহার করা হয়; HTML ট্যাগে অনন্য শনাক্তকারী হিসেবে নাম ব্যবহার করা হয় যাতে নির্দিষ্ট AdUnit অবজেক্ট শনাক্ত করা যায় এবং পৃষ্ঠা অনুরোধের অংশ হিসেবে Ad Manager-এ ফেরত পাঠানো হয়।