ক্রেতা SDK বিজ্ঞাপন বিন্যাস

বায়ার এসডিকে বিজ্ঞাপনগুলিতে আপনার নিজস্ব এসডিকে দ্বারা রেন্ডার করা ক্রিয়েটিভ ব্যবহার করা হয়।

যেসব পাবলিশার তাদের অ্যাপে আপনার বিডিং অ্যাডাপ্টার ইন্টিগ্রেট করে, তাদের মোবাইল অ্যাপ ইনভেন্টরি বায়ার SDK রেন্ডারড অ্যাড ফরম্যাটের মাধ্যমে বিড গ্রহণ করতে পারে। এই অ্যাডগুলো কীভাবে রেন্ডার হবে তা নির্ভর করে আপনার SDK ইমপ্লিমেন্টেশন এবং বিড রেসপন্সে আপনার জমা দেওয়া SDKRenderedAd এর উপর।

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

প্রয়োজনীয়তা

অনুমোদিত ক্রেতাদের জন্য বায়ার এসডিকে বিজ্ঞাপন উপলব্ধ। আপনি মিডিয়েশন , বিডার অ্যাডাপ্টার এবং সুরক্ষিত সিগন্যাল সহ গুগল মোবাইল অ্যাডস এসডিকে-এর সাথে সরাসরি অনুমোদিত ক্রেতাদের ইন্টিগ্রেট করতে পারেন। পাবলিশারকে তাদের মোবাইল অ্যাপে আপনার এসডিকে এবং অ্যাডাপ্টার ইন্টিগ্রেট করতে হবে।

এই ইন্টিগ্রেশন পয়েন্টগুলো সম্পর্কে আরও তথ্যের জন্য, অথবা বিজ্ঞাপনের প্রাসঙ্গিকতা বা পরিমাপ উন্নত করতে Google Mobile Ads SDK-এর সাথে অন্যান্য অন-ডিভাইস সিগন্যাল বা প্রসেসিং ইন্টিগ্রেশন নিয়ে আলোচনা করতে, আপনার টেকনিক্যাল অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

দরপত্রের জবাবে অন্তর্ভুক্ত করার আগে পর্যালোচনার জন্য ক্রিয়েটিভগুলো জমা দেওয়ার পরামর্শ দেওয়া হচ্ছে।

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

দরপত্র অনুরোধ

মোবাইল অ্যাপ ইনভেন্টরির জন্য বিড অনুরোধে পাবলিশারের অ্যাপে থাকা SDK এবং অ্যাডাপ্টারগুলির বিবরণ অন্তর্ভুক্ত থাকে, যা আপনি নিম্নলিখিত ফিল্ডগুলিতে রেন্ডারিংয়ের জন্য ব্যবহার করতে পারেন:

এসডিকে আইডি

আপনি বিড রিকোয়েস্ট ব্যবহার করে SDK ID খুঁজে নিতে পারেন, যা আপনাকে বিড রেসপন্সের BidRequest.app.ext.installed_sdk.id ফিল্ডে অবশ্যই প্রদান করতে হবে।

আপনি InstalledSdk রেফারেন্স ডকুমেন্টেশনে এ সম্পর্কে আরও জানতে পারবেন।

বিজ্ঞাপন ইউনিট ম্যাপিং

আপনি বিড রিকোয়েস্টের BidRequest.imp.ext.ad_unit_mapping ফিল্ডটি ব্যবহার করে বিড স্লটের সাথে মেলে এমন অ্যাড ইউনিট ম্যাপিংগুলো খুঁজে বের করতে পারেন।

আপনি AdUnitMapping রেফারেন্স ডকুমেন্টেশনে এ সম্পর্কে আরও জানতে পারবেন।

সুরক্ষিত সংকেত

প্রকাশকরা দরদাতাদের সাথে সুরক্ষিত সংকেত শেয়ার করতে পারেন। আপনি এগুলো BidRequest.imp.ext.buyer_generated_request_data.data ফাইলে খুঁজে পাবেন।

সুরক্ষিত সংকেতগুলো কীভাবে উপস্থাপন করা হয় সে সম্পর্কে আপনি BuyerGeneratedRequestData রেফারেন্স ডকুমেন্টেশনে আরও জানতে পারবেন।

পরীক্ষার অনুরোধ

বিড অনুরোধটি পরীক্ষামূলক কিনা তা যাচাই করতে আপনি BidRequest.test ফিল্ডটি ব্যবহার করতে পারেন।

আপনি BidRequest রেফারেন্স ডকুমেন্টেশনে এই ফিল্ডটি সম্পর্কে আরও জানতে পারবেন।

নমুনা দরপত্র অনুরোধ

id: "<bid_request_id>"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    ...
  }
...
  adx_ext {
   ...
    ad_unit_mapping {
      keyvals {
        key: "key_1"
        value: "value_1"
      }
      keyvals {
        key: "key_2"
        value: "value_2"
      }
      ...
      format: FORMAT_BANNER
    }
  }
}
app {
 ...
  adx_ext {
    installed_sdk {
      id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
      sdk_version {
        major: 1
        minor: 2
        micro: 30
      }
      adapter_version {
        major: 1
        minor: 2
        micro: 3000
      }
    }
    installed_sdk {
    ...
    }
    ...
  }
}
device {
  ...
}
user {
  ...
  }
  adx_ext {
    eids {
      source: "com.google.ads.mediation.partner.PartnerMediationAdapter"
      uids {
        id: "<partner_signal_string>"
      }
    }
  }
}
at: 1
tmax: 1000
cur: "USD"
test: 1
...
adx_ext {
  google_query_id: "<query_string>"
  ...
}

দরপত্রের প্রতিক্রিয়া

দরপত্র জবাবে নিম্নলিখিত ক্ষেত্রগুলি পূরণ করা আবশ্যক:

  • BidResponse.seatbid.bid.adomain
  • BidResponse.seatbid.bid.ext.billing_id
  • BidResponse.seatbid.bid.crid
  • BidResponse.seatbid.bid.w
  • BidResponse.seatbid.bid.h

এছাড়াও, আপনার বিড রেসপন্স অবশ্যই BidResponse.seatbid.bid.ext.sdk_rendered_ad ফাইলটিতে নিম্নলিখিত বিষয়গুলো পূরণ করবে:

এসডিকে আইডি

বিজ্ঞাপনটি রেন্ডার করার জন্য SDK-কে আইডি প্রদান করতে id ফিল্ডটি ব্যবহার করুন।

আপনি BidRequest.app.ext.installed_sdk এ আইডিটি খুঁজে পাবেন।

ঘোষিত বিজ্ঞাপন

BidResponse.seatbid.bid.ext.sdk_rendered_ad.declared_ad ব্যবহার করে এমন একটি ক্রিয়েটিভ প্রদান করুন যা BidRequest.imp.ext.creative_enforcement_settings এ উল্লিখিত শর্তাবলী পূরণ করে এবং বিজ্ঞাপনের রেন্ডারিং ডেটার প্রতিনিধিত্ব করে। html_snippet , video_url , video_vast_xml , বা native_response এর মধ্যে শুধুমাত্র একটি পূরণ করতে হবে।

আপনি যদি declared_ad পূরণ না করেন, তাহলে আমরা ক্রিয়েটিভটি পর্যালোচনা করতে পারি না এবং সেই ক্রিয়েটিভসহ সমস্ত বিড নিলাম থেকে ফিল্টার করে দেওয়া হয়।

আপনি DeclaredAd রেফারেন্স ডকুমেন্টেশন থেকে ডিক্লেয়ার্ড অ্যাড সম্পর্কে আরও জানতে পারবেন।

ডেটা রেন্ডার করা

আপনার বিজ্ঞাপন রেন্ডার করার জন্য বায়ার SDK-কে ডেটা সরবরাহ করতে BidResponse.seatbid.bid.ext.sdk_rendered_ad.rendering_data ফিল্ডটি ব্যবহার করুন।

বায়ার SDK অ্যাড দেওয়ার জন্য করা বিডে declared_ad ফিল্ডে অবশ্যই একটি ক্রিয়েটিভ উল্লেখ করতে হবে। ঘোষিত অ্যাডটিকে অবশ্যই ` rendering_data সঠিকভাবে উপস্থাপন করতে হবে।

এখানে একটি SdkRenderedAd অবজেক্টের নমুনা দেওয়া হলো:

{
  "id": "1234567",
  "rendering_data": "\xd58...,\xd4\x89\xd\xf9",
  "declared_ad": {
    "html_snippet": "<iframe src=\"https://example.com/ads?id=123&
      curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
  }
}

বিড রেসপন্সে ক্রিয়েটিভ অন্তর্ভুক্ত করার আগে, পর্যালোচনার জন্য সেগুলো জমা দিতে আমরা রিয়েল-টাইম বিডিং এপিআই ব্যবহার করার পরামর্শ দিই।

SdkRenderedAd ফিল্ডগুলো সম্পর্কে আরও বিস্তারিত জানতে OpenRTB গাইড দেখুন।

নমুনা দরপত্র প্রতিক্রিয়া

এখানে প্রতিটি বিজ্ঞাপন ফরম্যাটের জন্য নমুনা বিড প্রতিক্রিয়া দেওয়া হলো:

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 99
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 320
    h: 50
    burl: "https://abc.com/billing?td=fn&win_price=${AUCTION_PRICE}"
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          html_snippet: "<!doctype html> <html> ... </html>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
      billing_id: 141763360450
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

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

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 412
    h: 775
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          video_vast_xml: "<VAST version=\"2.0\"><Ad>...</Ad></VAST>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

পুরস্কৃত ভিডিও

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 412
    h: 775
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          video_vast_xml: "<VAST version=\"2.0\"><Ad>...</Ad></VAST>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

স্থানীয়

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 1200
    h: 627
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          native_response {
            ...
            assets {
              id: 1
              title {
                text: ""
              }
            }
            assets {
              id: 2
              data {
                value: "<some_string>"
              }
            }
            assets {
              id: 3
              data {
                value: "View now"
              }
            }
            assets {
              id: 4
              img {
                url: "<valid_image_url>"
                w: 1200
                h: 627
                type: 3
              }
            }
            assets {
              id: 5
              img {
                url: "<valid_image_url>"
                w: 100
                h: 100
                type: 1
              }
            }
            assets {
              id: 6
              data {
                value: ""
              }
            }
            assets {
              id: 7
              data {
                value: "<some_string>"
              }
            }
            link {
              url: "<destination_link>"
            }
          }
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

সৃজনশীল পর্যালোচনা

ক্রিয়েটিভগুলো আমাদের নীতিমালা এবং প্রকাশকের সেটিংস মেনে চলছে কিনা, তা নিশ্চিত করার জন্য পরিবেশন করার আগে সেগুলো পর্যালোচনা করা হয়।

পর্যালোচনার জন্য সৃজনশীল কাজ জমা দেওয়ার দুটি উপায় নিচে দেওয়া হলো:

রিয়েল-টাইম বিডিং এপিআই (প্রস্তাবিত)

পর্যালোচনার জন্য ক্রিয়েটিভ জমা দিতে আপনি রিয়েল-টাইম বিডিং এপিআই-এর buyers.creatives.create মেথডটি ব্যবহার করতে পারেন।

এপিআই-টির জন্য প্রতিটি ক্রিয়েটিভের ক্ষেত্রে মাত্র একটি সাবমিশন প্রয়োজন এবং এটি আপনাকে আপনার ক্রিয়েটিভের রিভিউর স্ট্যাটাস চেক করার সুযোগ দেয়।

দরপত্রের প্রতিক্রিয়া

আপনি সরাসরি দরপত্রের উত্তরে নতুন ক্রিয়েটিভ জমা দিতে পারেন।

পর্যালোচনার জন্য ক্রেতার SDK ক্রিয়েটিভ সহ একটি বিড প্রতিক্রিয়া জমা দিতে, আপনাকে অবশ্যই SdkRenderedAd অবজেক্টের declared_ad ফিল্ডটি ব্যবহার করতে হবে।

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

আরও বিস্তারিত জানতে ক্রিয়েটিভস গাইডটি দেখুন।