এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

ক্রেতা SDK বিজ্ঞাপনগুলি আপনার নিজস্ব SDK দ্বারা রেন্ডার করা সৃজনশীলতা ব্যবহার করে।

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

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

আবশ্যকতা

অনুমোদিত ক্রেতাদের জন্য ক্রেতা SDK বিজ্ঞাপনগুলি উপলব্ধ। এই ফর্ম্যাটের জন্য আপনার এবং প্রকাশকের অতিরিক্ত প্রচেষ্টা প্রয়োজন। ক্রেতা SDK বিজ্ঞাপনের জন্য আপনার অ্যাকাউন্ট কনফিগার করতে আপনার টেকনিক্যাল অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন। এরপর আপনি একটি বিডিং অ্যাডাপ্টার প্রয়োগ করতে পারেন যা আপনার SDK কে Google মোবাইল বিজ্ঞাপন SDK এর সাথে যোগাযোগ করতে সক্ষম করে। প্রকাশককে আপনার SDK এবং অ্যাডাপ্টারকে তাদের মোবাইল অ্যাপে একীভূত করতে হবে।

আমরা আপনাকে বিডের প্রতিক্রিয়ায় সৃজনশীলতা অন্তর্ভুক্ত করার আগে পর্যালোচনার জন্য জমা দেওয়ার পরামর্শ দিচ্ছি। বিডের সময় যদি আপনি সৃজনশীলতার ধরণটি না জানেন তবে আপনার টেকনিক্যাল অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

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

বিড অনুরোধ

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

SDK আইডি: আপনি BidRequest.app.ext.installed_sdk.id ফিল্ডের মাধ্যমে বিডের প্রতিক্রিয়ায় যে SDK আইডি প্রদান করতে হবে তা খুঁজে পেতে বিড অনুরোধ ব্যবহার করতে পারেন।; আপনি 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 আইডি

বিজ্ঞাপনটি রেন্ডার করার জন্য 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>",
  }
}

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

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"

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

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

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

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

পর্যালোচনার জন্য সৃজনশীল জমা দেওয়ার জন্য আপনি রিয়েল-টাইম বিডিং API এর buyers.creatives.create পদ্ধতি ব্যবহার করতে পারেন।

API-তে প্রতিটি সৃজনশীলের জন্য শুধুমাত্র একটি জমা দেওয়ার প্রয়োজন হয় এবং এটি আপনাকে আপনার সৃজনশীলের পর্যালোচনার স্থিতি পরীক্ষা করতে দেয়।

বিড প্রতিক্রিয়া

আপনি সরাসরি বিড রেসপন্সে নতুন সৃজনশীলতা জমা দিতে পারেন।

পর্যালোচনার জন্য ক্রেতা SDK সৃজনশীলের সাথে বিড প্রতিক্রিয়া জমা দিতে আপনাকে SdkRenderedAd অবজেক্টের declared_ad ক্ষেত্রটি ব্যবহার করতে হবে।

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

আরও বিস্তারিত জানার জন্য সৃজনশীল নির্দেশিকা দেখুন।