আপনার অ্যাপ্লিকেশন Google থেকে বিড অনুরোধ প্রক্রিয়া করার পরে, এটি তৈরি করে একটি প্রতিক্রিয়া পাঠাতে হবে। এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে প্রতিক্রিয়া তৈরি করতে আপনার অ্যাপ্লিকেশন কোড করবেন।
BidResponse বার্তা তৈরি করুন
একটি বিড জমা দেওয়ার জন্য, আপনার বিডিং অ্যাপ্লিকেশানটি অবশ্যই আপনার কনফিগার করা ফর্ম্যাটে একটি Bid সহ একটি BidResponse সহ একটি বিড অনুরোধে সাড়া দিতে হবে। আপনি যদি JSON ফর্ম্যাট ব্যবহার করেন, আপনার প্রতিক্রিয়া অবশ্যই Content-Type হেডারকে application/json; charset=utf-8 এবং বডিতে JSON BidResponse অন্তর্ভুক্ত করুন। আপনি যদি Protobuf ফরম্যাট ব্যবহার করেন, তাহলে আপনার অ্যাপ্লিকেশানটিকে অবশ্যই Content-Type হেডারকে application/octet-stream সেট করতে হবে এবং বডিতে সিরিয়ালাইজড BidResponse অন্তর্ভুক্ত করতে হবে।
Protobuf ফরম্যাটের জন্য একটি BidResponse তৈরি এবং সিরিয়াল করার জন্য, আপনাকে openrtb.proto এবং openrtb-adx.proto-এর উপর ভিত্তি করে প্রোটোবুফ লাইব্রেরি তৈরি এবং ব্যবহার করতে হবে, যা যথাক্রমে Protobuf-এ আদর্শ OpenRTB BidResponse ক্ষেত্র এবং Google এক্সটেনশনগুলি বাস্তবায়ন করে৷ এগুলি প্রোটোস এবং রেফারেন্স ডেটাতে পাওয়া যাবে।
আপনি যদি ইম্প্রেশনে বিড করতে না চান, তাহলে আপনাকে অবশ্যই একটি খালি HTTP 204 প্রতিক্রিয়া ফেরত দিতে হবে। আপনার আবেদনটি অবশ্যই প্রতিটি BidRequest একটি প্রতিক্রিয়া প্রদান করবে। টাইমআউট এবং প্রতিক্রিয়া যেগুলিকে পার্স করা যায় না সেগুলিকে ত্রুটি হিসাবে বিবেচনা করা হয় এবং Google উচ্চ ত্রুটির হার সহ বিডারদের থ্রোটল করে৷
ক্রিয়েটিভ আইডি
আপনার BidResponseBidResponse.seatbid.bid.crid ক্ষেত্রের (64 বাইট সীমা) মাধ্যমে একটি সৃজনশীল নির্দিষ্ট করে। এমনকি একই ধরনের ক্রিয়েটিভের অবশ্যই এই ক্ষেত্রের জন্য অনন্য মান থাকতে হবে যদি তারা কোনো উল্লেখযোগ্য বৈশিষ্ট্যের মধ্যে ভিন্ন হয়, যার মধ্যে রয়েছে কিন্তু সীমাবদ্ধ নয়: আকার, ঘোষিত URL, সৃজনশীল বৈশিষ্ট্য এবং বিক্রেতার প্রকারগুলি। অন্য কথায়, যেকোনো দুটি বিজ্ঞাপনে আপনাকে অবশ্যই আলাদা সৃজনশীল আইডি দিতে হবে যা:
ভিন্নভাবে দেখুন বা আচরণ করুন।
বিভিন্ন ইমেজ রেন্ডার.
বিভিন্ন উপায়ে রেন্ডার করুন (উদাহরণস্বরূপ, একটি বিজ্ঞাপনে একটি ছবি থাকে, অন্যটি একটি ভিডিও)।
আপনি যখন আপনার অ্যাপ্লিকেশনটি ডিজাইন করবেন, তখন আপনার শনাক্তকারী তৈরি করার একটি পদ্ধতিগত পদ্ধতির বিষয়ে সিদ্ধান্ত নেওয়া উচিত যা আপনি যে ধরণের সৃজনশীলগুলি জমা দেওয়ার পরিকল্পনা করছেন তার জন্য বোধগম্য হয়৷
বিজ্ঞাপন বৈশিষ্ট্য
BidResponse.seatbid.bid.apis এবং BidResponse.seatbid.bid.attr , অথবা BidResponse.seatbid.bid.ext.attribute এর সংমিশ্রণ ব্যবহার করে আপনার বিজ্ঞাপনের বৈশিষ্ট্য এবং এর টার্গেটিং বর্ণনা করার জন্য Google সৃজনশীল গুণাবলী ঘোষণা করার সুপারিশ করে। আপনি কীভাবে গুণাবলী ঘোষণা করতে পারেন তা নিম্নলিখিত বর্ণনা করে:
VPAID
BidResponse.seatbid.bid.apisVPAID_1 বা VPAID_2 এ সেট করুন। JSON বিন্যাসের জন্য, এটি যথাক্রমে 1 বা 2 সেট করা যেতে পারে।
MRAID
JSON ফর্ম্যাটের জন্য BidResponse.seatbid.bid.apisMRAID_1 বা 3 এ সেট করুন।
SIZELESS
JSON ফর্ম্যাটের জন্য BidResponse.seatbid.bid.attrRESPONSIVE বা 18 সেট করুন।
PLAYABLE
এটি BidResponse.seatbid.bid.attr কে USER_INTERACTIVE , বা JSON ফর্ম্যাটের জন্য 13 সেট করে নির্দেশিত হয়৷
আপনার ক্রিয়েটিভের শনাক্ত করা বৈশিষ্ট্য সম্পর্কে প্রতিক্রিয়া কীভাবে পেতে হয় তার ব্যাখ্যার জন্য ক্রিয়েটিভ রিসোর্স দেখুন।
ওপেন বিডিং ক্ষেত্র
ওপেন বিডিং-এ অংশগ্রহণকারী এক্সচেঞ্জ এবং নেটওয়ার্ক দরদাতাদের পাঠানো বিড প্রতিক্রিয়া স্ট্যান্ডার্ড রিয়েল-টাইম বিডিং-এ অংশগ্রহণকারী অনুমোদিত ক্রেতাদের মতই। ওপেন বিডিং গ্রাহকরা অল্প সংখ্যক অতিরিক্ত ক্ষেত্র নির্দিষ্ট করতে পারেন এবং কয়েকটি বিদ্যমান ক্ষেত্রের বিকল্প ব্যবহার থাকতে পারে। এর মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
মাঠ
বিস্তারিত
BidResponse.imp.pmp.deals.id
এক্সচেঞ্জের নামস্থান থেকে ডিল আইডি যা এই বিডের সাথে যুক্ত এবং প্রকাশকদের রিপোর্ট করা হয়েছে।
BidResponse.seatbid.bid.ext.exchange_deal_type
ডিলের ধরন প্রকাশকদের রিপোর্ট করা হয়, নিলামে ডিলটি কীভাবে আচরণ করা হয় তা প্রভাবিত করে।
টোকেন শেষ তৃতীয় পক্ষের ক্রেতার তথ্য সনাক্ত করতে ব্যবহৃত হয় যদি একটি ওপেন বিডার হিসাবে বিনিময় একটি মধ্যস্থতাকারী হয়। এটি তৃতীয় পক্ষের ক্রেতার কাছ থেকে প্রাপ্ত করা হয় এবং বিড প্রতিক্রিয়ায় অপরিবর্তিত Google-এর কাছে প্রেরণ করা আবশ্যক৷
সুপারিশ
আপনার সার্ভারগুলিতে স্থায়ী HTTPS সংযোগগুলি সক্ষম করুন (এটি "কিপ-লাইভ" বা "সংযোগ পুনঃব্যবহার" নামেও পরিচিত)। ন্যূনতম 10 সেকেন্ডে টাইমআউট সেট করুন—উচ্চ মান অনেক ক্ষেত্রে উপকারী। Google আপনার আবেদনের প্রাথমিক লেটেন্সি পরীক্ষার সময় এটি যাচাই করে, কারণ অনুমোদিত ক্রেতারা উচ্চ হারে অনুরোধ পাঠায় এবং প্রতিটি অনুরোধের জন্য একটি পৃথক TCP সংযোগ স্থাপনের লেটেন্সি ওভারহেড এড়াতে হবে।
দরদাতা যখন জিতবে তার চেয়ে ইম্প্রেশন রেন্ডার হওয়ার সময় ট্র্যাক করতে ঐচ্ছিক ইম্প্রেশন ট্র্যাকিং URL অন্তর্ভুক্ত করুন৷ জয় এবং রেন্ডারিংয়ের মধ্যে ড্রপঅফের কারণে, এটি আরও সঠিক ট্র্যাকিং পরিসংখ্যান দেয়।
আপনার দরপত্রের কোডকে অবহেলিত ক্ষেত্রের উপর নির্ভরতা থেকে মুক্ত রাখুন, যা আপনার বিডগুলি ত্রুটির সাথে ব্যর্থ হতে পারে।
আপনার BidResponse এ BidResponse.seatbid.bid.w এবং BidResponse.seatbid.bid.h অন্তর্ভুক্ত করুন। একাধিক বিজ্ঞাপনের আকার অন্তর্ভুক্ত এমন একটি অনুরোধের একটি BidResponse এই ক্ষেত্রগুলিকে অবশ্যই অন্তর্ভুক্ত করতে হবে বা এটি নিলাম থেকে বাদ দেওয়া হবে৷
আপনার প্রতিক্রিয়া আকার 8K এর নিচে সীমাবদ্ধ করুন। খুব বড় প্রতিক্রিয়া নেটওয়ার্ক লেটেন্সি বাড়াতে পারে এবং সময় শেষ হতে পারে।
গুরুত্বপূর্ণ: নমুনাগুলিতে চিত্রিত প্রোটোবাফ বার্তাগুলি এখানে মানব-পাঠযোগ্য পাঠ্য হিসাবে উপস্থাপন করা হয়েছে। যাইহোক, যেভাবে তারের মাধ্যমে বার্তা পাঠানো হয় তা নয়। OpenRTB Protobuf বিন্যাস ব্যবহার করার সময়, শুধুমাত্র সিরিয়ালকৃত BidResponse বার্তাগুলি গ্রহণ করা হবে।
আপনি নিম্নলিখিত C++ কোড ব্যবহার করে একটি BidResponse বার্তা তৈরি এবং সিরিয়াল করতে পারেন:
BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
// respond to the POST with post_response as the content
} else {
// return an error to the POST
}
সৃজনশীল উল্লেখ করুন
আপনার বিড জিতলে আপনার বিড প্রতিক্রিয়া পরিবেশন করার জন্য সৃজনশীল নির্দিষ্ট করে। আপনার বিডে অবশ্যই একটি সমর্থিত বিজ্ঞাপন ফর্ম্যাট (AMP, ভিডিও, নেটিভ) অন্তর্ভুক্ত করতে হবে। এই উদাহরণে, আমরা html_snippet ক্ষেত্র ব্যবহার করে ক্রিয়েটিভ নির্দিষ্ট করি।
বিকল্পভাবে, আপনি বিজ্ঞাপন বিন্যাসের উপর ভিত্তি করে নিম্নলিখিত ক্ষেত্রগুলির মধ্যে একটি ব্যবহার করে আপনার সৃজনশীল নির্দিষ্ট করতে পারেন:
SDK রেন্ডার করা বিজ্ঞাপন
BidResponse.seatbid.bid.ext.sdk_rendered_ad
এএমপি
BidResponse.seatbid.bid.amp_ad_url
ভিডিও
BidResponse.seatbid.bid.adm
নেটিভ
BidResponse.seatbid.bid.adm_native
BidResponse.seatbid.bid.adm ফিল্ডে একটি HTML স্নিপেট ব্যবহার করে আপনার নিজের সার্ভারে হোস্ট করা একটি বিজ্ঞাপন নির্দিষ্ট করুন। স্নিপেটটি ওয়েব পৃষ্ঠায় ঢোকানো একটি iFrame-এ আবদ্ধ থাকে, ফলে পৃষ্ঠাটি লোড হলে বিজ্ঞাপনটি পুনরুদ্ধার করা হয় এবং রেন্ডার করা হয়। আপনাকে অবশ্যই HTML স্নিপেট তৈরি করতে হবে যাতে বিজ্ঞাপনটি (ব্যানার বা ইন্টারস্টিশিয়াল) একটি iFrame-এর ভিতরে সঠিকভাবে রেন্ডার হয় এবং আপনি যে বিজ্ঞাপন স্লটে বিড করছেন তার জন্য উপযুক্ত আকারে।
উপরন্তু, বিডের প্রতিক্রিয়ায় ঘোষিত বিজ্ঞাপনের আকার অবশ্যই বিড অনুরোধের একটি আকারের সংমিশ্রণের সাথে মেলে যখন:
একটি বিজ্ঞাপন একটি নিয়মিত ব্যানার (ভিডিও, নেটিভ বা ইন্টারস্টিশিয়াল নয়)।
দরদাতা বিড প্রতিক্রিয়ায় আকার ঘোষণা করেছে। যখনই অনুরোধে একাধিক আকার উপস্থিত থাকে তখন আকার ঘোষণার প্রয়োজন হয়৷
ইন্টারস্টিশিয়াল বিজ্ঞাপনের জন্য একটি ব্যতিক্রম করা হয়েছে। ইন্টারস্টিশিয়ালগুলির জন্য প্রস্থটি পর্দার প্রস্থের কমপক্ষে 50% এবং উচ্চতাটি পর্দার উচ্চতার কমপক্ষে 40% হতে হবে৷
আপনি সঠিকভাবে রেন্ডার করে এমন কোনো বৈধ HTML কোড ব্যবহার করে একটি HTML স্নিপেট ক্রিয়েটিভ নির্দিষ্ট করতে পারেন, কিন্তু BidResponse বার্তা তৈরি করুন বিভাগে crid ক্ষেত্র নির্দিষ্ট করার বিধিনিষেধ মনে রাখবেন। এর জন্য একটি ব্যবহার হল বিজ্ঞাপন রেন্ডার করার অংশ হিসাবে আপনার সার্ভার থেকে আনা URLগুলির আর্গুমেন্টে অতিরিক্ত তথ্য রাখা। এটি আপনাকে আপনার নিজস্ব সার্ভারগুলিতে ইমপ্রেশন সম্পর্কে নির্বিচারে ডেটা পাস করতে দেয়।
ম্যাক্রোগুলি হল কিছু বিড রেসপন্স ফিল্ডে এমবেড করা ফরম্যাট করা টেক্সট যাতে ইউআরএল থাকে যা বিজ্ঞাপন পরিবেশনের সময় প্রাসঙ্গিক মান দিয়ে প্রতিস্থাপিত হয়। উদাহরণস্বরূপ, যদি আপনার বিজয়ী বিড আপনার বিডের সাথে অন্তর্ভুক্ত HTML স্নিপেট ক্রিয়েটিভের মধ্যে AUCTION_PRICE ম্যাক্রো অন্তর্ভুক্ত করে, তাহলে ম্যাক্রোটিকে এমন একটি মান দিয়ে প্রতিস্থাপিত করা হবে যা আপনি নিলামে ইম্প্রেশনের জন্য যে পরিমাণ অর্থ প্রদান করেছেন তা নির্ধারণ করতে আপনি ডিক্রিপ্ট করতে পারেন৷
আপনি নিম্নলিখিত ক্ষেত্রগুলিতে ম্যাক্রো অন্তর্ভুক্ত করতে পারেন:
BidResponse.seatbid.bid.adm
ম্যাক্রোগুলি HTML স্নিপেট, নেটিভ, ভিডিও URL এবং ভিডিও VAST XML ফর্ম্যাটের জন্য সমর্থিত৷
আপনার যদি একাধিক বিলিং URL এর প্রয়োজন হয় তবে BidResponse.seatbid.bid.burl এর পরিবর্তে এটি ব্যবহার করুন৷
উদাহরণ হিসেবে, আপনি ক্রিয়েটিভ আনতে ব্যবহৃত URL-এর মধ্যে ${MACRO} এম্বেড করে একটি HTML স্নিপেটের অংশ হিসেবে একটি ম্যাক্রো অন্তর্ভুক্ত করতে পারেন, যেখানে MACROOpenRTB স্পেসিফিকেশনে বর্ণিত সমর্থিত ম্যাক্রোগুলির মধ্যে একটি।
গুগল ম্যাক্রো
ওপেনআরটিবি স্পেসিকে পাওয়া ম্যাক্রো ছাড়াও গুগল অতিরিক্ত ম্যাক্রো সমর্থন করে। এগুলি ভিন্নভাবে ফর্ম্যাট করা হয়েছে এবং একটি URL এ এমবেড করা থাকলে %%MACRO%% হিসাবে প্রদর্শিত হবে৷ নিম্নলিখিত সারণী এই ম্যাক্রোগুলি বর্ণনা করে:
ম্যাক্রো
বর্ণনা
ADVERTISING_IDENTIFIER
ক্রেতাদের ইম্প্রেশন রেন্ডারিংয়ে iOS IDFA বা Android এর বিজ্ঞাপন আইডি পাওয়ার অনুমতি দেয়। বিস্তারিত জানার জন্য বিজ্ঞাপনদাতা শনাক্তকারীকে ডিক্রিপ্ট করা দেখুন।
CACHEBUSTER
একটি এলোমেলো, স্বাক্ষরবিহীন, চার-বাইট পূর্ণসংখ্যার একটি স্ট্রিং উপস্থাপনা৷
CLICK_URL_UNESC
বিজ্ঞাপনের জন্য আনস্কেপড ক্লিক URL। স্নিপেটে, তৃতীয় পক্ষের ক্লিক URL-এর একটি পালানো সংস্করণ সরাসরি ম্যাক্রো অনুসরণ করা উচিত।
উদাহরণস্বরূপ, যদি তৃতীয় পক্ষের ক্লিক URLটি http://my.adserver.com/some/path/handleclick?click=clk হয়, তাহলে নিম্নলিখিত কোডটি ম্যাক্রো আহ্বানের পরে তৃতীয় পক্ষের ক্লিক URL-এর একক-এস্কেপড সংস্করণের সাথে ব্যবহার করা যেতে পারে:
URLটি প্রথমে Google-এর সাথে ক্লিক নিবন্ধন করবে এবং তারপর তৃতীয় পক্ষের ক্লিক URL-এ পুনঃনির্দেশ করবে৷
CLICK_URL_ESC
বিজ্ঞাপনের জন্য পালানো ক্লিক URL. CLICK_URL_UNESC এর পরিবর্তে এটি ব্যবহার করুন যদি আপনি প্রথমে অন্য সার্ভারের মাধ্যমে মানটি পাস করতে চান যা তারপর একটি পুনঃনির্দেশ প্রদান করবে।
উদাহরণস্বরূপ, নিম্নলিখিত কোডটি একটি HTML স্নিপেটে ব্যবহার করা যেতে পারে:
এটি my.adserver.com সাথে ক্লিকটি নিবন্ধন করবে যা তারপর google_click_url প্যারামিটারে পাস করা URL-এ পুনঃনির্দেশ করার জন্য দায়ী। এটি অনুমান করে যে my.adserver.comgoogle_click_url প্যারামিটার থেকে রক্ষা করে।
আপনি %%CLICK_URL_ESC%% পরে একটি ডবল-এস্কেপড URL যুক্ত করতে পারেন। my.adserver.com দ্বারা unescaping সম্পন্ন করার পরে, এটি google_click_url এ সংযুক্ত URL-এর একটি একক-এস্কেপড সংস্করণ ছেড়ে যায়। যখন google_click_url আনা হয়, এটি আরও একবার আনস্কেপ হবে এবং তারপর পুনঃনির্দেশিত হবে।
CLICK_URL_ESC_ESC
বিজ্ঞাপনের জন্য ডবল-এসকেপড URL। CLICK_URL_UNESC এর পরিবর্তে এটি ব্যবহার করুন যদি আপনি প্রথমে অন্য সার্ভারের মাধ্যমে মানটি পাস করতে চান যা তারপর একটি পুনঃনির্দেশ প্রদান করবে।
উদাহরণস্বরূপ, নিম্নলিখিত কোডটি একটি HTML স্নিপেটে ব্যবহার করা যেতে পারে:
http: যদি বিড অনুরোধের জন্য SSL প্রয়োজন না হয় বা https: তে প্রসারিত হয় যদি বিড অনুরোধের জন্য SSL প্রয়োজন হয়।
SITE
কন্টেন্ট ইউআরএলের ইউআরএল-এস্কেপড ডোমেন বা বেনামী ইনভেন্টরির জন্য বেনামী আইডি।
SITE_URL
অবচয়। SITE ম্যাক্রো দ্বারা প্রতিস্থাপিত যা অভিন্ন কার্যকারিতা প্রদান করে৷
TZ_OFFSET
টাইম-জোন অফসেট।
VERIFICATION
উৎপাদনের জন্য বিভিন্ন মান এবং যখন ক্রিয়েটিভ যাচাইকরণ পাইপলাইনে স্ক্যান করা হয়। বিন্যাস হল: %%?VERIFICATION:true-val:false-val%% যেখানে ম্যাক্রো ছাড়া যেকোনো মান খালি স্ট্রিং সহ true-val এবং false-val এর জন্য ব্যবহার করা যেতে পারে। ওপেন বিডিংয়ের জন্য, আমরা সুপারিশ করি যে এক্সচেঞ্জগুলি এই ম্যাক্রো ব্যবহার করে; একবার তারা তা করে, ডিমান্ড-সাইড প্ল্যাটফর্মের পরিবর্তন করার দরকার নেই।
উদাহরণস্বরূপ, যদি একটি সৃজনশীল %%?VERIFICATION:-1:5000%% অন্তর্ভুক্ত করে তাহলে পাঠ্য প্রতিস্থাপন হবে 5000 পরিবেশন করার সময় এবং -1 যাচাইকরণ পাইপলাইনে। এটি এই দুটি সেটের পিংগুলির মধ্যে পার্থক্য করতে সহায়তা করার জন্য।
WINNING_PRICE
অ্যাকাউন্ট মুদ্রার মাইক্রোতে এনকোড করা ইম্প্রেশন খরচ (অর্থাৎ, CPM এর পরিবর্তে CPI)। উদাহরণস্বরূপ, $5 USD-এর একটি বিজয়ী CPM 5,000,000 মাইক্রো CPM, বা 5,000 মাইক্রো CPI-এর সাথে মিলে যায়৷ এই ক্ষেত্রে WINNING_PRICE এর ডিকোড করা মান হবে 5,000৷ বিজয়ী মূল্য CPI-তে নির্দিষ্ট করা আছে।
এই ম্যাক্রো পার্স করতে, আপনাকে একটি অ্যাপ্লিকেশন বাস্তবায়ন করতে হবে যা মূল্য নিশ্চিতকরণ ডিক্রিপ্ট করে। আরও তথ্যের জন্য ডিক্রিপ্টিং মূল্য নিশ্চিতকরণ পৃষ্ঠাটি পড়ুন।
WINNING_PRICE_ESC
URL-এস্কেপড WINNING_PRICE ।
Google-এর প্রয়োজন যে আপনি হয় CLICK_URL_UNESC বা CLICK_URL_ESC ম্যাক্রো ব্যবহার করুন তৃতীয় পক্ষের পরিবেশিত বিজ্ঞাপনের ক্রিয়েটিভের মধ্যে। Google ক্লিক ট্র্যাকিংয়ের জন্য CLICK_URL ম্যাক্রো ব্যবহার করে।
ম্যাক্রোতে ইউআরএল এস্কেপিং নিম্নলিখিত স্কিম ব্যবহার করে:
স্পেস অক্ষরটি একটি প্লাস চিহ্ন ( + ) দ্বারা প্রতিস্থাপিত হয়।
আলফানিউমেরিক অক্ষর (0-9, az, AZ) এবং সেট থেকে অক্ষর!()*,-./:_~ অপরিবর্তিত থাকবে।
অন্যান্য সমস্ত অক্ষর %XX দ্বারা প্রতিস্থাপিত হয়, যেখানে XX হল অক্ষরটির প্রতিনিধিত্বকারী হেক্সাডেসিমেল সংখ্যা।
প্রকাশকের সীমাবদ্ধতা এবং প্রয়োজনীয়তা
নিলামে সৃজনশীলের উপর প্রকাশকরা যে ধরনের বিধিনিষেধ এবং প্রয়োজনীয়তা রাখে সে সম্পর্কে তথ্য বিডের অনুরোধে অন্তর্ভুক্ত।
BidRequest.bcat
আপনি রিয়েল-টাইম বিডিং API-এর detectedCategories বিভাগ ক্ষেত্র ব্যবহার করে আপনার জমা দেওয়া ক্রিয়েটিভগুলির জন্য সনাক্ত করা এই ক্ষেত্র দ্বারা নির্দিষ্ট করা ব্লক করা বিভাগগুলির তুলনা করতে পারেন।
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
বাস্তবে এটি সর্বদা true হবে কারণ Google-এর সকল ক্রিয়েটিভের জন্য SSL সমর্থন প্রয়োজন।
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes
একটি সীমাবদ্ধ বৈশিষ্ট্য ধারণকারী একটি বিজ্ঞাপন দিয়ে বিড করবেন না. বিক্রেতার প্রকারের মতো অনুমোদিত বৈশিষ্ট্যগুলির জন্য, শুধুমাত্র BidRequest এ allowed_vendor_type তালিকায় বিক্রেতার ধরন থাকলেই বিজ্ঞাপন ফেরত দিন। BidRequest.imp.banner মতো ক্ষেত্রগুলি পপুলেট করে বিড অনুরোধে শুধুমাত্র বিজ্ঞাপনের ফর্ম্যাটগুলিই আপনার বিডে অন্তর্ভুক্ত করা উচিত। আরও বিশদ বিবরণের জন্য BidRequest প্রোটোকল বাফার সংজ্ঞাতে এই ক্ষেত্রগুলির জন্য মন্তব্যগুলি দেখুন৷
যদি BidResponse এ কোনো বিজ্ঞাপন ফেরত দেওয়া হয়, তাহলে আপনাকে BidResponse.seatbid.bid.attr , BidResponse.seatbid.bid.cat , এবং হয় BidResponse.seatbid.bid.adomain বা BidResponse.seatbid.bid.adm_native.link.url . BidResponse । যদি একটি বিজ্ঞাপনে এই ক্ষেত্রের জন্য একাধিক প্রযোজ্য মান থাকে, তাহলে আপনাকে অবশ্যই প্রতিটি মান অন্তর্ভুক্ত করতে হবে। আরও বিশদ বিবরণের জন্য BidResponse প্রোটোকল বাফার সংজ্ঞাতে এই ক্ষেত্রগুলির জন্য মন্তব্যগুলি দেখুন৷ এই ক্ষেত্রগুলি সেট করা নেই এমন প্রতিক্রিয়াগুলি বাতিল করা হয়৷
খোলা পরিমাপ
ওপেন মেজারমেন্ট আপনাকে তৃতীয় পক্ষের বিক্রেতাদের নির্দিষ্ট করতে দেয় যারা মোবাইল অ্যাপ পরিবেশে পরিবেশিত বিজ্ঞাপনগুলির জন্য স্বাধীন পরিমাপ এবং যাচাইকরণ পরিষেবা প্রদান করে।
সমর্থিত বিজ্ঞাপন ফর্ম্যাটগুলির মধ্যে ভিডিও, ব্যানার এবং ইন্টারস্টিশিয়াল বিজ্ঞাপন অন্তর্ভুক্ত রয়েছে। এই ফর্ম্যাটগুলি সম্বলিত বিড প্রতিক্রিয়াতে ওপেন মেজারমেন্ট কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও তথ্যের জন্য, ওপেন মেজারমেন্ট SDK সহায়তা কেন্দ্র নিবন্ধটি পড়ুন।
নমুনা বিড প্রতিক্রিয়া
নিম্নলিখিত বিভাগগুলি বিভিন্ন ধরনের বিজ্ঞাপনের জন্য নমুনা বিড প্রতিক্রিয়া দেখায়।
id:"96Z599PGNvp7Mr99138Fm0"seatbid{bid{id:"NQb32Ge7Rtt84wFn2p8"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB13-7"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"billing_id:29846056590dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}bid{id:"4vwb23qm6iqU6w6G978"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB21"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}seat:"4528:1161:591635"group:false}bidid:"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC"cur:"USD"
OpenRTB JSON
আমাকে উদাহরণ দেখান
{"id":"96Z599PGNvp7Mr99138Fm0","seatbid":[{"bid":[{"id":"NQb32Ge7Rtt84wFn2p8","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB13-7"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","billing_id":"29846056590","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"},{"id":"4vwb23qm6iqU6w6G978","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB21"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"}],"seat":"4528:1161:591635","group":0}],"bidid":"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC","cur":"USD"}
আপনার অ্যাপ্লিকেশন Google থেকে বিড অনুরোধ প্রক্রিয়া করার পরে, এটি তৈরি করে একটি প্রতিক্রিয়া পাঠাতে হবে। এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে প্রতিক্রিয়া তৈরি করতে আপনার অ্যাপ্লিকেশন কোড করবেন।
BidResponse বার্তা তৈরি করুন
একটি বিড জমা দেওয়ার জন্য, আপনার বিডিং অ্যাপ্লিকেশানটি অবশ্যই আপনার কনফিগার করা ফর্ম্যাটে একটি Bid সহ একটি BidResponse সহ একটি বিড অনুরোধে সাড়া দিতে হবে। আপনি যদি JSON ফর্ম্যাট ব্যবহার করেন, আপনার প্রতিক্রিয়া অবশ্যই Content-Type হেডারকে application/json; charset=utf-8 এবং বডিতে JSON BidResponse অন্তর্ভুক্ত করুন। আপনি যদি Protobuf ফরম্যাট ব্যবহার করেন, তাহলে আপনার অ্যাপ্লিকেশানটিকে অবশ্যই Content-Type হেডারকে application/octet-stream সেট করতে হবে এবং বডিতে সিরিয়ালাইজড BidResponse অন্তর্ভুক্ত করতে হবে।
Protobuf ফরম্যাটের জন্য একটি BidResponse তৈরি এবং সিরিয়াল করার জন্য, আপনাকে openrtb.proto এবং openrtb-adx.proto-এর উপর ভিত্তি করে প্রোটোবুফ লাইব্রেরি তৈরি এবং ব্যবহার করতে হবে, যা যথাক্রমে Protobuf-এ আদর্শ OpenRTB BidResponse ক্ষেত্র এবং Google এক্সটেনশনগুলি বাস্তবায়ন করে৷ এগুলি প্রোটোস এবং রেফারেন্স ডেটাতে পাওয়া যাবে।
আপনি যদি ইম্প্রেশনে বিড করতে না চান, তাহলে আপনাকে অবশ্যই একটি খালি HTTP 204 প্রতিক্রিয়া ফেরত দিতে হবে। আপনার আবেদনটি অবশ্যই প্রতিটি BidRequest একটি প্রতিক্রিয়া প্রদান করবে। টাইমআউট এবং প্রতিক্রিয়া যেগুলিকে পার্স করা যায় না সেগুলিকে ত্রুটি হিসাবে বিবেচনা করা হয় এবং Google উচ্চ ত্রুটির হার সহ বিডারদের থ্রোটল করে৷
ক্রিয়েটিভ আইডি
আপনার BidResponseBidResponse.seatbid.bid.crid ক্ষেত্রের (64 বাইট সীমা) মাধ্যমে একটি সৃজনশীল নির্দিষ্ট করে। এমনকি একই ধরনের ক্রিয়েটিভের অবশ্যই এই ক্ষেত্রের জন্য অনন্য মান থাকতে হবে যদি তারা কোনো উল্লেখযোগ্য বৈশিষ্ট্যের মধ্যে ভিন্ন হয়, যার মধ্যে রয়েছে কিন্তু সীমাবদ্ধ নয়: আকার, ঘোষিত URL, সৃজনশীল বৈশিষ্ট্য এবং বিক্রেতার প্রকারগুলি। অন্য কথায়, যেকোনো দুটি বিজ্ঞাপনে আপনাকে অবশ্যই আলাদা সৃজনশীল আইডি দিতে হবে যা:
ভিন্নভাবে দেখুন বা আচরণ করুন।
বিভিন্ন ইমেজ রেন্ডার.
বিভিন্ন উপায়ে রেন্ডার করুন (উদাহরণস্বরূপ, একটি বিজ্ঞাপনে একটি ছবি থাকে, অন্যটি একটি ভিডিও)।
আপনি যখন আপনার অ্যাপ্লিকেশনটি ডিজাইন করবেন, তখন আপনার শনাক্তকারী তৈরি করার একটি পদ্ধতিগত পদ্ধতির বিষয়ে সিদ্ধান্ত নেওয়া উচিত যা আপনি যে ধরণের সৃজনশীলগুলি জমা দেওয়ার পরিকল্পনা করছেন তার জন্য বোধগম্য হয়৷
বিজ্ঞাপন বৈশিষ্ট্য
BidResponse.seatbid.bid.apis এবং BidResponse.seatbid.bid.attr , অথবা BidResponse.seatbid.bid.ext.attribute এর সংমিশ্রণ ব্যবহার করে আপনার বিজ্ঞাপনের বৈশিষ্ট্য এবং এর টার্গেটিং বর্ণনা করার জন্য Google সৃজনশীল গুণাবলী ঘোষণা করার সুপারিশ করে। আপনি কীভাবে গুণাবলী ঘোষণা করতে পারেন তা নিম্নলিখিত বর্ণনা করে:
VPAID
BidResponse.seatbid.bid.apisVPAID_1 বা VPAID_2 এ সেট করুন। JSON বিন্যাসের জন্য, এটি যথাক্রমে 1 বা 2 সেট করা যেতে পারে।
MRAID
JSON ফর্ম্যাটের জন্য BidResponse.seatbid.bid.apisMRAID_1 বা 3 এ সেট করুন।
SIZELESS
JSON ফর্ম্যাটের জন্য BidResponse.seatbid.bid.attrRESPONSIVE বা 18 সেট করুন।
PLAYABLE
এটি BidResponse.seatbid.bid.attr কে USER_INTERACTIVE , বা JSON ফর্ম্যাটের জন্য 13 সেট করে নির্দেশিত হয়৷
আপনার ক্রিয়েটিভের শনাক্ত করা বৈশিষ্ট্য সম্পর্কে প্রতিক্রিয়া কীভাবে পেতে হয় তার ব্যাখ্যার জন্য ক্রিয়েটিভ রিসোর্স দেখুন।
ওপেন বিডিং ক্ষেত্র
ওপেন বিডিং-এ অংশগ্রহণকারী এক্সচেঞ্জ এবং নেটওয়ার্ক দরদাতাদের পাঠানো বিড প্রতিক্রিয়া স্ট্যান্ডার্ড রিয়েল-টাইম বিডিং-এ অংশগ্রহণকারী অনুমোদিত ক্রেতাদের মতই। ওপেন বিডিং গ্রাহকরা অল্প সংখ্যক অতিরিক্ত ক্ষেত্র নির্দিষ্ট করতে পারেন এবং কয়েকটি বিদ্যমান ক্ষেত্রের বিকল্প ব্যবহার থাকতে পারে। এর মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
মাঠ
বিস্তারিত
BidResponse.imp.pmp.deals.id
এক্সচেঞ্জের নামস্থান থেকে ডিল আইডি যা এই বিডের সাথে যুক্ত এবং প্রকাশকদের রিপোর্ট করা হয়েছে।
BidResponse.seatbid.bid.ext.exchange_deal_type
ডিলের ধরন প্রকাশকদের রিপোর্ট করা হয়, নিলামে ডিলটি কীভাবে আচরণ করা হয় তা প্রভাবিত করে।
টোকেন শেষ তৃতীয় পক্ষের ক্রেতার তথ্য সনাক্ত করতে ব্যবহৃত হয় যদি একটি ওপেন বিডার হিসাবে বিনিময় একটি মধ্যস্থতাকারী হয়। এটি তৃতীয় পক্ষের ক্রেতার কাছ থেকে প্রাপ্ত করা হয় এবং বিড প্রতিক্রিয়ায় অপরিবর্তিত Google-এর কাছে প্রেরণ করা আবশ্যক৷
সুপারিশ
আপনার সার্ভারগুলিতে স্থায়ী HTTPS সংযোগগুলি সক্ষম করুন (এটি "কিপ-লাইভ" বা "সংযোগ পুনঃব্যবহার" নামেও পরিচিত)। ন্যূনতম 10 সেকেন্ডে টাইমআউট সেট করুন—উচ্চ মান অনেক ক্ষেত্রে উপকারী। Google আপনার আবেদনের প্রাথমিক লেটেন্সি পরীক্ষার সময় এটি যাচাই করে, কারণ অনুমোদিত ক্রেতারা উচ্চ হারে অনুরোধ পাঠায় এবং প্রতিটি অনুরোধের জন্য একটি পৃথক TCP সংযোগ স্থাপনের লেটেন্সি ওভারহেড এড়াতে হবে।
দরদাতা যখন জিতবে তার চেয়ে ইম্প্রেশন রেন্ডার হওয়ার সময় ট্র্যাক করতে ঐচ্ছিক ইম্প্রেশন ট্র্যাকিং URL অন্তর্ভুক্ত করুন৷ জয় এবং রেন্ডারিংয়ের মধ্যে ড্রপঅফের কারণে, এটি আরও সঠিক ট্র্যাকিং পরিসংখ্যান দেয়।
আপনার দরপত্রের কোডকে অবহেলিত ক্ষেত্রের উপর নির্ভরতা থেকে মুক্ত রাখুন, যা আপনার বিডগুলি ত্রুটির সাথে ব্যর্থ হতে পারে।
আপনার BidResponse এ BidResponse.seatbid.bid.w এবং BidResponse.seatbid.bid.h অন্তর্ভুক্ত করুন। একাধিক বিজ্ঞাপনের আকার অন্তর্ভুক্ত এমন একটি অনুরোধের একটি BidResponse এই ক্ষেত্রগুলিকে অবশ্যই অন্তর্ভুক্ত করতে হবে বা এটি নিলাম থেকে বাদ দেওয়া হবে৷
আপনার প্রতিক্রিয়া আকার 8K এর নিচে সীমাবদ্ধ করুন। খুব বড় প্রতিক্রিয়া নেটওয়ার্ক লেটেন্সি বাড়াতে পারে এবং সময় শেষ হতে পারে।
গুরুত্বপূর্ণ: নমুনাগুলিতে চিত্রিত প্রোটোবাফ বার্তাগুলি এখানে মানব-পাঠযোগ্য পাঠ্য হিসাবে উপস্থাপন করা হয়েছে। যাইহোক, যেভাবে তারের মাধ্যমে বার্তা পাঠানো হয় তা নয়। OpenRTB Protobuf বিন্যাস ব্যবহার করার সময়, শুধুমাত্র সিরিয়ালকৃত BidResponse বার্তাগুলি গ্রহণ করা হবে।
আপনি নিম্নলিখিত C++ কোড ব্যবহার করে একটি BidResponse বার্তা তৈরি এবং সিরিয়াল করতে পারেন:
BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
// respond to the POST with post_response as the content
} else {
// return an error to the POST
}
সৃজনশীল উল্লেখ করুন
আপনার বিড জিতলে আপনার বিড প্রতিক্রিয়া পরিবেশন করার জন্য সৃজনশীল নির্দিষ্ট করে। আপনার বিডে অবশ্যই একটি সমর্থিত বিজ্ঞাপন ফর্ম্যাট (AMP, ভিডিও, নেটিভ) অন্তর্ভুক্ত করতে হবে। এই উদাহরণে, আমরা html_snippet ক্ষেত্র ব্যবহার করে ক্রিয়েটিভ নির্দিষ্ট করি।
বিকল্পভাবে, আপনি বিজ্ঞাপন বিন্যাসের উপর ভিত্তি করে নিম্নলিখিত ক্ষেত্রগুলির মধ্যে একটি ব্যবহার করে আপনার সৃজনশীল নির্দিষ্ট করতে পারেন:
SDK রেন্ডার করা বিজ্ঞাপন
BidResponse.seatbid.bid.ext.sdk_rendered_ad
এএমপি
BidResponse.seatbid.bid.amp_ad_url
ভিডিও
BidResponse.seatbid.bid.adm
নেটিভ
BidResponse.seatbid.bid.adm_native
BidResponse.seatbid.bid.adm ফিল্ডে একটি HTML স্নিপেট ব্যবহার করে আপনার নিজের সার্ভারে হোস্ট করা একটি বিজ্ঞাপন নির্দিষ্ট করুন। স্নিপেটটি ওয়েব পৃষ্ঠায় ঢোকানো একটি iFrame-এ আবদ্ধ থাকে, ফলে পৃষ্ঠাটি লোড হলে বিজ্ঞাপনটি পুনরুদ্ধার করা হয় এবং রেন্ডার করা হয়। আপনাকে অবশ্যই HTML স্নিপেট তৈরি করতে হবে যাতে বিজ্ঞাপনটি (ব্যানার বা ইন্টারস্টিশিয়াল) একটি iFrame-এর ভিতরে সঠিকভাবে রেন্ডার হয় এবং আপনি যে বিজ্ঞাপন স্লটে বিড করছেন তার জন্য উপযুক্ত আকারে।
উপরন্তু, বিডের প্রতিক্রিয়ায় ঘোষিত বিজ্ঞাপনের আকার অবশ্যই বিড অনুরোধের একটি আকারের সংমিশ্রণের সাথে মেলে যখন:
একটি বিজ্ঞাপন একটি নিয়মিত ব্যানার (ভিডিও, নেটিভ বা ইন্টারস্টিশিয়াল নয়)।
দরদাতা বিড প্রতিক্রিয়ায় আকার ঘোষণা করেছে। যখনই অনুরোধে একাধিক আকার উপস্থিত থাকে তখন আকার ঘোষণার প্রয়োজন হয়৷
ইন্টারস্টিশিয়াল বিজ্ঞাপনের জন্য একটি ব্যতিক্রম করা হয়েছে। ইন্টারস্টিশিয়ালগুলির জন্য প্রস্থটি পর্দার প্রস্থের কমপক্ষে 50% এবং উচ্চতাটি পর্দার উচ্চতার কমপক্ষে 40% হতে হবে৷
আপনি সঠিকভাবে রেন্ডার করে এমন কোনো বৈধ HTML কোড ব্যবহার করে একটি HTML স্নিপেট ক্রিয়েটিভ নির্দিষ্ট করতে পারেন, কিন্তু BidResponse বার্তা তৈরি করুন বিভাগে crid ক্ষেত্র নির্দিষ্ট করার বিধিনিষেধ মনে রাখবেন। এর জন্য একটি ব্যবহার হল বিজ্ঞাপন রেন্ডার করার অংশ হিসাবে আপনার সার্ভার থেকে আনা URLগুলির আর্গুমেন্টে অতিরিক্ত তথ্য রাখা। এটি আপনাকে আপনার নিজস্ব সার্ভারগুলিতে ইমপ্রেশন সম্পর্কে নির্বিচারে ডেটা পাস করতে দেয়।
ম্যাক্রোগুলি হল কিছু বিড রেসপন্স ফিল্ডে এমবেড করা ফরম্যাট করা টেক্সট যাতে ইউআরএল থাকে যা বিজ্ঞাপন পরিবেশনের সময় প্রাসঙ্গিক মান দিয়ে প্রতিস্থাপিত হয়। উদাহরণস্বরূপ, যদি আপনার বিজয়ী বিড আপনার বিডের সাথে অন্তর্ভুক্ত HTML স্নিপেট ক্রিয়েটিভের মধ্যে AUCTION_PRICE ম্যাক্রো অন্তর্ভুক্ত করে, তাহলে ম্যাক্রোটিকে এমন একটি মান দিয়ে প্রতিস্থাপিত করা হবে যা আপনি নিলামে ইম্প্রেশনের জন্য যে পরিমাণ অর্থ প্রদান করেছেন তা নির্ধারণ করতে আপনি ডিক্রিপ্ট করতে পারেন৷
আপনি নিম্নলিখিত ক্ষেত্রগুলিতে ম্যাক্রো অন্তর্ভুক্ত করতে পারেন:
BidResponse.seatbid.bid.adm
ম্যাক্রোগুলি HTML স্নিপেট, নেটিভ, ভিডিও URL এবং ভিডিও VAST XML ফর্ম্যাটের জন্য সমর্থিত৷
আপনার যদি একাধিক বিলিং URL এর প্রয়োজন হয় তবে BidResponse.seatbid.bid.burl এর পরিবর্তে এটি ব্যবহার করুন৷
উদাহরণ হিসেবে, আপনি ক্রিয়েটিভ আনতে ব্যবহৃত URL-এর মধ্যে ${MACRO} এম্বেড করে একটি HTML স্নিপেটের অংশ হিসেবে একটি ম্যাক্রো অন্তর্ভুক্ত করতে পারেন, যেখানে MACROOpenRTB স্পেসিফিকেশনে বর্ণিত সমর্থিত ম্যাক্রোগুলির মধ্যে একটি।
গুগল ম্যাক্রো
ওপেনআরটিবি স্পেসিকে পাওয়া ম্যাক্রো ছাড়াও গুগল অতিরিক্ত ম্যাক্রো সমর্থন করে। এগুলি ভিন্নভাবে ফর্ম্যাট করা হয়েছে এবং একটি URL এ এমবেড করা থাকলে %%MACRO%% হিসাবে প্রদর্শিত হবে৷ নিম্নলিখিত সারণী এই ম্যাক্রোগুলি বর্ণনা করে:
ম্যাক্রো
বর্ণনা
ADVERTISING_IDENTIFIER
ক্রেতাদের ইম্প্রেশন রেন্ডারিংয়ে iOS IDFA বা Android এর বিজ্ঞাপন আইডি পাওয়ার অনুমতি দেয়। বিস্তারিত জানার জন্য বিজ্ঞাপনদাতা শনাক্তকারীকে ডিক্রিপ্ট করা দেখুন।
CACHEBUSTER
একটি এলোমেলো, স্বাক্ষরবিহীন, চার-বাইট পূর্ণসংখ্যার একটি স্ট্রিং উপস্থাপনা৷
CLICK_URL_UNESC
বিজ্ঞাপনের জন্য আনস্কেপড ক্লিক URL। স্নিপেটে, তৃতীয় পক্ষের ক্লিক URL-এর একটি পালানো সংস্করণ সরাসরি ম্যাক্রো অনুসরণ করা উচিত।
উদাহরণস্বরূপ, যদি তৃতীয় পক্ষের ক্লিক URLটি http://my.adserver.com/some/path/handleclick?click=clk হয়, তাহলে নিম্নলিখিত কোডটি ম্যাক্রো আহ্বানের পরে তৃতীয় পক্ষের ক্লিক URL-এর একক-এস্কেপড সংস্করণের সাথে ব্যবহার করা যেতে পারে:
URLটি প্রথমে Google-এর সাথে ক্লিক নিবন্ধন করবে এবং তারপর তৃতীয় পক্ষের ক্লিক URL-এ পুনঃনির্দেশ করবে৷
CLICK_URL_ESC
বিজ্ঞাপনের জন্য পালানো ক্লিক URL. CLICK_URL_UNESC এর পরিবর্তে এটি ব্যবহার করুন যদি আপনি প্রথমে অন্য সার্ভারের মাধ্যমে মানটি পাস করতে চান যা তারপর একটি পুনঃনির্দেশ প্রদান করবে।
উদাহরণস্বরূপ, নিম্নলিখিত কোডটি একটি HTML স্নিপেটে ব্যবহার করা যেতে পারে:
এটি my.adserver.com সাথে ক্লিকটি নিবন্ধন করবে যা তারপর google_click_url প্যারামিটারে পাস করা URL-এ পুনঃনির্দেশ করার জন্য দায়ী। এটি অনুমান করে যে my.adserver.comgoogle_click_url প্যারামিটার থেকে রক্ষা করে।
আপনি %%CLICK_URL_ESC%% পরে একটি ডবল-এস্কেপড URL যুক্ত করতে পারেন। my.adserver.com দ্বারা unescaping সম্পন্ন করার পরে, এটি google_click_url এ সংযুক্ত URL-এর একটি একক-এস্কেপড সংস্করণ ছেড়ে যায়। যখন google_click_url আনা হয়, এটি আরও একবার আনস্কেপ হবে এবং তারপর পুনঃনির্দেশিত হবে।
CLICK_URL_ESC_ESC
বিজ্ঞাপনের জন্য ডবল-এসকেপড URL। CLICK_URL_UNESC এর পরিবর্তে এটি ব্যবহার করুন যদি আপনি প্রথমে অন্য সার্ভারের মাধ্যমে মানটি পাস করতে চান যা তারপর একটি পুনঃনির্দেশ প্রদান করবে।
উদাহরণস্বরূপ, নিম্নলিখিত কোডটি একটি HTML স্নিপেটে ব্যবহার করা যেতে পারে:
http: যদি বিড অনুরোধের জন্য SSL প্রয়োজন না হয় বা https: তে প্রসারিত হয় যদি বিড অনুরোধের জন্য SSL প্রয়োজন হয়।
SITE
কন্টেন্ট ইউআরএলের ইউআরএল-এস্কেপড ডোমেন বা বেনামী ইনভেন্টরির জন্য বেনামী আইডি।
SITE_URL
অবচয়। SITE ম্যাক্রো দ্বারা প্রতিস্থাপিত যা অভিন্ন কার্যকারিতা প্রদান করে৷
TZ_OFFSET
টাইম-জোন অফসেট।
VERIFICATION
উৎপাদনের জন্য বিভিন্ন মান এবং যখন ক্রিয়েটিভ যাচাইকরণ পাইপলাইনে স্ক্যান করা হয়। বিন্যাস হল: %%?VERIFICATION:true-val:false-val%% যেখানে ম্যাক্রো ছাড়া যেকোনো মান খালি স্ট্রিং সহ true-val এবং false-val এর জন্য ব্যবহার করা যেতে পারে। ওপেন বিডিংয়ের জন্য, আমরা সুপারিশ করি যে এক্সচেঞ্জগুলি এই ম্যাক্রো ব্যবহার করে; একবার তারা তা করে, ডিমান্ড-সাইড প্ল্যাটফর্মের পরিবর্তন করার দরকার নেই।
উদাহরণস্বরূপ, যদি একটি সৃজনশীল %%?VERIFICATION:-1:5000%% অন্তর্ভুক্ত করে তাহলে পাঠ্য প্রতিস্থাপন হবে 5000 পরিবেশন করার সময় এবং -1 যাচাইকরণ পাইপলাইনে। এটি এই দুটি সেটের পিংগুলির মধ্যে পার্থক্য করতে সহায়তা করার জন্য।
WINNING_PRICE
অ্যাকাউন্ট মুদ্রার মাইক্রোতে এনকোড করা ইম্প্রেশন খরচ (অর্থাৎ, CPM এর পরিবর্তে CPI)। উদাহরণস্বরূপ, $5 USD-এর একটি বিজয়ী CPM 5,000,000 মাইক্রো CPM, বা 5,000 মাইক্রো CPI-এর সাথে মিলে যায়৷ এই ক্ষেত্রে WINNING_PRICE এর ডিকোড করা মান হবে 5,000৷ বিজয়ী মূল্য CPI-তে নির্দিষ্ট করা আছে।
এই ম্যাক্রো পার্স করতে, আপনাকে একটি অ্যাপ্লিকেশন বাস্তবায়ন করতে হবে যা মূল্য নিশ্চিতকরণ ডিক্রিপ্ট করে। আরও তথ্যের জন্য ডিক্রিপ্টিং মূল্য নিশ্চিতকরণ পৃষ্ঠাটি পড়ুন।
WINNING_PRICE_ESC
URL-এস্কেপড WINNING_PRICE ।
Google-এর প্রয়োজন যে আপনি হয় CLICK_URL_UNESC বা CLICK_URL_ESC ম্যাক্রো ব্যবহার করুন তৃতীয় পক্ষের পরিবেশিত বিজ্ঞাপনের ক্রিয়েটিভের মধ্যে। Google ক্লিক ট্র্যাকিংয়ের জন্য CLICK_URL ম্যাক্রো ব্যবহার করে।
ম্যাক্রোতে ইউআরএল এস্কেপিং নিম্নলিখিত স্কিম ব্যবহার করে:
স্পেস অক্ষরটি একটি প্লাস চিহ্ন ( + ) দ্বারা প্রতিস্থাপিত হয়।
আলফানিউমেরিক অক্ষর (0-9, az, AZ) এবং সেট থেকে অক্ষর!()*,-./:_~ অপরিবর্তিত থাকবে।
অন্যান্য সমস্ত অক্ষর %XX দ্বারা প্রতিস্থাপিত হয়, যেখানে XX হল অক্ষরটির প্রতিনিধিত্বকারী হেক্সাডেসিমেল সংখ্যা।
প্রকাশকের সীমাবদ্ধতা এবং প্রয়োজনীয়তা
নিলামে সৃজনশীলের উপর প্রকাশকরা যে ধরনের বিধিনিষেধ এবং প্রয়োজনীয়তা রাখে সে সম্পর্কে তথ্য বিডের অনুরোধে অন্তর্ভুক্ত।
BidRequest.bcat
আপনি রিয়েল-টাইম বিডিং API-এর detectedCategories বিভাগ ক্ষেত্র ব্যবহার করে আপনার জমা দেওয়া ক্রিয়েটিভগুলির জন্য সনাক্ত করা এই ক্ষেত্র দ্বারা নির্দিষ্ট করা ব্লক করা বিভাগগুলির তুলনা করতে পারেন।
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
বাস্তবে এটি সর্বদা true হবে কারণ Google-এর সকল ক্রিয়েটিভের জন্য SSL সমর্থন প্রয়োজন।
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes
একটি সীমাবদ্ধ বৈশিষ্ট্য ধারণকারী একটি বিজ্ঞাপন দিয়ে বিড করবেন না. বিক্রেতার প্রকারের মতো অনুমোদিত বৈশিষ্ট্যগুলির জন্য, শুধুমাত্র BidRequest এ allowed_vendor_type তালিকায় বিক্রেতার ধরন থাকলেই বিজ্ঞাপন ফেরত দিন। BidRequest.imp.banner মতো ক্ষেত্রগুলি পপুলেট করে বিড অনুরোধে শুধুমাত্র বিজ্ঞাপনের ফর্ম্যাটগুলিই আপনার বিডে অন্তর্ভুক্ত করা উচিত। আরও বিশদ বিবরণের জন্য BidRequest প্রোটোকল বাফার সংজ্ঞাতে এই ক্ষেত্রগুলির জন্য মন্তব্যগুলি দেখুন৷
যদি BidResponse এ কোনো বিজ্ঞাপন ফেরত দেওয়া হয়, তাহলে আপনাকে BidResponse.seatbid.bid.attr , BidResponse.seatbid.bid.cat , এবং হয় BidResponse.seatbid.bid.adomain বা BidResponse.seatbid.bid.adm_native.link.url . BidResponse । যদি একটি বিজ্ঞাপনে এই ক্ষেত্রের জন্য একাধিক প্রযোজ্য মান থাকে, তাহলে আপনাকে অবশ্যই প্রতিটি মান অন্তর্ভুক্ত করতে হবে। আরও বিশদ বিবরণের জন্য BidResponse প্রোটোকল বাফার সংজ্ঞাতে এই ক্ষেত্রগুলির জন্য মন্তব্যগুলি দেখুন৷ এই ক্ষেত্রগুলি সেট করা নেই এমন প্রতিক্রিয়াগুলি বাতিল করা হয়৷
খোলা পরিমাপ
ওপেন মেজারমেন্ট আপনাকে তৃতীয় পক্ষের বিক্রেতাদের নির্দিষ্ট করতে দেয় যারা মোবাইল অ্যাপ পরিবেশে পরিবেশিত বিজ্ঞাপনগুলির জন্য স্বাধীন পরিমাপ এবং যাচাইকরণ পরিষেবা প্রদান করে।
সমর্থিত বিজ্ঞাপন ফর্ম্যাটগুলির মধ্যে ভিডিও, ব্যানার এবং ইন্টারস্টিশিয়াল বিজ্ঞাপন অন্তর্ভুক্ত রয়েছে। এই ফর্ম্যাটগুলি সম্বলিত বিড প্রতিক্রিয়াতে ওপেন মেজারমেন্ট কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও তথ্যের জন্য, ওপেন মেজারমেন্ট SDK সহায়তা কেন্দ্র নিবন্ধটি পড়ুন।
নমুনা বিড প্রতিক্রিয়া
নিম্নলিখিত বিভাগগুলি বিভিন্ন ধরনের বিজ্ঞাপনের জন্য নমুনা বিড প্রতিক্রিয়া দেখায়।
id:"96Z599PGNvp7Mr99138Fm0"seatbid{bid{id:"NQb32Ge7Rtt84wFn2p8"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB13-7"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"billing_id:29846056590dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}bid{id:"4vwb23qm6iqU6w6G978"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB21"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}seat:"4528:1161:591635"group:false}bidid:"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC"cur:"USD"
OpenRTB JSON
আমাকে উদাহরণ দেখান
{"id":"96Z599PGNvp7Mr99138Fm0","seatbid":[{"bid":[{"id":"NQb32Ge7Rtt84wFn2p8","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB13-7"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","billing_id":"29846056590","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"},{"id":"4vwb23qm6iqU6w6G978","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB21"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"}],"seat":"4528:1161:591635","group":0}],"bidid":"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC","cur":"USD"}
আপনার অ্যাপ্লিকেশন Google থেকে বিড অনুরোধ প্রক্রিয়া করার পরে, এটি তৈরি করে একটি প্রতিক্রিয়া পাঠাতে হবে। এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে প্রতিক্রিয়া তৈরি করতে আপনার অ্যাপ্লিকেশন কোড করবেন।
BidResponse বার্তা তৈরি করুন
একটি বিড জমা দেওয়ার জন্য, আপনার বিডিং অ্যাপ্লিকেশানটি অবশ্যই আপনার কনফিগার করা ফর্ম্যাটে একটি Bid সহ একটি BidResponse সহ একটি বিড অনুরোধে সাড়া দিতে হবে। আপনি যদি JSON ফর্ম্যাট ব্যবহার করেন, আপনার প্রতিক্রিয়া অবশ্যই Content-Type হেডারকে application/json; charset=utf-8 এবং বডিতে JSON BidResponse অন্তর্ভুক্ত করুন। আপনি যদি Protobuf ফরম্যাট ব্যবহার করেন, তাহলে আপনার অ্যাপ্লিকেশানটিকে অবশ্যই Content-Type হেডারকে application/octet-stream সেট করতে হবে এবং বডিতে সিরিয়ালাইজড BidResponse অন্তর্ভুক্ত করতে হবে।
Protobuf ফরম্যাটের জন্য একটি BidResponse তৈরি এবং সিরিয়াল করার জন্য, আপনাকে openrtb.proto এবং openrtb-adx.proto-এর উপর ভিত্তি করে প্রোটোবুফ লাইব্রেরি তৈরি এবং ব্যবহার করতে হবে, যা যথাক্রমে Protobuf-এ আদর্শ OpenRTB BidResponse ক্ষেত্র এবং Google এক্সটেনশনগুলি বাস্তবায়ন করে৷ এগুলি প্রোটোস এবং রেফারেন্স ডেটাতে পাওয়া যাবে।
আপনি যদি ইম্প্রেশনে বিড করতে না চান, তাহলে আপনাকে অবশ্যই একটি খালি HTTP 204 প্রতিক্রিয়া ফেরত দিতে হবে। আপনার আবেদনটি অবশ্যই প্রতিটি BidRequest একটি প্রতিক্রিয়া প্রদান করবে। টাইমআউট এবং প্রতিক্রিয়া যেগুলিকে পার্স করা যায় না সেগুলিকে ত্রুটি হিসাবে বিবেচনা করা হয় এবং Google উচ্চ ত্রুটির হার সহ বিডারদের থ্রোটল করে৷
ক্রিয়েটিভ আইডি
আপনার BidResponseBidResponse.seatbid.bid.crid ক্ষেত্রের (64 বাইট সীমা) মাধ্যমে একটি সৃজনশীল নির্দিষ্ট করে। এমনকি একই ধরনের ক্রিয়েটিভের অবশ্যই এই ক্ষেত্রের জন্য অনন্য মান থাকতে হবে যদি তারা কোনো উল্লেখযোগ্য বৈশিষ্ট্যের মধ্যে ভিন্ন হয়, যার মধ্যে রয়েছে কিন্তু সীমাবদ্ধ নয়: আকার, ঘোষিত URL, সৃজনশীল বৈশিষ্ট্য এবং বিক্রেতার প্রকারগুলি। অন্য কথায়, যেকোনো দুটি বিজ্ঞাপনে আপনাকে অবশ্যই আলাদা ক্রিয়েটিভ আইডি দিতে হবে যা:
ভিন্নভাবে দেখুন বা আচরণ করুন।
বিভিন্ন ইমেজ রেন্ডার.
বিভিন্ন উপায়ে রেন্ডার করুন (উদাহরণস্বরূপ, একটি বিজ্ঞাপনে একটি ছবি থাকে, অন্যটি একটি ভিডিও)।
আপনি যখন আপনার অ্যাপ্লিকেশনটি ডিজাইন করবেন, তখন আপনার শনাক্তকারী তৈরি করার একটি পদ্ধতিগত পদ্ধতির বিষয়ে সিদ্ধান্ত নেওয়া উচিত যা আপনি যে ধরণের সৃজনশীলগুলি জমা দেওয়ার পরিকল্পনা করছেন তার জন্য বোধগম্য হয়৷
বিজ্ঞাপন বৈশিষ্ট্য
BidResponse.seatbid.bid.apis এবং BidResponse.seatbid.bid.attr , অথবা BidResponse.seatbid.bid.ext.attribute এর সংমিশ্রণ ব্যবহার করে আপনার বিজ্ঞাপনের বৈশিষ্ট্য এবং এর টার্গেটিং বর্ণনা করার জন্য Google সৃজনশীল গুণাবলী ঘোষণা করার সুপারিশ করে। আপনি কীভাবে গুণাবলী ঘোষণা করতে পারেন তা নিম্নলিখিত বর্ণনা করে:
VPAID
BidResponse.seatbid.bid.apisVPAID_1 বা VPAID_2 এ সেট করুন। JSON বিন্যাসের জন্য, এটি যথাক্রমে 1 বা 2 সেট করা যেতে পারে।
MRAID
JSON ফর্ম্যাটের জন্য BidResponse.seatbid.bid.apisMRAID_1 বা 3 এ সেট করুন।
SIZELESS
JSON ফর্ম্যাটের জন্য BidResponse.seatbid.bid.attrRESPONSIVE বা 18 সেট করুন।
PLAYABLE
এটি BidResponse.seatbid.bid.attr কে USER_INTERACTIVE , বা JSON ফর্ম্যাটের জন্য 13 সেট করে নির্দেশিত হয়৷
আপনার ক্রিয়েটিভের শনাক্ত করা বৈশিষ্ট্য সম্পর্কে প্রতিক্রিয়া কীভাবে পেতে হয় তার ব্যাখ্যার জন্য ক্রিয়েটিভ রিসোর্স দেখুন।
ওপেন বিডিং ক্ষেত্র
ওপেন বিডিং-এ অংশগ্রহণকারী এক্সচেঞ্জ এবং নেটওয়ার্ক দরদাতাদের পাঠানো বিড প্রতিক্রিয়া স্ট্যান্ডার্ড রিয়েল-টাইম বিডিং-এ অংশগ্রহণকারী অনুমোদিত ক্রেতাদের মতই। ওপেন বিডিং গ্রাহকরা অল্প সংখ্যক অতিরিক্ত ক্ষেত্র নির্দিষ্ট করতে পারেন এবং কয়েকটি বিদ্যমান ক্ষেত্রের বিকল্প ব্যবহার থাকতে পারে। এর মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
মাঠ
বিস্তারিত
BidResponse.imp.pmp.deals.id
এক্সচেঞ্জের নেমস্পেস থেকে ডিল আইডি যা এই বিডের সাথে সম্পর্কিত এবং প্রকাশকদের কাছে রিপোর্ট করেছে।
BidResponse.seatbid.bid.ext.exchange_deal_type
প্রকাশকদের কাছে যে ধরণের চুক্তির রিপোর্ট করা হয়েছে, নিলামে কীভাবে এই চুক্তিটি চিকিত্সা করা হয় তা প্রভাবিত করে।
টোকেন তৃতীয় পক্ষের ক্রেতার তথ্য সনাক্ত করতে ব্যবহৃত হত যদি খোলা দরদাতা হিসাবে এক্সচেঞ্জটি মধ্যস্থতাকারী হয়। এটি তৃতীয় পক্ষের ক্রেতার কাছ থেকে প্রাপ্ত এবং বিড প্রতিক্রিয়াতে অবশ্যই গুগল আনল্টার্টেডে পাস করতে হবে।
সুপারিশ
আপনার সার্ভারগুলিতে অবিচ্ছিন্ন HTTPS সংযোগগুলি ("কী-জীবিত" বা "সংযোগ পুনঃব্যবহার" নামেও পরিচিত) সক্ষম করুন। ন্যূনতম 10 সেকেন্ডে সময়সীমা সেট করুন - উচ্চতর মানগুলি অনেক ক্ষেত্রে উপকারী। গুগল আপনার অ্যাপ্লিকেশনটির প্রাথমিক বিলম্বিত পরীক্ষার সময় এটি যাচাই করে, কারণ অনুমোদিত ক্রেতারা উচ্চ হারে অনুরোধগুলি প্রেরণ করে এবং প্রতিটি অনুরোধের জন্য পৃথক টিসিপি সংযোগ স্থাপনের বিলম্বিত ওভারহেড এড়াতে প্রয়োজন।
বিডার জিতলে ইমপ্রেশনটি যখন রেন্ডার করে তখন ট্র্যাক করতে uncle চ্ছিক ইমপ্রেশন ট্র্যাকিং ইউআরএল অন্তর্ভুক্ত করুন। জয় এবং রেন্ডারিংয়ের মধ্যে ড্রপ অফের কারণে, এটি আরও সঠিক ট্র্যাকিংয়ের পরিসংখ্যান দেয়।
আপনার বিডার কোডটি অবমূল্যায়িত ক্ষেত্রগুলিতে নির্ভরতা থেকে মুক্ত রাখুন, যা আপনার বিডগুলিকে ত্রুটিগুলির সাথে ব্যর্থ হতে পারে।
BidResponse.seatbid.bid.w এবং BidResponse.seatbid.bid.h আপনার BidResponse অন্তর্ভুক্ত করুন। একাধিক বিজ্ঞাপনের আকার অন্তর্ভুক্ত একটি অনুরোধের একটি BidResponse অবশ্যই এই ক্ষেত্রগুলি অন্তর্ভুক্ত করতে হবে বা এটি নিলাম থেকে বাদ দেওয়া হবে।
আপনার প্রতিক্রিয়া আকার 8 কে এর নিচে সীমাবদ্ধ করুন। খুব বড় প্রতিক্রিয়াগুলি নেটওয়ার্কের বিলম্বকে বাড়িয়ে তুলতে পারে এবং সময়সীমা তৈরি করতে পারে।
গুরুত্বপূর্ণ: নমুনাগুলিতে চিত্রিত প্রোটোবিএফ বার্তাগুলি এখানে মানব-পঠনযোগ্য পাঠ্য হিসাবে প্রতিনিধিত্ব করা হয়। যাইহোক, এটি তার উপর দিয়ে বার্তাগুলি কীভাবে প্রেরণ করা হয় না। ওপেনআরটিবি প্রোটোবিএফ ফর্ম্যাটটি ব্যবহার করার সময়, কেবল সিরিয়ালযুক্ত বিডারস্পোন বার্তা গ্রহণ করা হবে।
আপনি নিম্নলিখিত সি ++ কোডটি ব্যবহার করে একটি BidResponse বার্তা তৈরি এবং সিরিয়ালাইজ করতে পারেন:
BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
// respond to the POST with post_response as the content
} else {
// return an error to the POST
}
সৃজনশীল নির্দিষ্ট করুন
আপনার বিড প্রতিক্রিয়া আপনার বিড জিতলে সৃজনশীলকে পরিবেশন করতে নির্দিষ্ট করে। আপনার বিডে অবশ্যই সমর্থিত বিজ্ঞাপন ফর্ম্যাটগুলির মধ্যে একটি (এএমপি, ভিডিও, নেটিভ) অন্তর্ভুক্ত থাকতে হবে। এই উদাহরণে, আমরা html_snippet ক্ষেত্রটি ব্যবহার করে সৃজনশীল নির্দিষ্ট করি।
বিকল্পভাবে, আপনি বিজ্ঞাপন বিন্যাসের ভিত্তিতে নিম্নলিখিত ক্ষেত্রগুলির একটি ব্যবহার করে আপনার সৃজনশীল নির্দিষ্ট করতে পারেন:
এসডিকে রেন্ডার বিজ্ঞাপন
BidResponse.seatbid.bid.ext.sdk_rendered_ad
এএমপি
BidResponse.seatbid.bid.amp_ad_url
ভিডিও
BidResponse.seatbid.bid.adm
নেটিভ
BidResponse.seatbid.bid.adm_native
BidResponse.seatbid.bid.adm ফিল্ডে এইচটিএমএল স্নিপেট ব্যবহার করে আপনার নিজের সার্ভারে হোস্ট করা একটি বিজ্ঞাপন উল্লেখ করুন। স্নিপেটটি ওয়েব পৃষ্ঠায় serted োকানো একটি আইফ্রেমে আবদ্ধ থাকে, ফলস্বরূপ পৃষ্ঠাটি লোড হয়ে গেলে বিজ্ঞাপনটি পুনরুদ্ধার করা হয় এবং রেন্ডার করা হয়। আপনাকে অবশ্যই এইচটিএমএল স্নিপেটটি তৈরি করতে হবে যাতে বিজ্ঞাপন (ব্যানার বা আন্তঃস্থায়ী) কোনও আইফ্রেমের ভিতরে সঠিকভাবে রেন্ডার করে এবং আপনি যে বিজ্ঞাপন স্লটটি বিড করছেন তার জন্য উপযুক্ত আকারে।
একটি বিজ্ঞাপন একটি নিয়মিত ব্যানার (ভিডিও নয়, নেটিভ বা আন্তঃস্থায়ী)।
দরদাতাকে বিড প্রতিক্রিয়াতে আকারটি ঘোষণা করেছে। যখনই অনুরোধে একাধিক আকার উপস্থিত থাকে তখন আকার ঘোষণার প্রয়োজন হয়।
আন্তঃস্থায়ী বিজ্ঞাপনগুলির জন্য একটি ব্যতিক্রম করা হয়। আন্তঃস্থায়ীদের জন্য প্রস্থটি অবশ্যই স্ক্রিনের প্রস্থের কমপক্ষে 50% এবং উচ্চতা স্ক্রিনের উচ্চতার কমপক্ষে 40% হতে হবে।
আপনি যে কোনও বৈধ এইচটিএমএল কোড যা সঠিকভাবে রেন্ডার করে তা ব্যবহার করে একটি এইচটিএমএল স্নিপেট সৃজনশীল নির্দিষ্ট করতে পারেন, তবে crid ক্ষেত্রটি বিডারস্পোন বার্তা বিভাগে নির্দিষ্ট করার ক্ষেত্রে নিষেধাজ্ঞাগুলি মনে রাখবেন। এর জন্য একটি ব্যবহার হ'ল বিজ্ঞাপনটি রেন্ডারিংয়ের অংশ হিসাবে আপনার সার্ভারগুলি থেকে প্রাপ্ত ইউআরএলগুলির যুক্তিগুলিতে অতিরিক্ত তথ্য রাখা। এটি আপনাকে নিজের সার্ভারগুলিতে ছাপ সম্পর্কে স্বেচ্ছাসেবী ডেটা পাস করতে দেয়।
ম্যাক্রোগুলি এমন কিছু বিড প্রতিক্রিয়া ক্ষেত্রগুলিতে এম্বেড করা হয় যা ইউআরএল সমন্বিত কিছু বিড প্রতিক্রিয়া ক্ষেত্র যা বিজ্ঞাপন পরিবেশন সময়ে প্রাসঙ্গিক মান দিয়ে প্রতিস্থাপন করা হয়। উদাহরণস্বরূপ, যদি আপনার বিজয়ী বিডটি আপনার বিডের সাথে অন্তর্ভুক্ত এইচটিএমএল স্নিপেট সৃজনশীল AUCTION_PRICE ম্যাক্রো অন্তর্ভুক্ত করে, ম্যাক্রো নিলামে ছাপের জন্য আপনি যে পরিমাণ অর্থ প্রদান করেছেন তা নির্ধারণের জন্য আপনি ডিক্রিপ্ট করতে পারেন এমন একটি মান দিয়ে প্রতিস্থাপন করা হবে।
আপনি নিম্নলিখিত ক্ষেত্রগুলিতে ম্যাক্রো অন্তর্ভুক্ত করতে পারেন:
BidResponse.seatbid.bid.adm
ম্যাক্রোগুলি এইচটিএমএল স্নিপেট, নেটিভ, ভিডিও ইউআরএল এবং ভিডিও বিশাল এক্সএমএল ফর্ম্যাটগুলির জন্য সমর্থিত।
আপনার যদি একাধিক বিলিং ইউআরএল প্রয়োজন হয় তবে BidResponse.seatbid.bid.burl এর পরিবর্তে এটি ব্যবহার করুন।
উদাহরণস্বরূপ, আপনি URL এর মধ্যে ${MACRO}MACRO করে সৃজনশীল আনতে ব্যবহৃত হয়, যেখানে ওপেনআরটিবি স্পেসিফিকেশনে বর্ণিত সমর্থিত ম্যাক্রোগুলির মধ্যে একটি হ'ল এইচটিএমএল স্নিপেটের অংশ হিসাবে একটি ম্যাক্রো অন্তর্ভুক্ত করতে পারেন।
গুগল ম্যাক্রোস
গুগল ওপেনআরটিবি স্পেসে প্রাপ্তদের বাদ দিয়ে অতিরিক্ত ম্যাক্রো সমর্থন করে। এগুলি আলাদাভাবে ফর্ম্যাট করা হয়, এবং কোনও ইউআরএল এম্বেড করা থাকলে %%MACRO%% হিসাবে উপস্থিত হবে। নিম্নলিখিত টেবিলটি এই ম্যাক্রোগুলি বর্ণনা করে:
ম্যাক্রো
বর্ণনা
ADVERTISING_IDENTIFIER
ক্রেতাদের ইমপ্রেশন রেন্ডারিংয়ে আইওএস আইডিএফএ বা অ্যান্ড্রয়েডের বিজ্ঞাপন আইডি গ্রহণ করার অনুমতি দেয়। বিশদের জন্য ডিক্রিপ্টিং বিজ্ঞাপনদাতা সনাক্তকারী দেখুন।
CACHEBUSTER
একটি এলোমেলো, স্বাক্ষরবিহীন, চার-বাইট পূর্ণসংখ্যার একটি স্ট্রিং উপস্থাপনা।
CLICK_URL_UNESC
বিজ্ঞাপনের জন্য unescapped ক্লিক ইউআরএল। স্নিপেটে, তৃতীয় পক্ষের ক্লিক ইউআরএল -এর একটি পালানো সংস্করণ সরাসরি ম্যাক্রো অনুসরণ করা উচিত।
উদাহরণস্বরূপ, যদি তৃতীয় পক্ষের ক্লিক ইউআরএলটি http://my.adserver.com/some/path/handleclick?click=clk হয়, তবে নিম্নলিখিত কোডটি তৃতীয় পক্ষের একক-এসেপড সংস্করণে ব্যবহার করা যেতে পারে ম্যাক্রো অনুরোধের পরে ইউআরএল ক্লিক করুন:
ইউআরএল প্রথমে গুগলের সাথে ক্লিকটি নিবন্ধিত করবে এবং তারপরে তৃতীয় পক্ষের ক্লিক ইউআরএল -এ পুনর্নির্দেশ করবে।
CLICK_URL_ESC
বিজ্ঞাপনের জন্য পালানো ক্লিক ইউআরএল। আপনার যদি প্রথমে অন্য কোনও সার্ভারের মাধ্যমে মানটি পাস করতে হয় যা তারপরে একটি পুনঃনির্দেশ ফিরে আসবে তবে এটি CLICK_URL_UNESC পরিবর্তে এটি ব্যবহার করুন।
উদাহরণস্বরূপ, নিম্নলিখিত কোডটি এইচটিএমএল স্নিপেটে ব্যবহার করা যেতে পারে:
এটি my.adserver.com এর সাথে ক্লিকটি নিবন্ধিত করবে যা google_click_url প্যারামিটারে পাস করা ইউআরএলটিতে পুনর্নির্দেশের জন্য দায়বদ্ধ হবে। এটি ধরে নিয়েছে যে my.adserver.comgoogle_click_url প্যারামিটারকে একত্রিত করে।
আপনি %%CLICK_URL_ESC%% পরে একটি ডাবল-এসেপড ইউআরএল সংযোজন করতে পারেন। my.adserver.com দ্বারা ইউনেসপিং করার পরে, এটি URL এর একক-এসেপড সংস্করণটি google_click_url সংযুক্ত করে ফেলে। যখন google_click_url আনা হয়, তখন এটি আরও একবার একত্রিত হবে এবং তারপরে পুনর্নির্দেশ করবে।
CLICK_URL_ESC_ESC
বিজ্ঞাপনের জন্য ডাবল-এসেপড ইউআরএল। আপনার যদি প্রথমে অন্য কোনও সার্ভারের মাধ্যমে মানটি পাস করতে হয় যা তারপরে একটি পুনঃনির্দেশ ফিরে আসবে তবে এটি CLICK_URL_UNESC পরিবর্তে এটি ব্যবহার করুন।
উদাহরণস্বরূপ, নিম্নলিখিত কোডটি এইচটিএমএল স্নিপেটে ব্যবহার করা যেতে পারে:
http: বিআইডি অনুরোধের যদি এসএসএল বা https: বিড অনুরোধের জন্য যদি এসএসএল প্রয়োজন হয়।
SITE
বেনামে ইনভেন্টরির জন্য সামগ্রীর ইউআরএল বা বেনামে আইডি এর ইউআরএল-এসেপড ডোমেন।
SITE_URL
অবচয়। সাইট ম্যাক্রো দ্বারা প্রতিস্থাপিত যা অভিন্ন কার্যকারিতা সরবরাহ করে।
TZ_OFFSET
সময়-অঞ্চল অফসেট।
VERIFICATION
উত্পাদনের জন্য বিভিন্ন মান এবং যখন সৃজনশীলটি যাচাইকরণ পাইপলাইনে স্ক্যান করা হয়। ফর্ম্যাটটি হ'ল: %%?VERIFICATION:true-val:false-val%% যেখানে ম্যাক্রো ব্যতীত কোনও মান খালি স্ট্রিং সহ true-val এবং false-val জন্য ব্যবহার করা যেতে পারে। খোলা বিডিংয়ের জন্য, আমরা সুপারিশ করি যে এক্সচেঞ্জগুলি এই ম্যাক্রো ব্যবহার করে; একবার তারা এটি করার পরে, চাহিদা-সাইড প্ল্যাটফর্মগুলিকে পরিবর্তন করার দরকার নেই।
উদাহরণস্বরূপ, যদি কোনও সৃজনশীল %%?VERIFICATION:-1:5000%% তবে পাঠ্য প্রতিস্থাপনটি পরিবেশন করার ক্ষেত্রে 5000 এবং যাচাইকরণ পাইপলাইনে -1 হবে। এটি এই দুটি সেট পিংসের মধ্যে পার্থক্য করতে সহায়তা করা।
WINNING_PRICE
অ্যাকাউন্ট মুদ্রার মাইক্রোগুলিতে এনকোডেড ইমপ্রেশন ব্যয় (অর্থাৎ সিপিএমের চেয়ে সিপিআই)। উদাহরণস্বরূপ, $ 5 মার্কিন ডলারের একটি বিজয়ী সিপিএম 5,000,000 মাইক্রো সিপিএম বা 5,000 মাইক্রো সিপিআইয়ের সাথে মিলে যায়। এক্ষেত্রে WINNING_PRICE এর ডিকোডড মান 5000 হবে। বিজয়ী মূল্য সিপিআইতে নির্দিষ্ট করা আছে।
এই ম্যাক্রোকে পার্স করতে, আপনাকে এমন একটি অ্যাপ্লিকেশন প্রয়োগ করতে হবে যা দামের নিশ্চিতকরণগুলি ডিক্রিপ্ট করে। আরও তথ্যের জন্য ডিক্রিপ্টিং মূল্য নিশ্চিতকরণ পৃষ্ঠাটি দেখুন।
WINNING_PRICE_ESC
ইউআরএল-এসেপড WINNING_PRICE ।
গুগলের প্রয়োজন যে আপনি তৃতীয় পক্ষের পরিবেশিত বিজ্ঞাপনের সৃজনশীলতার মধ্যে CLICK_URL_UNESC বা CLICK_URL_ESC ম্যাক্রো ব্যবহার করেন। গুগল ক্লিক ট্র্যাকিংয়ের জন্য CLICK_URL ম্যাক্রো ব্যবহার করে।
ম্যাক্রোসে পালানো ইউআরএল নিম্নলিখিত স্কিমটি ব্যবহার করে:
স্পেস চরিত্রটি একটি প্লাস সাইন ( + ) দ্বারা প্রতিস্থাপিত হয়।
আলফানিউমেরিক অক্ষর (0-9, এজেড, এজেড) এবং সেট থেকে অক্ষর! ()*,-।/: _ ~ অপরিবর্তিত রয়েছে।
অন্যান্য সমস্ত অক্ষর %XX দ্বারা প্রতিস্থাপিত হয়, যেখানে XX হ'ল হেক্সাডেসিমাল সংখ্যা চরিত্রটি উপস্থাপন করে।
প্রকাশক সীমাবদ্ধতা এবং প্রয়োজনীয়তা
বিড অনুরোধে প্রকাশকরা নিলামে ক্রিয়েটিভদের উপর যে ধরণের বিধিনিষেধ এবং প্রয়োজনীয়তা রাখে সে সম্পর্কে তথ্য অন্তর্ভুক্ত করে।
BidRequest.bcat
আপনি রিয়েল-টাইম বিডিং এপিআইয়ের detectedCategories বিভাগীয় ক্ষেত্রগুলি ব্যবহার করে আপনার জমা দেওয়া ক্রিয়েটিভদের জন্য সনাক্ত করা লোকদের সাথে এই ক্ষেত্র দ্বারা নির্দিষ্ট করা অবরুদ্ধ বিভাগগুলির তুলনা করতে পারেন।
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
অনুশীলনে এটি সর্বদা true হবে কারণ গুগলের সমস্ত ক্রিয়েটিভের জন্য এসএসএল সমর্থন প্রয়োজন।
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes
একটি সীমাবদ্ধ বৈশিষ্ট্যযুক্ত কোনও বিজ্ঞাপনের সাথে কখনই বিড করবেন না। বিক্রেতার প্রকারের মতো অনুমোদিত বৈশিষ্ট্যগুলির জন্য, কোনও বিজ্ঞাপনটি কেবল যদি তার বিক্রেতার প্রকারটি BidRequestallowed_vendor_type তালিকায় থাকে তবেই ফেরত দিন। BidRequest.imp.banner হিসাবে পপুলেটিং ক্ষেত্রগুলি দ্বারা বিড অনুরোধে নির্দিষ্ট করা বিজ্ঞাপন ফর্ম্যাটগুলি কেবল আপনার বিডে অন্তর্ভুক্ত করা উচিত। আরও তথ্যের জন্য BidRequest প্রোটোকল বাফার সংজ্ঞাতে এই ক্ষেত্রগুলির জন্য মন্তব্যগুলি দেখুন।
যদি কোনও বিজ্ঞাপন BidResponse ফিরে আসে তবে আপনাকে সঠিকভাবে BidResponse.seatbid.bid.attr , BidResponse.seatbid.bid.cat , এবং BidResponse.seatbid.bid.adomainBidResponse.seatbid.bid.adm_native.link.urlBidResponse যদি কোনও বিজ্ঞাপনে এই ক্ষেত্রগুলির জন্য একাধিক প্রযোজ্য মান থাকে তবে আপনাকে অবশ্যই প্রতিটি মান অন্তর্ভুক্ত করতে হবে। আরও তথ্যের জন্য BidResponse প্রোটোকল বাফার সংজ্ঞাতে এই ক্ষেত্রগুলির জন্য মন্তব্যগুলি দেখুন। এই ক্ষেত্রগুলি সেট নেই এমন প্রতিক্রিয়াগুলি বাতিল করা হয়।
খোলা পরিমাপ
ওপেন মেজারমেন্ট আপনাকে তৃতীয় পক্ষের বিক্রেতাদের নির্দিষ্ট করতে দেয় যারা মোবাইল অ্যাপ পরিবেশে পরিবেশিত বিজ্ঞাপনগুলির জন্য স্বাধীন পরিমাপ এবং যাচাইকরণ পরিষেবা প্রদান করে।
সমর্থিত বিজ্ঞাপন ফর্ম্যাটগুলির মধ্যে ভিডিও, ব্যানার এবং আন্তঃস্থায়ী বিজ্ঞাপন অন্তর্ভুক্ত রয়েছে। এই ফর্ম্যাটগুলি সমন্বিত বিড প্রতিক্রিয়াতে কীভাবে উন্মুক্ত পরিমাপ ব্যবহার করবেন সে সম্পর্কে আরও তথ্যের জন্য, ওপেন পরিমাপ এসডিকে সহায়তা কেন্দ্রের নিবন্ধটি দেখুন।
নমুনা বিড প্রতিক্রিয়া
নিম্নলিখিত বিভাগগুলি বিভিন্ন বিজ্ঞাপন ধরণের জন্য নমুনা বিড প্রতিক্রিয়া দেখায়।
id:"96Z599PGNvp7Mr99138Fm0"seatbid{bid{id:"NQb32Ge7Rtt84wFn2p8"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB13-7"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"billing_id:29846056590dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}bid{id:"4vwb23qm6iqU6w6G978"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB21"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}seat:"4528:1161:591635"group:false}bidid:"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC"cur:"USD"
OpenRTB JSON
আমাকে উদাহরণ দেখান
{"id":"96Z599PGNvp7Mr99138Fm0","seatbid":[{"bid":[{"id":"NQb32Ge7Rtt84wFn2p8","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB13-7"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","billing_id":"29846056590","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"},{"id":"4vwb23qm6iqU6w6G978","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB21"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"}],"seat":"4528:1161:591635","group":0}],"bidid":"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC","cur":"USD"}
আপনার আবেদন গুগল থেকে বিড অনুরোধ প্রক্রিয়া করার পরে, এটি অবশ্যই একটি প্রতিক্রিয়া তৈরি এবং প্রেরণ করতে হবে। এই গাইডটি কীভাবে প্রতিক্রিয়া তৈরি করতে আপনার অ্যাপ্লিকেশনটিকে কোড করবেন তা ব্যাখ্যা করে।
বিডারস্পোন বার্তা তৈরি করুন
একটি বিড জমা দেওয়ার জন্য, আপনার বিডিং অ্যাপ্লিকেশনটি অবশ্যই আপনার কনফিগার করা ফর্ম্যাটে BidBidResponse সহ একটি বিড অনুরোধের প্রতিক্রিয়া জানাতে হবে। আপনি যদি JSON ফর্ম্যাটটি ব্যবহার করছেন তবে আপনার প্রতিক্রিয়া অবশ্যই Content-Type শিরোনামটি application/json; charset=utf-8 এবং শরীরে জেএসএন BidResponse অন্তর্ভুক্ত করুন। আপনি যদি প্রোটোবিএফ ফর্ম্যাটটি ব্যবহার করছেন তবে আপনার অ্যাপ্লিকেশনটিতে অবশ্যই Content-Type শিরোনামটি application/octet-stream সেট করতে হবে এবং শরীরে সিরিয়ালাইজড BidResponse অন্তর্ভুক্ত করতে হবে।
প্রোটোবিএফ ফর্ম্যাটের জন্য একটি BidResponse তৈরি এবং সিরিয়ালাইজ করার জন্য, আপনাকে অবশ্যই ওপেনআরটিবি.প্রোটো এবং ওপেনআরটিবি-এডেক্স.প্রোটোর উপর ভিত্তি করে প্রোটোবিএফ লাইব্রেরিগুলি তৈরি করতে এবং ব্যবহার করতে হবে, যা যথাক্রমে প্রোটোবফের স্ট্যান্ডার্ড ওপেনআরটিবি BidResponse ক্ষেত্র এবং গুগল এক্সটেনশনগুলি প্রয়োগ করে। এগুলি প্রোটো এবং রেফারেন্স ডেটাতে পাওয়া যাবে।
আপনি যদি কোনও ছাপে বিড করতে না চান তবে আপনাকে অবশ্যই একটি খালি এইচটিটিপি 204 প্রতিক্রিয়া ফিরিয়ে দিতে হবে। আপনার অ্যাপ্লিকেশন অবশ্যই প্রতিটি BidRequest একটি প্রতিক্রিয়া ফিরিয়ে দিতে হবে। যে সময়সীমা এবং প্রতিক্রিয়াগুলি পার্স করা যায় না সেগুলি ত্রুটি এবং উচ্চ ত্রুটির হার সহ গুগল থ্রোটলস দরদাতাদের হিসাবে বিবেচিত হয়।
ক্রিয়েটিভ আইডি
আপনার BidResponseBidResponse.seatbid.bid.crid ক্ষেত্রের (64 বাইট সীমা) এর মাধ্যমে একটি সৃজনশীল নির্দিষ্ট করে। এমনকি অনুরূপ ক্রিয়েটিভদের অবশ্যই এই ক্ষেত্রের জন্য অবশ্যই অনন্য মান থাকতে হবে যদি তারা কোনও উল্লেখযোগ্য বৈশিষ্ট্যগুলির মধ্যে পৃথক হয় তবে সীমাবদ্ধ নয়: আকার, ঘোষিত ইউআরএল, সৃজনশীল বৈশিষ্ট্য এবং বিক্রেতার প্রকারগুলি সহ। অন্য কথায়, আপনাকে অবশ্যই যে কোনও দুটি বিজ্ঞাপনে বিভিন্ন সৃজনশীল আইডি দিতে হবে যা:
দেখুন বা অন্যরকম আচরণ করুন।
বিভিন্ন চিত্র রেন্ডার।
বিভিন্ন উপায়ে রেন্ডার করুন (উদাহরণস্বরূপ, একটি বিজ্ঞাপন একটি চিত্র নিয়ে গঠিত, অন্যটি একটি ভিডিও)।
আপনি যখন আপনার অ্যাপ্লিকেশনটি ডিজাইন করেন, আপনার সনাক্তকারী উত্পন্ন করার একটি নিয়মতান্ত্রিক উপায় সম্পর্কে আপনার সিদ্ধান্ত নেওয়া উচিত যা আপনি যে ধরণের ক্রিয়েটিভ জমা দেওয়ার পরিকল্পনা করছেন তা বোঝায়।
বিজ্ঞাপন বৈশিষ্ট্য
গুগল আপনার বিজ্ঞাপনের বৈশিষ্ট্যগুলি বর্ণনা করার জন্য সৃজনশীল বৈশিষ্ট্যগুলি ঘোষণা করার পরামর্শ দেয় এবং BidResponse.seatbid.bid.apis এবং BidResponse.seatbid.bid.attr , বা BidResponse.seatbid.bid.ext.attribute . নিম্নলিখিতগুলি আপনি কীভাবে বৈশিষ্ট্যগুলি ঘোষণা করতে পারেন তা বর্ণনা করে:
VPAID
BidResponse.seatbid.bid.apis থেকে VPAID_1 , বা VPAID_2 সেট করুন। জেএসএন ফর্ম্যাটের জন্য, এটি যথাক্রমে 1 বা 2 এ সেট করা যেতে পারে।
MRAID
Json ফর্ম্যাটের জন্য BidResponse.seatbid.bid.apisMRAID_1 , বা 3 সেট করুন।
SIZELESS
RESPONSIVEBidResponse.seatbid.bid.attr বা জেএসএন ফর্ম্যাটের জন্য 18 সেট করুন।
PLAYABLE
এটি USER_INTERACTIVE , বা জেএসএন ফর্ম্যাটের জন্য 13BidResponse.seatbid.bid.attr সেট করে নির্দেশিত হয়েছে।
আপনার ক্রিয়েটিভগুলির সনাক্ত করা বৈশিষ্ট্যগুলি সম্পর্কে কীভাবে প্রতিক্রিয়া পাবেন সে সম্পর্কে ব্যাখ্যা করার জন্য ক্রিয়েটিভস রিসোর্সটি দেখুন।
ওপেন বিডিং ক্ষেত্র
ওপেন বিডিংয়ে অংশ নেওয়া এক্সচেঞ্জ এবং নেটওয়ার্ক বিডারদের দ্বারা প্রেরিত বিড প্রতিক্রিয়াগুলি স্ট্যান্ডার্ড রিয়েল-টাইম বিডিতে অংশ নেওয়া অনুমোদিত ক্রেতাদের মতো। ওপেন বিডিং গ্রাহকরা অল্প সংখ্যক অতিরিক্ত ক্ষেত্র নির্দিষ্ট করতে পারেন এবং কয়েকটি বিদ্যমান ক্ষেত্রের বিকল্প ব্যবহার থাকতে পারে। এর মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
মাঠ
বিস্তারিত
BidResponse.imp.pmp.deals.id
এক্সচেঞ্জের নেমস্পেস থেকে ডিল আইডি যা এই বিডের সাথে সম্পর্কিত এবং প্রকাশকদের কাছে রিপোর্ট করেছে।
BidResponse.seatbid.bid.ext.exchange_deal_type
প্রকাশকদের কাছে যে ধরণের চুক্তির রিপোর্ট করা হয়েছে, নিলামে কীভাবে এই চুক্তিটি চিকিত্সা করা হয় তা প্রভাবিত করে।
টোকেন তৃতীয় পক্ষের ক্রেতার তথ্য সনাক্ত করতে ব্যবহৃত হত যদি খোলা দরদাতা হিসাবে এক্সচেঞ্জটি মধ্যস্থতাকারী হয়। এটি তৃতীয় পক্ষের ক্রেতার কাছ থেকে প্রাপ্ত এবং বিড প্রতিক্রিয়াতে অবশ্যই গুগল আনল্টার্টেডে পাস করতে হবে।
সুপারিশ
আপনার সার্ভারগুলিতে অবিচ্ছিন্ন HTTPS সংযোগগুলি ("কী-জীবিত" বা "সংযোগ পুনঃব্যবহার" নামেও পরিচিত) সক্ষম করুন। ন্যূনতম 10 সেকেন্ডে সময়সীমা সেট করুন - উচ্চতর মানগুলি অনেক ক্ষেত্রে উপকারী। গুগল আপনার অ্যাপ্লিকেশনটির প্রাথমিক বিলম্বিত পরীক্ষার সময় এটি যাচাই করে, কারণ অনুমোদিত ক্রেতারা উচ্চ হারে অনুরোধগুলি প্রেরণ করে এবং প্রতিটি অনুরোধের জন্য পৃথক টিসিপি সংযোগ স্থাপনের বিলম্বিত ওভারহেড এড়াতে প্রয়োজন।
বিডার জিতলে ইমপ্রেশনটি যখন রেন্ডার করে তখন ট্র্যাক করতে uncle চ্ছিক ইমপ্রেশন ট্র্যাকিং ইউআরএল অন্তর্ভুক্ত করুন। জয় এবং রেন্ডারিংয়ের মধ্যে ড্রপ অফের কারণে, এটি আরও সঠিক ট্র্যাকিংয়ের পরিসংখ্যান দেয়।
আপনার বিডার কোডটি অবমূল্যায়িত ক্ষেত্রগুলিতে নির্ভরতা থেকে মুক্ত রাখুন, যা আপনার বিডগুলিকে ত্রুটিগুলির সাথে ব্যর্থ হতে পারে।
BidResponse.seatbid.bid.w এবং BidResponse.seatbid.bid.h আপনার BidResponse অন্তর্ভুক্ত করুন। একাধিক বিজ্ঞাপনের আকার অন্তর্ভুক্ত একটি অনুরোধের একটি BidResponse অবশ্যই এই ক্ষেত্রগুলি অন্তর্ভুক্ত করতে হবে বা এটি নিলাম থেকে বাদ দেওয়া হবে।
আপনার প্রতিক্রিয়া আকার 8 কে এর নিচে সীমাবদ্ধ করুন। খুব বড় প্রতিক্রিয়াগুলি নেটওয়ার্কের বিলম্বকে বাড়িয়ে তুলতে পারে এবং সময়সীমা তৈরি করতে পারে।
গুরুত্বপূর্ণ: নমুনাগুলিতে চিত্রিত প্রোটোবিএফ বার্তাগুলি এখানে মানব-পঠনযোগ্য পাঠ্য হিসাবে প্রতিনিধিত্ব করা হয়। যাইহোক, এটি তার উপর দিয়ে বার্তাগুলি কীভাবে প্রেরণ করা হয় না। ওপেনআরটিবি প্রোটোবিএফ ফর্ম্যাটটি ব্যবহার করার সময়, কেবল সিরিয়ালযুক্ত বিডারস্পোন বার্তা গ্রহণ করা হবে।
আপনি নিম্নলিখিত সি ++ কোডটি ব্যবহার করে একটি BidResponse বার্তা তৈরি এবং সিরিয়ালাইজ করতে পারেন:
BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
// respond to the POST with post_response as the content
} else {
// return an error to the POST
}
সৃজনশীল নির্দিষ্ট করুন
আপনার বিড প্রতিক্রিয়া আপনার বিড জিতলে সৃজনশীলকে পরিবেশন করতে নির্দিষ্ট করে। আপনার বিডে অবশ্যই সমর্থিত বিজ্ঞাপন ফর্ম্যাটগুলির মধ্যে একটি (এএমপি, ভিডিও, নেটিভ) অন্তর্ভুক্ত থাকতে হবে। এই উদাহরণে, আমরা html_snippet ক্ষেত্রটি ব্যবহার করে সৃজনশীল নির্দিষ্ট করি।
বিকল্পভাবে, আপনি বিজ্ঞাপন বিন্যাসের ভিত্তিতে নিম্নলিখিত ক্ষেত্রগুলির একটি ব্যবহার করে আপনার সৃজনশীল নির্দিষ্ট করতে পারেন:
এসডিকে রেন্ডার বিজ্ঞাপন
BidResponse.seatbid.bid.ext.sdk_rendered_ad
এএমপি
BidResponse.seatbid.bid.amp_ad_url
ভিডিও
BidResponse.seatbid.bid.adm
নেটিভ
BidResponse.seatbid.bid.adm_native
BidResponse.seatbid.bid.adm ফিল্ডে এইচটিএমএল স্নিপেট ব্যবহার করে আপনার নিজের সার্ভারে হোস্ট করা একটি বিজ্ঞাপন উল্লেখ করুন। স্নিপেটটি ওয়েব পৃষ্ঠায় serted োকানো একটি আইফ্রেমে আবদ্ধ থাকে, ফলস্বরূপ পৃষ্ঠাটি লোড হয়ে গেলে বিজ্ঞাপনটি পুনরুদ্ধার করা হয় এবং রেন্ডার করা হয়। আপনাকে অবশ্যই এইচটিএমএল স্নিপেটটি তৈরি করতে হবে যাতে বিজ্ঞাপন (ব্যানার বা আন্তঃস্থায়ী) কোনও আইফ্রেমের ভিতরে সঠিকভাবে রেন্ডার করে এবং আপনি যে বিজ্ঞাপন স্লটটি বিড করছেন তার জন্য উপযুক্ত আকারে।
একটি বিজ্ঞাপন একটি নিয়মিত ব্যানার (ভিডিও নয়, নেটিভ বা আন্তঃস্থায়ী)।
দরদাতাকে বিড প্রতিক্রিয়াতে আকারটি ঘোষণা করেছে। যখনই অনুরোধে একাধিক আকার উপস্থিত থাকে তখন আকার ঘোষণার প্রয়োজন হয়।
আন্তঃস্থায়ী বিজ্ঞাপনগুলির জন্য একটি ব্যতিক্রম করা হয়। আন্তঃস্থায়ীদের জন্য প্রস্থটি অবশ্যই স্ক্রিনের প্রস্থের কমপক্ষে 50% এবং উচ্চতা স্ক্রিনের উচ্চতার কমপক্ষে 40% হতে হবে।
আপনি যে কোনও বৈধ এইচটিএমএল কোড যা সঠিকভাবে রেন্ডার করে তা ব্যবহার করে একটি এইচটিএমএল স্নিপেট সৃজনশীল নির্দিষ্ট করতে পারেন, তবে crid ক্ষেত্রটি বিডারস্পোন বার্তা বিভাগে নির্দিষ্ট করার ক্ষেত্রে নিষেধাজ্ঞাগুলি মনে রাখবেন। এর জন্য একটি ব্যবহার হ'ল বিজ্ঞাপনটি রেন্ডারিংয়ের অংশ হিসাবে আপনার সার্ভারগুলি থেকে প্রাপ্ত ইউআরএলগুলির যুক্তিগুলিতে অতিরিক্ত তথ্য রাখা। এটি আপনাকে নিজের সার্ভারগুলিতে ছাপ সম্পর্কে স্বেচ্ছাসেবী ডেটা পাস করতে দেয়।
ম্যাক্রোগুলি এমন কিছু বিড প্রতিক্রিয়া ক্ষেত্রগুলিতে এম্বেড করা হয় যা ইউআরএল সমন্বিত কিছু বিড প্রতিক্রিয়া ক্ষেত্র যা বিজ্ঞাপন পরিবেশন সময়ে প্রাসঙ্গিক মান দিয়ে প্রতিস্থাপন করা হয়। উদাহরণস্বরূপ, যদি আপনার বিজয়ী বিডটি আপনার বিডের সাথে অন্তর্ভুক্ত এইচটিএমএল স্নিপেট সৃজনশীল AUCTION_PRICE ম্যাক্রো অন্তর্ভুক্ত করে, ম্যাক্রো নিলামে ছাপের জন্য আপনি যে পরিমাণ অর্থ প্রদান করেছেন তা নির্ধারণের জন্য আপনি ডিক্রিপ্ট করতে পারেন এমন একটি মান দিয়ে প্রতিস্থাপন করা হবে।
আপনি নিম্নলিখিত ক্ষেত্রগুলিতে ম্যাক্রো অন্তর্ভুক্ত করতে পারেন:
BidResponse.seatbid.bid.adm
ম্যাক্রোগুলি এইচটিএমএল স্নিপেট, নেটিভ, ভিডিও ইউআরএল এবং ভিডিও বিশাল এক্সএমএল ফর্ম্যাটগুলির জন্য সমর্থিত।
আপনার যদি একাধিক বিলিং ইউআরএল প্রয়োজন হয় তবে BidResponse.seatbid.bid.burl এর পরিবর্তে এটি ব্যবহার করুন।
উদাহরণস্বরূপ, আপনি URL এর মধ্যে ${MACRO}MACRO করে সৃজনশীল আনতে ব্যবহৃত হয়, যেখানে ওপেনআরটিবি স্পেসিফিকেশনে বর্ণিত সমর্থিত ম্যাক্রোগুলির মধ্যে একটি হ'ল এইচটিএমএল স্নিপেটের অংশ হিসাবে একটি ম্যাক্রো অন্তর্ভুক্ত করতে পারেন।
গুগল ম্যাক্রোস
গুগল ওপেনআরটিবি স্পেসে প্রাপ্তদের বাদ দিয়ে অতিরিক্ত ম্যাক্রো সমর্থন করে। এগুলি আলাদাভাবে ফর্ম্যাট করা হয়, এবং কোনও ইউআরএল এম্বেড করা থাকলে %%MACRO%% হিসাবে উপস্থিত হবে। নিম্নলিখিত টেবিলটি এই ম্যাক্রোগুলি বর্ণনা করে:
ম্যাক্রো
বর্ণনা
ADVERTISING_IDENTIFIER
ক্রেতাদের ইমপ্রেশন রেন্ডারিংয়ে আইওএস আইডিএফএ বা অ্যান্ড্রয়েডের বিজ্ঞাপন আইডি গ্রহণ করার অনুমতি দেয়। বিশদের জন্য ডিক্রিপ্টিং বিজ্ঞাপনদাতা সনাক্তকারী দেখুন।
CACHEBUSTER
একটি এলোমেলো, স্বাক্ষরবিহীন, চার-বাইট পূর্ণসংখ্যার একটি স্ট্রিং উপস্থাপনা।
CLICK_URL_UNESC
বিজ্ঞাপনের জন্য unescapped ক্লিক ইউআরএল। স্নিপেটে, তৃতীয় পক্ষের ক্লিক ইউআরএল -এর একটি পালানো সংস্করণ সরাসরি ম্যাক্রো অনুসরণ করা উচিত।
উদাহরণস্বরূপ, যদি তৃতীয় পক্ষের ক্লিক ইউআরএলটি http://my.adserver.com/some/path/handleclick?click=clk হয়, তবে নিম্নলিখিত কোডটি তৃতীয় পক্ষের একক-এসেপড সংস্করণে ব্যবহার করা যেতে পারে ম্যাক্রো অনুরোধের পরে ইউআরএল ক্লিক করুন:
ইউআরএল প্রথমে গুগলের সাথে ক্লিকটি নিবন্ধিত করবে এবং তারপরে তৃতীয় পক্ষের ক্লিক ইউআরএল -এ পুনর্নির্দেশ করবে।
CLICK_URL_ESC
বিজ্ঞাপনের জন্য পালানো ক্লিক ইউআরএল। আপনার যদি প্রথমে অন্য কোনও সার্ভারের মাধ্যমে মানটি পাস করতে হয় যা তারপরে একটি পুনঃনির্দেশ ফিরে আসবে তবে এটি CLICK_URL_UNESC পরিবর্তে এটি ব্যবহার করুন।
উদাহরণস্বরূপ, নিম্নলিখিত কোডটি এইচটিএমএল স্নিপেটে ব্যবহার করা যেতে পারে:
এটি my.adserver.com এর সাথে ক্লিকটি নিবন্ধিত করবে যা google_click_url প্যারামিটারে পাস করা ইউআরএলটিতে পুনর্নির্দেশের জন্য দায়বদ্ধ হবে। এটি ধরে নিয়েছে যে my.adserver.comgoogle_click_url প্যারামিটারকে একত্রিত করে।
আপনি %%CLICK_URL_ESC%% পরে একটি ডাবল-এসেপড ইউআরএল সংযোজন করতে পারেন। my.adserver.com দ্বারা ইউনেসপিং করার পরে, এটি URL এর একক-এসেপড সংস্করণটি google_click_url সংযুক্ত করে ফেলে। যখন google_click_url আনা হয়, তখন এটি আরও একবার একত্রিত হবে এবং তারপরে পুনর্নির্দেশ করবে।
CLICK_URL_ESC_ESC
বিজ্ঞাপনের জন্য ডাবল-এসেপড ইউআরএল। আপনার যদি প্রথমে অন্য কোনও সার্ভারের মাধ্যমে মানটি পাস করতে হয় যা তারপরে একটি পুনঃনির্দেশ ফিরে আসবে তবে এটি CLICK_URL_UNESC পরিবর্তে এটি ব্যবহার করুন।
উদাহরণস্বরূপ, নিম্নলিখিত কোডটি এইচটিএমএল স্নিপেটে ব্যবহার করা যেতে পারে:
http: বিআইডি অনুরোধের যদি এসএসএল বা https: বিড অনুরোধের জন্য যদি এসএসএল প্রয়োজন হয়।
SITE
বেনামে ইনভেন্টরির জন্য সামগ্রীর ইউআরএল বা বেনামে আইডি এর ইউআরএল-এসেপড ডোমেন।
SITE_URL
অবচয়। সাইট ম্যাক্রো দ্বারা প্রতিস্থাপিত যা অভিন্ন কার্যকারিতা সরবরাহ করে।
TZ_OFFSET
সময়-অঞ্চল অফসেট।
VERIFICATION
উত্পাদনের জন্য বিভিন্ন মান এবং যখন সৃজনশীলটি যাচাইকরণ পাইপলাইনে স্ক্যান করা হয়। ফর্ম্যাটটি হ'ল: %%?VERIFICATION:true-val:false-val%% যেখানে ম্যাক্রো ব্যতীত কোনও মান খালি স্ট্রিং সহ true-val এবং false-val জন্য ব্যবহার করা যেতে পারে। খোলা বিডিংয়ের জন্য, আমরা সুপারিশ করি যে এক্সচেঞ্জগুলি এই ম্যাক্রো ব্যবহার করে; একবার তারা এটি করার পরে, চাহিদা-সাইড প্ল্যাটফর্মগুলিকে পরিবর্তন করার দরকার নেই।
উদাহরণস্বরূপ, যদি কোনও সৃজনশীল %%?VERIFICATION:-1:5000%% তবে পাঠ্য প্রতিস্থাপনটি পরিবেশন করার ক্ষেত্রে 5000 এবং যাচাইকরণ পাইপলাইনে -1 হবে। এটি এই দুটি সেট পিংসের মধ্যে পার্থক্য করতে সহায়তা করা।
WINNING_PRICE
অ্যাকাউন্ট মুদ্রার মাইক্রোগুলিতে এনকোডেড ইমপ্রেশন ব্যয় (অর্থাৎ সিপিএমের চেয়ে সিপিআই)। উদাহরণস্বরূপ, $ 5 মার্কিন ডলারের একটি বিজয়ী সিপিএম 5,000,000 মাইক্রো সিপিএম বা 5,000 মাইক্রো সিপিআইয়ের সাথে মিলে যায়। এক্ষেত্রে WINNING_PRICE এর ডিকোডড মান 5000 হবে। বিজয়ী মূল্য সিপিআইতে নির্দিষ্ট করা আছে।
এই ম্যাক্রোকে পার্স করতে, আপনাকে এমন একটি অ্যাপ্লিকেশন প্রয়োগ করতে হবে যা দামের নিশ্চিতকরণগুলি ডিক্রিপ্ট করে। আরও তথ্যের জন্য ডিক্রিপ্টিং মূল্য নিশ্চিতকরণ পৃষ্ঠাটি দেখুন।
WINNING_PRICE_ESC
ইউআরএল-এসেপড WINNING_PRICE ।
গুগলের প্রয়োজন যে আপনি তৃতীয় পক্ষের পরিবেশিত বিজ্ঞাপনের সৃজনশীলতার মধ্যে CLICK_URL_UNESC বা CLICK_URL_ESC ম্যাক্রো ব্যবহার করেন। গুগল ক্লিক ট্র্যাকিংয়ের জন্য CLICK_URL ম্যাক্রো ব্যবহার করে।
ম্যাক্রোসে পালানো ইউআরএল নিম্নলিখিত স্কিমটি ব্যবহার করে:
স্পেস চরিত্রটি একটি প্লাস সাইন ( + ) দ্বারা প্রতিস্থাপিত হয়।
আলফানিউমেরিক অক্ষর (0-9, এজেড, এজেড) এবং সেট থেকে অক্ষর! ()*,-।/: _ ~ অপরিবর্তিত রয়েছে।
অন্যান্য সমস্ত অক্ষর %XX দ্বারা প্রতিস্থাপিত হয়, যেখানে XX হ'ল হেক্সাডেসিমাল সংখ্যা চরিত্রটি উপস্থাপন করে।
প্রকাশক সীমাবদ্ধতা এবং প্রয়োজনীয়তা
বিড অনুরোধে প্রকাশকরা নিলামে ক্রিয়েটিভদের উপর যে ধরণের বিধিনিষেধ এবং প্রয়োজনীয়তা রাখে সে সম্পর্কে তথ্য অন্তর্ভুক্ত করে।
BidRequest.bcat
আপনি রিয়েল-টাইম বিডিং এপিআইয়ের detectedCategories বিভাগীয় ক্ষেত্রগুলি ব্যবহার করে আপনার জমা দেওয়া ক্রিয়েটিভদের জন্য সনাক্ত করা লোকদের সাথে এই ক্ষেত্র দ্বারা নির্দিষ্ট করা অবরুদ্ধ বিভাগগুলির তুলনা করতে পারেন।
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
অনুশীলনে এটি সর্বদা true হবে কারণ গুগলের সমস্ত ক্রিয়েটিভের জন্য এসএসএল সমর্থন প্রয়োজন।
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes
একটি সীমাবদ্ধ বৈশিষ্ট্যযুক্ত কোনও বিজ্ঞাপনের সাথে কখনই বিড করবেন না। বিক্রেতার প্রকারের মতো অনুমোদিত বৈশিষ্ট্যগুলির জন্য, কোনও বিজ্ঞাপনটি কেবল যদি তার বিক্রেতার প্রকারটি BidRequestallowed_vendor_type তালিকায় থাকে তবেই ফেরত দিন। BidRequest.imp.banner হিসাবে পপুলেটিং ক্ষেত্রগুলি দ্বারা বিড অনুরোধে নির্দিষ্ট করা বিজ্ঞাপন ফর্ম্যাটগুলি কেবল আপনার বিডে অন্তর্ভুক্ত করা উচিত। আরও তথ্যের জন্য BidRequest প্রোটোকল বাফার সংজ্ঞাতে এই ক্ষেত্রগুলির জন্য মন্তব্যগুলি দেখুন।
যদি কোনও বিজ্ঞাপন BidResponse ফিরে আসে তবে আপনাকে সঠিকভাবে BidResponse.seatbid.bid.attr , BidResponse.seatbid.bid.cat , এবং BidResponse.seatbid.bid.adomainBidResponse.seatbid.bid.adm_native.link.urlBidResponse যদি কোনও বিজ্ঞাপনে এই ক্ষেত্রগুলির জন্য একাধিক প্রযোজ্য মান থাকে তবে আপনাকে অবশ্যই প্রতিটি মান অন্তর্ভুক্ত করতে হবে। আরও তথ্যের জন্য BidResponse প্রোটোকল বাফার সংজ্ঞাতে এই ক্ষেত্রগুলির জন্য মন্তব্যগুলি দেখুন। এই ক্ষেত্রগুলি সেট নেই এমন প্রতিক্রিয়াগুলি বাতিল করা হয়।
খোলা পরিমাপ
ওপেন মেজারমেন্ট আপনাকে তৃতীয় পক্ষের বিক্রেতাদের নির্দিষ্ট করতে দেয় যারা মোবাইল অ্যাপ পরিবেশে পরিবেশিত বিজ্ঞাপনগুলির জন্য স্বাধীন পরিমাপ এবং যাচাইকরণ পরিষেবা প্রদান করে।
সমর্থিত বিজ্ঞাপন ফর্ম্যাটগুলির মধ্যে ভিডিও, ব্যানার এবং আন্তঃস্থায়ী বিজ্ঞাপন অন্তর্ভুক্ত রয়েছে। এই ফর্ম্যাটগুলি সমন্বিত বিড প্রতিক্রিয়াতে কীভাবে উন্মুক্ত পরিমাপ ব্যবহার করবেন সে সম্পর্কে আরও তথ্যের জন্য, ওপেন পরিমাপ এসডিকে সহায়তা কেন্দ্রের নিবন্ধটি দেখুন।
নমুনা বিড প্রতিক্রিয়া
নিম্নলিখিত বিভাগগুলি বিভিন্ন বিজ্ঞাপন ধরণের জন্য নমুনা বিড প্রতিক্রিয়া দেখায়।
id:"96Z599PGNvp7Mr99138Fm0"seatbid{bid{id:"NQb32Ge7Rtt84wFn2p8"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB13-7"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"billing_id:29846056590dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}bid{id:"4vwb23qm6iqU6w6G978"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB21"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}seat:"4528:1161:591635"group:false}bidid:"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC"cur:"USD"
OpenRTB JSON
আমাকে উদাহরণ দেখান
{"id":"96Z599PGNvp7Mr99138Fm0","seatbid":[{"bid":[{"id":"NQb32Ge7Rtt84wFn2p8","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB13-7"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","billing_id":"29846056590","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"},{"id":"4vwb23qm6iqU6w6G978","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB21"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"}],"seat":"4528:1161:591635","group":0}],"bidid":"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC","cur":"USD"}
[null,null,["2025-06-10 UTC-তে শেষবার আপডেট করা হয়েছে।"],[[["Bid responses must be serialized `BidResponse` protocol buffers with the `Content-Type` header set to `application/octet-stream` for Protobuf, and a parsable `BidResponse` is required for each `BidRequest`, while an empty HTTP 204 response signals no bid."],["Each creative needs a unique `crid` (creative ID) limited to 64 bytes, and this ID must be unique across creatives if there are differences in size, declared URL, attributes, vendor types, appearance, behavior, or rendering method."],["Ad characteristics should be declared using `BidResponse.seatbid.bid.apis`, `BidResponse.seatbid.bid.attr`, or `BidResponse.seatbid.bid.ext.attribute`, with specific values indicating VPAID, MRAID, SIZELESS, or PLAYABLE attributes, respectively, and additional attributes from `buyer-declarable-creative-attributes.txt`."],["Responses should remain under 8KB, utilize persistent HTTPS connections with at least a 10-second timeout, and employ `BidResponse.seatbid.bid.burl` or `BidResponse.seatbid.bid.ext.impression_tracking_url` for tracking impressions."],["The `BidResponse` must accurately set creative attributes (`BidResponse.seatbid.bid.attr`), categories (`BidResponse.seatbid.bid.cat`), and advertiser domain (`BidResponse.seatbid.bid.adomain`) or native ad link (`BidResponse.seatbid.bid.adm_native.link.url`), as responses lacking these are discarded."]]],["Applications must respond to each `BidRequest` with a parsable `BidResponse`, using Protobuf or an HTTP 204 for no bids. Creatives are identified by a unique `crid`. Ad attributes, such as VPAID and MRAID, are declared in specific fields. Utilize impression tracking URLs and avoid deprecated fields. Open Bidding bid responses are similar to Authorized Buyers. Ad sizes in the response must match the request. Macros are used in URLs. Publisher requirements are specified in the `BidRequest`. The response must accurately reflect these requirements and provide the accurate ad attributes and links.\n"]]