AdMob মেডিয়েশনের সাথে myTarget ইন্টিগ্রেট করা

এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads SDK for React Native ব্যবহার করে মিডিয়েশন-এর মাধ্যমে myTarget থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, যার মধ্যে ওয়াটারফল ইন্টিগ্রেশনও কভার করা হয়েছে। এতে বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে কীভাবে myTarget যোগ করতে হয় এবং React Native অ্যাপে কীভাবে myTarget SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করতে হয় তা কভার করা হয়েছে।

যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
ফর্ম্যাট
অ্যাপ খোলা
ব্যানার
স্থান
পুরস্কার জিতেছেন
পুরস্কৃত ইন্টারস্টিশিয়াল
নেটিভ

পূর্বশর্ত

চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:

  • লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
  • React Native ফ্রেমওয়ার্ক ভার্সন 0.85.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
  • Google Mobile Ads SDK for React Native-এর সাথে কনফিগার করা একটি কার্যকরী React Native প্রোজেক্ট। আরও বিবরণের জন্য Google Mobile Ads SDK for React Native সেট-আপ করুন দেখুন।
    • gma-sdk-react-native ফোল্ডার থেকে adapters ফোল্ডার ডাউনলোড ও এক্সট্র্যাক্ট করেছেন কিনা তা নিশ্চিত করুন। আপনার কাছে adapters ফোল্ডার না থাকলে, Google Mobile Ads SDK for React Native ইনস্টল করুন বিকল্পে গিয়ে এক, দুই ও তিন নম্বর ধাপ অনুসরণ করুন।
  • AdMob মেডিয়েশন সেট-আপ করুন।

ধাপ ১: myTarget UI-তে কনফিগারেশন সেট-আপ করুন

আপনার myTarget অ্যাকাউন্টে লগ-ইন করুন। হেডারে অ্যাপ বিকল্পে ক্লিক করে অ্যাপ পৃষ্ঠায় নেভিগেট করুন। অ্যাপ যোগ করুন বিকল্পে ক্লিক করে আপনার অ্যাপ যোগ করুন।

আপনার অ্যাপ Android এবং iOS প্ল্যাটফর্মে কাজ করলে, আপনাকে প্রতিটি প্ল্যাটফর্মের জন্য আলাদাভাবে সেট-আপ করতে হবে।

Android

এরপর, আপনার অ্যাপের জন্য Google Play URL প্রদান করুন।

iOS

এরপর, আপনার অ্যাপের জন্য iTunes URL** প্রদান করুন।

কোনও অ্যাপ যোগ করার সময়, প্রক্রিয়াটি সম্পূর্ণ করার আগে, myTarget আপনাকে একটি বিজ্ঞাপন ইউনিট তৈরি করতে বলে।

বিকল্পে ক্লিক করুন।

উপলভ্য বিজ্ঞাপন ফর্ম্যাট থেকে ব্যানার বেছে নিন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বোতামে ক্লিক করুন।

স্থান

উপলভ্য বিজ্ঞাপনের ফর্ম্যাট থেকে ইন্টারস্টিশিয়াল বেছে নিন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বোতামে ক্লিক করুন।

পুরস্কার জিতেছেন

উপলভ্য বিজ্ঞাপন ফর্ম্যাট থেকে পুরস্কার প্রদানকারী ভিডিও বেছে নিন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বোতামে ক্লিক করুন।

নেটিভ

উপলভ্য বিজ্ঞাপনের ফর্ম্যাট থেকে নেটিভ বেছে নিন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বিকল্পে ক্লিক করুন।

আপনার বিজ্ঞাপন ইউনিটের বিবরণ পৃষ্ঠায়, স্লট আইডি নোট করে নিন যা বিজ্ঞাপন ইউনিট সেটিংসের অধীনে slot_id হিসেবে দেখতে পাবেন। পরবর্তী বিভাগে আপনার AdMob বিজ্ঞাপন ইউনিট সেট-আপ করতে এই স্লট আইডি ব্যবহার করা হবে।

slot_id ছাড়াও, আপনার AdMob বিজ্ঞাপন ইউনিট আইডি সেট-আপ করতে, myTarget স্থায়ী অ্যাক্সেস টোকেন প্রয়োজন হবে। প্রোফাইল ট্যাবে নেভিগেট করুন এবং অ্যাক্সেস টোকেন বেছে নিন। আপনার myTarget স্থায়ী অ্যাক্সেস টোকেন দেখতে টোকেন তৈরি করুন বা টোকেন দেখুন বিকল্পে ক্লিক করুন।

আপনার app-ads.txt আপডেট করুন

অ্যাপের জন্য অনুমোদিত বিক্রেতা বা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। আপনি আগে থেকে এটি না করে থাকলে, আপনার অ্যাপের জন্য app-ads.txt ফাইল সেট-আপ করুন।

myTarget-এর জন্য app-ads.txt প্রয়োগ করতে, কীভাবে ফাইল তৈরি ও প্রকাশ করতে হয় তা দেখুন।

টেস্ট মোড চালু করুন

myTarget UI-তে টেস্ট ডিভাইস যোগ ও কনফিগার করতে myTarget-এর ডকুমেন্টেশনে দেওয়া নির্দেশাবলী অনুসরণ করুন।

ধাপ ২: AdMob UI-তে myTarget ডিমান্ড সেট-আপ করুন

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন

Android

নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

iOS

নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারদের তালিকায় Mail.ru যোগ করুন

AdMob UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় Mail.ru যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস বিকল্পে দেওয়া ধাপগুলি অনুসরণ করুন।

ধাপ ৩: myTarget SDK ও অ্যাডাপ্টার ইমপোর্ট করা

আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, myTarget-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

  1. Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি gma-sdk-react-native/adapters/mytarget/ ডিরেক্টরি থেকে আপনার প্রোজেক্টের local_packages/ ডিরেক্টরিতে কপি করুন। আপনার কাছে adapters ফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/mytarget/gma-mediation-mytarget-0.1.0.tgz local_packages/

    EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।

  2. আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:

    npm

    npm install ./local_packages/gma-mediation-mytarget-0.1.0.tgz

    তন্তু

    yarn add ./local_packages/gma-mediation-mytarget-0.1.0.tgz

ধাপ ৪: myTarget SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা

Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।

myTarget React Native অ্যাডাপ্টার ভার্সন N/A এবং পরবর্তী ভার্সন UMP SDK এবং কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে GDPR কনসেন্ট সিগন্যাল পাস করার সুবিধা দেয় যা Google-এর অতিরিক্ত কনসেন্ট স্পেসিফিকেশন myTarget SDK-তে ইন্টিগ্রেট করে।

মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন

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

Android এবং iOS ডেভেলপার নির্দেশিকায় মার্কিন যুক্তরাষ্ট্রের রাজ্য গোপনীয়তা আইন বিভাগ দেখুন।

ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন

Android

myTarget ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।

iOS

SKAdNetwork ইন্টিগ্রেশন

আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে, myTarget-এর ডকুমেন্টেশন অনুসরণ করুন।

ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন চালু করুন

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা এবং myTarget UI-তে টেস্ট মোড চালু করেছেন কিনা তা ভাল করে দেখে নিন।

টেস্ট বিজ্ঞাপন যাচাই করা

আপনি myTarget থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, myTarget (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

ঐচ্ছিক ধাপ

নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার

myTarget অ্যাডাপ্টার, নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার সেট করার জন্য বিজ্ঞাপনের অনুরোধে MyTargetMediationExtras অবজেক্ট পাস করা সমর্থন করে।

myTarget iOS অ্যাডাপ্টার থেকে ডিবাগ লগিং চালু বা বন্ধ করতে isIosDebugMode প্যারামিটার ব্যবহার করুন। অন্তর্নিহিত iOS অ্যাডাপ্টার ডিফল্ট হিসেবে লগিং চালু করে। আরও তথ্যের জন্য, iOS নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার নির্দেশিকা দেখুন।

নিম্নলিখিত স্যাম্পেল কোড থেকে isIosDebugMode কীভাবে সেট করতে হয় তা দেখানো হয়েছে:

import { MyTargetMediationExtras } from '@google/gma-mediation-mytarget';

const request: AdRequest = {
  // ...
  mediationExtras: [
    new MyTargetMediationExtras({
      isIosDebugMode: true, // Enable debug logging on iOS
    }),
  ],
};

ত্রুটি কোড

অ্যাডাপ্টার যদি myTarget থেকে বিজ্ঞাপন না পায়, তাহলে প্রকাশক ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন। নিম্নলিখিত ক্লাস থেকে এটি করা যাবে:

Android

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

Android

সমস্যার কোড কারণ
100 myTarget SDK-তে কোনও সমস্যা হয়েছে।
১০১ AdMob UI-তে কনফিগার করা myTarget সার্ভার প্যারামিটার নেই/ভুল।
102 অনুরোধ করা বিজ্ঞাপনের সাইজ, myTarget-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
103 বিজ্ঞাপনের অনুরোধ ইউনিফায়েড নেটিভ বিজ্ঞাপনের অনুরোধ নয়।
104 myTarget থেকে লোড করা নেটিভ বিজ্ঞাপন অনুরোধ করা নেটিভ বিজ্ঞাপনের থেকে আলাদা।
১০৫ myTarget থেকে লোড করা নেটিভ বিজ্ঞাপনে কিছু প্রয়োজনীয় অ্যাসেট (যেমন, ছবি বা আইকন) নেই।
106 myTarget SDK বিজ্ঞাপন দেখাতে পারেনি।

iOS

সমস্যার কোড কারণ
100 myTarget SDK-তে এখনও কোনও বিজ্ঞাপন উপলভ্য নেই।
১০১ AdMob UI-তে কনফিগার করা myTarget সার্ভার প্যারামিটার নেই/ভুল।
102 অনুরোধ করা বিজ্ঞাপনের ফর্ম্যাট myTarget অ্যাডাপ্টারে কাজ করে না।
103 একটি myTarget বিজ্ঞাপন দেখানোর চেষ্টা করা হয়েছে যা লোড করা হয়নি।
104 অনুরোধ করা বিজ্ঞাপনের সাইজ, myTarget-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
১০৫ প্রয়োজনীয় নেটিভ বিজ্ঞাপন অ্যাসেট নেই।

ভার্সন ০.১.১ (কাজ চলছে)

ভার্সন 0.1.0

  • প্রাথমিক রিলিজ।