উত্তর তৈরি করুন

আপনার অ্যাপ্লিকেশন Google থেকে বিড অনুরোধ প্রসেস করার পরে, এটি অবশ্যই একটি উত্তর তৈরি করবে এবং পাঠাবে। এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে আপনার অ্যাপ্লিকেশন কোড করে উত্তর তৈরি করতে হয়।

BidResponse মেসেজ তৈরি করুন

বিড জমা দিতে, আপনার বিডিং অ্যাপ্লিকেশনকে অবশ্যই একটি বিড অনুরোধের উত্তর দিতে হবে একটি BidResponse সহ একটি Bid আপনার কনফিগার করা ফর্ম্যাটে। আপনি 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 লাইব্রেরি তৈরি ও ব্যবহার করতে হবে, যা যথাক্রমে Protobuf-এ স্ট্যান্ডার্ড OpenRTB BidResponse ফিল্ড এবং Google এক্সটেনশন প্রয়োগ করে। এগুলি প্রোটো ও রেফারেন্স ডেটা-তে পাওয়া যাবে।

আপনি কোনও ইম্প্রেশনে বিড করতে না চাইলে, আপনাকে একটি খালি HTTP 204 রেসপন্স পাঠাতে হবে। আপনার অ্যাপ্লিকেশনকে প্রতিটি BidRequest-এর জন্য একটি উত্তর ফেরত দিতে হবে। টাইম-আউট এবং পার্স করা যায় না এমন রেসপন্সকে সমস্যা হিসেবে বিবেচনা করা হয় এবং Google বেশি সমস্যার হার সহ বিডারদের থ্রটল করে।

ক্রিয়েটিভ আইডি

আপনার BidResponse, BidResponse.seatbid.bid.crid ফিল্ডের মাধ্যমে একটি ক্রিয়েটিভ নির্দিষ্ট করে (১২৮ বাইটের সীমা)। এমনকি একই ধরনের ক্রিয়েটিভের ক্ষেত্রেও এই ফিল্ডে অনন্য ভ্যালু থাকতে হবে যদি সেগুলির মধ্যে উল্লেখযোগ্য কোনও পার্থক্য থাকে, যার মধ্যে এগুলি অন্তর্ভুক্ত থাকলেও তার মধ্যেই সীমিত নয়: সাইজ, ঘোষিত URL, ক্রিয়েটিভ অ্যাট্রিবিউট এবং ভেন্ডরের ধরন। অন্যভাবে বলতে গেলে, আপনাকে যেকোনও দুটি বিজ্ঞাপনের জন্য আলাদা আলাদা ক্রিয়েটিভ আইডি দিতে হবে, যেগুলি:

  • অন্যরকম দেখতে বা আচরণ করা।
  • বিভিন্ন ছবিতে রেন্ডার করুন।
  • বিভিন্ন উপায়ে রেন্ডার করা (যেমন, একটি বিজ্ঞাপনে ছবি থাকে, অন্যটিতে ভিডিও থাকে)।

আপনার অ্যাপ্লিকেশন ডিজাইন করার সময়, আপনি যে ধরনের ক্রিয়েটিভ জমা দেওয়ার পরিকল্পনা করছেন, তার জন্য অর্থপূর্ণ আইডেন্টিফায়ার তৈরি করার একটি পদ্ধতিগত উপায় আপনাকে ঠিক করতে হবে।

বিজ্ঞাপনের অ্যাট্রিবিউট

Google আপনার বিজ্ঞাপনের বৈশিষ্ট্য এবং টার্গেটিং বর্ণনা করার জন্য ক্রিয়েটিভ অ্যাট্রিবিউট ঘোষণা করার সাজেশন দেয়। BidResponse.seatbid.bid.apis এবং BidResponse.seatbid.bid.attr-এর কম্বিনেশন অথবা BidResponse.seatbid.bid.ext.attribute এক্সটেনশন ব্যবহার করে এটি করা যায়। আপনি কীভাবে অ্যাট্রিবিউট ঘোষণা করতে পারেন তা নিচে বর্ণনা করা হয়েছে:

  • VPAID
    BidResponse.seatbid.bid.apis-কে VPAID_1, অথবা VPAID_2-এ সেট করুন। JSON ফর্ম্যাটের জন্য, এটি যথাক্রমে 1 বা 2-এ সেট করা যেতে পারে।
  • MRAID
    JSON ফর্ম্যাটের জন্য BidResponse.seatbid.bid.apis-কে MRAID_1 বা 3 হিসেবে সেট করুন।
  • SIZELESS
    JSON ফর্ম্যাটের জন্য BidResponse.seatbid.bid.attr-কে RESPONSIVE বা 18-এ সেট করুন।
  • PLAYABLE
    এটি BidResponse.seatbid.bid.attr-কে USER_INTERACTIVE-এ সেট করে অথবা JSON ফর্ম্যাটের জন্য 13-এ সেট করে দেখানো হয়।

আপনার ক্রিয়েটিভের শনাক্ত করা প্রপার্টি সম্পর্কে কীভাবে মতামত পাবেন তার ব্যাখ্যা পেতে ক্রিয়েটিভ রিসোর্স দেখুন।

ওপেন বিডিং ফিল্ড

ওপেন বিডিংয়ে অংশগ্রহণকারী এক্সচেঞ্জ ও নেটওয়ার্ক বিডারের পাঠানো বিড রেসপন্স, স্ট্যান্ডার্ড রিয়েল-টাইম বিডিংয়ে অংশগ্রহণকারী অনুমোদিত ক্রেতার পাঠানো বিড রেসপন্সের মতোই। ওপেন বিডিং গ্রাহকরা অল্প সংখ্যক অতিরিক্ত ফিল্ড নির্দিষ্ট করতে পারেন এবং আগে থেকে থাকা কয়েকটি ফিল্ডের বিকল্প ব্যবহার থাকতে পারে। এর মধ্যে এগুলি অন্তর্ভুক্ত:

ফিল্ড বিবরণ
BidResponse.imp.pmp.deals.id

এক্সচেঞ্জের নেমস্পেস থেকে পাওয়া ডিল আইডি যা এই বিডের সাথে সম্পর্কিত এবং প্রকাশকদের কাছে রিপোর্ট করা হয়েছে।

BidResponse.seatbid.bid.ext.exchange_deal_type

প্রকাশকদের কাছে রিপোর্ট করা ডিলের ধরন, যা নিলামে ডিলটি কীভাবে বিবেচনা করা হয় তা প্রভাবিত করে।

BidResponse.seatbid.bid.ext.third_party_buyer_token এক্সচেঞ্জ যদি ওপেন বিডার হিসেবে মধ্যস্থতাকারী হয়, তাহলে থার্ড-পার্টি ক্রেতার তথ্য শনাক্ত করতে টোকেন ব্যবহার করা হয়। এটি থার্ড-পার্টি ক্রেতার থেকে পাওয়া যায় এবং বিডের উত্তরে কোনও পরিবর্তন না করে Google-এর কাছে পাঠাতে হবে।

সাজেশন

  • আপনার সার্ভারে স্থায়ী HTTPS কানেকশন (যা "কিপ-অ্যালাইভ" বা "কানেকশন রিইউজ" নামেও পরিচিত) চালু করুন। টাইমআউট ন্যূনতম ১০ সেকেন্ডে সেট করুন—অনেক ক্ষেত্রে আরও বেশি সময় সেট করলে সুবিধা হয়। আপনার অ্যাপ্লিকেশনের প্রাথমিক লেটেন্সি টেস্টের সময় Google এটি যাচাই করে, কারণ অনুমোদিত ক্রেতারা অনেক বেশি হারে অনুরোধ পাঠায় এবং প্রতিটি অনুরোধের জন্য আলাদা TCP কানেকশন তৈরি করার লেটেন্সি ওভারহেড এড়িয়ে যেতে হয়।
  • বিডার জেতার পরিবর্তে ইম্প্রেশন রেন্ডার হওয়ার সময় ট্র্যাক করতে, ঐচ্ছিক ইম্প্রেশন ট্র্যাকিং URL যোগ করুন। জিতে যাওয়া ও রেন্ডারিংয়ের মধ্যে ড্রপ-অফের কারণে, এটি আরও সঠিক ট্র্যাকিং পরিসংখ্যান প্রদান করে।

  • আপনার বিডার কোডকে বন্ধ হয়ে যাওয়া ফিল্ড থেকে মুক্ত রাখুন, যা আপনার বিডকে ব্যর্থ করতে পারে।
  • আপনার BidResponse-এ BidResponse.seatbid.bid.w এবং BidResponse.seatbid.bid.h অন্তর্ভুক্ত করুন। একাধিক বিজ্ঞাপনের সাইজ অন্তর্ভুক্ত আছে এমন অনুরোধের BidResponse-এ এইসব ফিল্ড অন্তর্ভুক্ত থাকতে হবে, অন্যথায় এটি নিলাম থেকে বাদ দেওয়া হবে।
  • আপনার উত্তরের সাইজ ৮K-এর মধ্যে সীমাবদ্ধ রাখুন। খুব বড় উত্তর নেটওয়ার্ক লেটেন্সি বাড়িয়ে দিতে পারে এবং টাইমআউট হতে পারে।
  • iOS ইনভেনটরিতে বিড করার জন্য নির্দেশিকা অনুসরণ করুন যার জন্য SKAdNetwork অ্যাট্রিবিউশন প্রয়োজন।

বিড উত্তরের উদাহরণ

Protobuf এবং JSON অনুরোধের মানুষের-পঠনযোগ্য স্যাম্পেল নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

OpenRTB Protobuf

OpenRTB JSON

গুরুত্বপূর্ণ: স্যাম্পেলে দেখানো Protobuf মেসেজ এখানে মানুষের-পঠনযোগ্য টেক্সট হিসেবে দেখানো হয়েছে। তবে, তারের মাধ্যমে মেসেজ পাঠানোর পদ্ধতি এটি নয়। 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
  • AMP
    • BidResponse.seatbid.bid.amp_ad_url
  • ভিডিও
    • BidResponse.seatbid.bid.adm
  • নেটিভ
    • BidResponse.seatbid.bid.adm_native

BidResponse.seatbid.bid.adm ফিল্ডে HTML স্নিপেট ব্যবহার করে আপনার নিজের সার্ভারে হোস্ট করা কোনও বিজ্ঞাপন নির্দিষ্ট করুন। স্ন্যাপশটটি ওয়েব পেজে যোগ করা iFrame-এ এনক্লোজ করা থাকে, যার ফলে পেজ লোড হওয়ার সময় বিজ্ঞাপনটি রিট্রিভ ও রেন্ডার করা হয়। আপনাকে HTML স্নিপেট এমনভাবে তৈরি করতে হবে যাতে বিজ্ঞাপন (ব্যানার বা ইন্টারস্টিশিয়াল) iFrame-এর মধ্যে সঠিকভাবে এবং আপনি যে বিজ্ঞাপন স্লটের জন্য বিড করছেন তার উপযুক্ত সাইজে রেন্ডার হয়।

এছাড়াও, বিডের উত্তরে ঘোষিত বিজ্ঞাপনের সাইজ অবশ্যই বিডের অনুরোধে থাকা সাইজের কম্বিনেশনের মধ্যে একটির সাথে হুবহু মিলতে হবে, যখন:

  • বিজ্ঞাপনটি একটি সাধারণ ব্যানার (ভিডিও, নেটিভ বা ইন্টারস্টিশিয়াল নয়)।
  • বিডারের বিড উত্তরে সাইজ ঘোষণা করা হয়েছে। অনুরোধে একাধিক সাইজ থাকলে, সাইজ ঘোষণা করতে হবে।
  • পৃষ্ঠা মধ্যবর্তী বিজ্ঞাপনের ক্ষেত্রে ব্যতিক্রম করা হয়। ইন্টারস্টিশিয়ালের ক্ষেত্রে প্রস্থ স্ক্রিনের প্রস্থের অন্তত ৫০% এবং উচ্চতা স্ক্রিনের উচ্চতার অন্তত ৪০% হতে হবে।

আপনি সঠিকভাবে রেন্ডার করে এমন যেকোনও বৈধ HTML কোড ব্যবহার করে HTML স্নিপেট ক্রিয়েটিভ নির্দিষ্ট করতে পারেন, তবে বিড রেসপন্স মেসেজ তৈরি করুন বিভাগে crid ফিল্ড নির্দিষ্ট করার ক্ষেত্রে বিধিনিষেধের কথা মনে রাখবেন। এর একটি ব্যবহার হল, বিজ্ঞাপন দেখানোর অংশ হিসেবে আপনার সার্ভার থেকে ফেচ করা URL-এর আর্গুমেন্টে অতিরিক্ত তথ্য যোগ করা। এর ফলে আপনি ইম্প্রেশন সম্পর্কে যেকোনও ডেটা আপনার নিজের সার্ভারে পাঠাতে পারবেন।

বিড রেসপন্সে ফেরত আসা HTML স্নিপেটের বেশিরভাগ নীতি থার্ড-পার্টি বিজ্ঞাপনের মতোই। আরও তথ্যের জন্য অনুমোদিত ক্রেতা প্রোগ্রাম নির্দেশিকা, থার্ড-পার্টি বিজ্ঞাপন দেখানোর সুবিধা সংক্রান্ত আবশ্যকতা এবং বিজ্ঞাপনে ক্লিক-থ্রু URL ঘোষণা করা দেখুন।

একই ধরনের ক্লিক-থ্রু URL ব্যবহার করুন

BidResponse.seatbid.bid.ext.clickurl ফিল্ডে আপনার উল্লেখ করা ক্লিক-থ্রু URL আপনার ক্রিয়েটিভে উল্লেখ করা ল্যান্ডিং পৃষ্ঠার URL-এর সাথে একই হতে হবে। নিচে এমন ক্রিয়েটিভের উদাহরণ দেওয়া হল যেগুলি কাজ করে এমন ফর্ম্যাটে রয়েছে এবং clickurl ফিল্ড https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1-এ সেট করা আছে:

HTML

<div id="my-app-install-ad"
     style="font-family: sans-serif; border: 1px solid #ddd; padding: 10px;
            display: flex; align-items: center; width: 100%; height: 100%;
            box-sizing: border-box; cursor: pointer;"
     onclick="window.open('https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1', '_blank')">
  <img src="https://example.com/path/to/app_icon.png" alt="App Icon"
       style="width: 60px; height: 60px; margin-right: 10px;
              border-radius: 8px;">
  <div style="flex-grow: 1;">
    <h4 style="margin: 0 0 5px 0; font-size: 16px; color: #1a73e8;">
      My Awesome App
    </h4>
    <p style="margin: 0 0 10px 0; font-size: 14px; color: #5f6368;">
      The best app for doing awesome things! Download now and get started!
    </p>
    <span style="background-color: #1a73e8; color: white; padding: 8px 12px;
                 text-align: center; text-decoration: none;
                 display: inline-block; border-radius: 4px; font-size: 14px;
                 font-weight: bold;">Install</span>
  </div>
</div>

VAST XML

<VAST version="3.0">
  <Ad id="creative_id_789">
    <InLine>
      <AdSystem>MyBidderSystem</AdSystem>
      <AdTitle>My Awesome App Install Video</AdTitle>
      <Description>Install My Awesome App now!</Description>
      <Error>
        <![CDATA[https://tracking.example.com/vast_error?errorcode=[ERRORCODE]]]>
      </Error>
      <Impression>
        <![CDATA[https://tracking.example.com/vast_impression]]>
      </Impression>
      <Creatives>
        <!-- Main Video Creative -->
        <Creative>
          <Linear>
            <Duration>00:00:15</Duration>
            <TrackingEvents>
              <Tracking event="start">
                <![CDATA[https://tracking.example.com/vast_event?label=start]]>
              </Tracking>
              <Tracking event="firstQuartile">
                <![CDATA[https://tracking.example.com/vast_event?label=firstQuartile]]>
              </Tracking>
              <Tracking event="midpoint">
                <![CDATA[https://tracking.example.com/vast_event?label=midpoint]]>
              </Tracking>
              <Tracking event="thirdQuartile">
                <![CDATA[https://tracking.example.com/vast_event?label=thirdQuartile]]>
              </Tracking>
              <Tracking event="complete">
                <![CDATA[https://tracking.example.com/vast_event?label=complete]]>
              </Tracking>
            </TrackingEvents>
            <VideoClicks>
              <ClickThrough id="gplay-video">
                <![CDATA[https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1]]>
              </ClickThrough>
              <ClickTracking id="bidder-tracker-video">
                <![CDATA[https://tracking.example.com/vast_click]]>
              </ClickTracking>
            </VideoClicks>
            <MediaFiles>
              <MediaFile delivery="progressive" type="video/mp4" width="640"
                         height="360" bitrate="800" scalable="true"
                         maintainAspectRatio="true">
                <![CDATA[https://cdn.example.com/myawesomeapp_video.mp4]]>
              </MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
        <!-- Companion Ad Creative -->
        <Creative>
          <CompanionAds>
            <Companion id="companion1" width="300" height="250"
                       assetWidth="300" assetHeight="250">
              <StaticResource creativeType="image/png">
                <![CDATA[https://cdn.example.com/companion_banner_300x250.png]]>
              </StaticResource>
              <TrackingEvents>
                <Tracking event="creativeView">
                  <![CDATA[https://tracking.example.com/vast_companion_view]]>
                </Tracking>
              </TrackingEvents>
              <CompanionClickThrough>
                <![CDATA[https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1]]>
              </CompanionClickThrough>
              <CompanionClickTracking>
                <![CDATA[https://tracking.example.com/vast_companion_click]]>
              </CompanionClickTracking>
            </Companion>
          </CompanionAds>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>

নেটিভ

{
  "ver": "1.2",
  "assets": [
    {
      "id": 1,
      "title": {
        "text": "My Awesome App"
      }
    },
    {
      "id": 2,
      "img": {
        "url": "https://example.com/path/to/app_icon.png",
        "w": 60,
        "h": 60
      }
    },
    {
      "id": 3,
      "data": {
        "value":
          "The best app for doing awesome things! Download now and get started!"
      }
    },
    {
      "id": 4,
      "data": {
        "value": "Install"
      }
    }
  ],
  "link": {
    "url": "https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1",
    "clicktrackers": [
      "https://tracking.example.com/native_click"
    ]
  },
  "imptrackers": [
    "https://tracking.example.com/native_impression"
  ]
}

ম্যাক্রো নির্দিষ্ট করুন

ম্যাক্রো হল ফর্ম্যাট করা টেক্সট যা কিছু বিড রেসপন্স ফিল্ডে এম্বেড করা থাকে, যার মধ্যে URL থাকে যা বিজ্ঞাপন পরিবেশনের সময় প্রাসঙ্গিক মান দিয়ে প্রতিস্থাপিত হয়। যেমন, আপনার জেতা বিডে, বিডের সাথে অন্তর্ভুক্ত HTML স্নিপেট ক্রিয়েটিভে AUCTION_PRICE ম্যাক্রো অন্তর্ভুক্ত থাকলে, ম্যাক্রোটি এমন একটি ভ্যালু দিয়ে পরিবর্তন করা হবে যা আপনি ডিক্রিপ্ট করে নিলামে ইম্প্রেশনের জন্য কত পেমেন্ট করেছেন তা নির্ধারণ করতে পারবেন।

আপনি নিম্নলিখিত ফিল্ডে ম্যাক্রো অন্তর্ভুক্ত করতে পারবেন:

  • BidResponse.seatbid.bid.adm

    HTML স্নিপেট, নেটিভ, ভিডিও URL এবং ভিডিও VAST XML ফর্ম্যাটের জন্য ম্যাক্রো কাজ করে।

  • BidResponse.seatbid.bid.adm_native.eventtrackers.url

  • BidResponse.seatbid.bid.adm_native.imptrackers

  • BidResponse.seatbid.bid.ext.amp_ad_url

    AMP ক্রিয়েটিভের জন্য শুধুমাত্র Google-নির্দিষ্ট WINNING_PRICE এবং WINNING_PRICE_ESC ম্যাক্রো কাজ করে।

  • BidResponse.seatbid.bid.burl

  • BidResponse.seatbid.bid.ext.impression_tracking_url

    আপনার একাধিক বিলিং URL-এর প্রয়োজন হলে, BidResponse.seatbid.bid.burl-এর পরিবর্তে এটি ব্যবহার করুন।

উদাহরণস্বরূপ, আপনি ক্রিয়েটিভ নিয়ে আসার জন্য ব্যবহৃত URL-এর মধ্যে ${MACRO} এম্বেড করে HTML স্নিপেটের অংশ হিসেবে ম্যাক্রো যোগ করতে পারেন, যেখানে MACRO হল OpenRTB স্পেসিফিকেশনে বর্ণিত কাজ করে এমন ম্যাক্রোগুলির মধ্যে একটি।

Google ম্যাক্রো

OpenRTB স্পেসিফিকেশনে পাওয়া ম্যাক্রো ছাড়াও Google অতিরিক্ত ম্যাক্রো সাপোর্ট করে। এগুলি আলাদাভাবে ফর্ম্যাট করা হয় এবং URL-এ এম্বেড করা থাকলে %%MACRO%% হিসেবে দেখা যাবে। নিম্নলিখিত সারণীতে এইসব ম্যাক্রো বর্ণনা করা আছে:

ম্যাক্রো বিবরণ
ADVERTISING_IDENTIFIER ইম্প্রেশন রেন্ডারিংয়ের সময় ক্রেতাদের iOS IDFA বা Android-এর বিজ্ঞাপন আইডি পেতে দেয়। বিস্তারিত জানতে বিজ্ঞাপনদাতার শনাক্তকারী ডিক্রিপ্ট করা দেখুন।
CACHEBUSTER র‌্যান্ডম, আনসাইনড, চার-বাইট পূর্ণসংখ্যার স্ট্রিং উপস্থাপনা।
CLICK_URL_UNESC

বিজ্ঞাপনের জন্য আনএসকেপড ক্লিক URL। স্নপেটে, থার্ড-পার্টি ক্লিক URL-এর এস্কেপ করা ভার্সন সরাসরি ম্যাক্রোকে অনুসরণ করবে।

যেমন, থার্ড-পার্টি ক্লিক URL যদি http://my.adserver.com/some/path/handleclick?click=clk হয়, তাহলে ম্যাক্রো ইনভোকেশনের পরে থার্ড-পার্টি ক্লিক URL-এর সিঙ্গেল-এস্কেপড ভার্সনের সাথে নিম্নলিখিত কোড ব্যবহার করা যেতে পারে:

<a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>

বিজ্ঞাপন দেখানোর সময়, এটি এইভাবে বড় করা হয়:

<a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>

URL প্রথমে Google-এর সাথে ক্লিক রেজিস্টার করবে এবং তারপরে থার্ড-পার্টি ক্লিক URL-এ রিডাইরেক্ট করবে।

CLICK_URL_ESC

বিজ্ঞাপনের জন্য এস্কেপ করা ক্লিক URL। CLICK_URL_UNESC-এর পরিবর্তে এটি ব্যবহার করুন যদি আপনাকে প্রথমে অন্য সার্ভারের মাধ্যমে ভ্যালু পাস করতে হয় যা পরে একটি রিডাইরেক্ট ফিরিয়ে দেবে।

যেমন, নিম্নলিখিত কোডটি HTML স্নিপেটে ব্যবহার করা যেতে পারে:

<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a>

বিজ্ঞাপন দেখানোর সময়, এটি বড় করে দেখানো হয়:

<a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a>

এটি my.adserver.com-এর সাথে ক্লিক রেজিস্টার করবে, যা google_click_url প্যারামিটারে পাস করা URL-এ রিডাইরেক্ট করার জন্য দায়িত্বপ্রাপ্ত হবে। এটি ধরে নেয় যে my.adserver.com, google_click_url প্যারামিটারকে আনএস্কেপ করে।

আপনি %%CLICK_URL_ESC%%-এর পরে ডবল-এস্কেপ করা URL যোগ করতে পারবেন। my.adserver.com-এর মাধ্যমে আনএসকেপিং করা হয়ে গেলে, URL-এর একটি সিঙ্গেল-এসকেপড ভার্সন google_click_url-এর সাথে যোগ করা হয়। google_click_url ফেচ করা হলে, এটি আরও একবার আনএস্কেপ করবে এবং তারপরে রিডাইরেক্ট করবে।

CLICK_URL_ESC_ESC

বিজ্ঞাপনের জন্য ডবল-এস্কেপ করা URL। প্রথমে অন্য সার্ভারের মাধ্যমে ভ্যালু পাস করতে হলে CLICK_URL_UNESC-এর পরিবর্তে এটি ব্যবহার করুন যা পরে রিডাইরেক্ট করবে।

যেমন, নিম্নলিখিত কোডটি HTML স্নিপেটে ব্যবহার করা যেতে পারে:

<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a>

বিজ্ঞাপন দেখানোর সময়, এটি এইভাবে বড় করা হয়:

<a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
SCHEME বিড অনুরোধে SSL-এর প্রয়োজন না হলে http:-এ প্রসারিত করা হয় অথবা বিড অনুরোধে SSL-এর প্রয়োজন হলে https:-এ প্রসারিত করা হয়।
SITE কন্টেন্ট URL-এর url-escaped ডোমেন বা পরিচয় গোপন করা ইনভেনটরির জন্য পরিচয় গোপন করা আইডি।
SITE_URL বন্ধ করে দেওয়া হয়েছে। SITE ম্যাক্রো দ্বারা প্রতিস্থাপিত হয়েছে যা একই কার্যকারিতা প্রদান করে।
TZ_OFFSET টাইম-জোন অফসেট।
VERIFICATION

প্রোডাকশনের জন্য বিভিন্ন ভ্যালু এবং যাচাইকরণ পাইপলাইনে ক্রিয়েটিভ স্ক্যান করার সময়। ফর্ম্যাটটি হল: %%?VERIFICATION:true-val:false-val%% যেখানে ম্যাক্রো ছাড়া যেকোনও ভ্যালু true-val এবং false-val-এর জন্য ব্যবহার করা যেতে পারে, যার মধ্যে খালি স্ট্রিংও অন্তর্ভুক্ত। ওপেন বিডিংয়ের জন্য, আমরা সাজেস্ট করি যে এক্সচেঞ্জগুলি এই ম্যাক্রো ব্যবহার করুক; একবার তারা তা করলে, ডিমান্ড-সাইড প্ল্যাটফর্মগুলিকে পরিবর্তন করতে হবে না।

যেমন, কোনও ক্রিয়েটিভে যদি %%?VERIFICATION:-1:5000%% থাকে, তাহলে টেক্সট রিপ্লেসমেন্ট সার্ভ করার সময় 5000 এবং যাচাইকরণ পাইপলাইনে -1 হবে। এই দুই ধরনের পিংয়ের মধ্যে পার্থক্য করতে এটি সাহায্য করে।

WINNING_PRICE

অ্যাকাউন্টের মুদ্রার মাইক্রোতে এনকোড করা ইম্প্রেশন খরচ (অর্থাৎ, CPM-এর পরিবর্তে CPI)। যেমন, $৫ মার্কিন ডলারের উইনিং CPM ৫,০০০,০০০ মাইক্রো CPM বা ৫,০০০ মাইক্রো CPI-এর সমান। এই ক্ষেত্রে WINNING_PRICE-এর ডিকোড করা ভ্যালু হবে ৫,০০০। জয়ী দাম CPI-তে উল্লেখ করা আছে।

এই ম্যাক্রো পার্স করতে, আপনাকে এমন একটি অ্যাপ্লিকেশন প্রয়োগ করতে হবে যা দাম কনফার্মেশন ডিক্রিপ্ট করে। আরও তথ্যের জন্য দাম সংক্রান্ত কনফার্মেশন ডিক্রিপ্ট করা পৃষ্ঠা দেখুন।

WINNING_PRICE_ESC URL-এস্কেপ করা WINNING_PRICE।

Google-এর প্রয়োজন যে আপনি থার্ড-পার্টি দ্বারা পরিবেশিত বিজ্ঞাপনের ক্রিয়েটিভের মধ্যে CLICK_URL_UNESC অথবা CLICK_URL_ESC ম্যাক্রো ব্যবহার করুন। ক্লিক ট্র্যাক করার জন্য Google CLICK_URL ম্যাক্রো ব্যবহার করে।

ম্যাক্রোতে URL এস্কেপিং নিম্নলিখিত স্কিম ব্যবহার করে:

  • স্পেসের পরিবর্তে প্লাস চিহ্ন (+) ব্যবহার করা হয়।
  • বর্ণসাংখ্যিক অক্ষর (0-9, a-z, A-Z) এবং !()*,-./:_~ সেট থেকে অক্ষর অপরিবর্তিত থাকে।
  • অন্য সব অক্ষর %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-এ BidResponse.seatbid.bid.attr, BidResponse.seatbid.bid.cat এবং BidResponse.seatbid.bid.adomain অথবা BidResponse.seatbid.bid.adm_native.link.url ফিল্ড সঠিকভাবে সেট করতে হবে। কোনও বিজ্ঞাপনে এইসব ফিল্ডের জন্য একাধিক প্রযোজ্য ভ্যালু থাকলে, আপনাকে প্রতিটি ভ্যালু অন্তর্ভুক্ত করতে হবে। আরও বিবরণের জন্য BidResponse প্রোটোকল বাফার সংজ্ঞায় এইসব ফিল্ডের জন্য কমেন্ট দেখুন। যেসব উত্তরে এই ফিল্ড সেট করা নেই সেগুলি বাতিল করা হয়।

পরিমাপ খুলুন

ওপেন মেজারমেন্ট আপনাকে থার্ড-পার্টি ভেন্ডর নির্দিষ্ট করতে দেয় যারা মোবাইল অ্যাপ এনভায়রনমেন্টে পরিবেশিত বিজ্ঞাপনের জন্য স্বতন্ত্র পরিমাপ ও যাচাইকরণ পরিষেবা প্রদান করে।

কাজ করে এমন বিজ্ঞাপনের ফর্ম্যাটের মধ্যে ভিডিও, ব্যানার ও ইন্টারস্টিশিয়াল বিজ্ঞাপন অন্তর্ভুক্ত। এইসব ফর্ম্যাট সহ বিড রেসপন্সে কীভাবে ওপেন মেজারমেন্ট ব্যবহার করবেন সেই সম্পর্কে আরও তথ্যের জন্য, ওপেন মেজারমেন্ট SDK সহায়তা কেন্দ্র নিবন্ধ দেখুন।

স্যাম্পেল বিড রেসপন্স

নিম্নলিখিত বিভাগে বিভিন্ন ধরনের বিজ্ঞাপনের জন্য স্যাম্পেল বিড রেসপন্স দেখানো হয়েছে।

অ্যাপের ব্যানার

OpenRTB Protobuf

OpenRTB JSON

অ্যাপ ইন্টারস্টিশিয়াল

OpenRTB Protobuf

OpenRTB JSON

অ্যাপ ইন্টারস্টিশিয়াল ভিডিও

OpenRTB Protobuf

OpenRTB JSON

অ্যাপ নেটিভ

OpenRTB Protobuf

OpenRTB JSON

ওয়েব ভিডিও

OpenRTB Protobuf

OpenRTB JSON

এক্সচেঞ্জ বিডারের জন্য মোবাইল ওয়েব ব্যানার

OpenRTB Protobuf

OpenRTB JSON