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

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

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

AppLovin-এর জন্য AdMob মেডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:

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

১ ওয়াটারফল ইন্টিগ্রেশন প্রাইভেট বিটা ভার্সনে আছে।

ওয়াটারফল শুধু ৩২০x৫০ এবং ৭২৮x৯০ ব্যানার সাইজে কাজ করে। বিডিংয়ে ব্যানার বিজ্ঞাপন কাজ করে না।

পূর্বশর্ত

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

  • লেটেস্ট 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 মেডিয়েশন সেট-আপ করুন।

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

আপনার AppLovin অ্যাকাউন্টে সাইন-আপ বা লগ-ইন করুন।

AdMob বিজ্ঞাপন ইউনিট সেট-আপ করতে, আপনার AppLovin SDK কী এবং রিপোর্ট কী প্রয়োজন হবে। সেগুলি খুঁজে পেতে, AppLovin UI > অ্যাকাউন্ট > কী বিকল্পে গিয়ে দুটি ভ্যালুই দেখুন।

আপনি যদি শুধু বিডিং ইন্টিগ্রেট করার পরিকল্পনা করেন, তাহলে আপনার মিডিয়েশন সেটিংস কনফিগার করুন বিকল্পে যেতে পারেন।

মধ্যস্থতার জন্য অ্যাপ বেছে নিন

বিডিং

বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজনীয় নয়।

জলপ্রপাত

AppLovin UI-তে, আপনার রেজিস্টার করা অ্যাপে যেতে মনিটাইজেশন বিভাগের অধীনে অ্যাপ্লিকেশন বেছে নিন। উপলভ্য অ্যাপের তালিকা থেকে মিডিয়েশনের সাথে ব্যবহার করতে চান এমন অ্যাপ বেছে নিন।

জোন তৈরি করুন

বিডিং

বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজনীয় নয়।

জলপ্রপাত

AppLovin UI-তে, আপনার রেজিস্টার করা জোন আইডি পেতে মনিটাইজেশন বিভাগের অধীনে জোন বেছে নিন। আপনি যদি আগেই আপনার অ্যাপের জন্য প্রয়োজনীয় জোন তৈরি করে থাকেন, তাহলে ধাপ ২-এ যান। নতুন জোন আইডি তৈরি করতে, জোন তৈরি করুন বিকল্পে ক্লিক করুন।

জোন আইডি-এর নাম লিখুন, প্ল্যাটফর্ম হিসেবে Android বেছে নিন এবং বিজ্ঞাপনের ধরন বেছে নিন।

ফ্ল্যাট CPM অথবা AppLovin দ্বারা অপ্টিমাইজ করা বিকল্প বেছে নিয়ে জোনের জন্য দাম কনফিগার করুন। ফ্ল্যাট CPM বিকল্পের জন্য প্রতিটি দেশের ভিত্তিতে CPM কনফিগার করা যেতে পারে। তারপর, সেভ করুন বিকল্পে ক্লিক করুন।

Android

iOS

জোন তৈরি হয়ে গেলে, জোন আইডি কলামের নিচে জোন আইডি খুঁজে পাওয়া যাবে।

Android

iOS

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

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

AppLovin-এর জন্য app-ads.txt প্রয়োগ করতে, আপনার app-ads.txt ফাইলে AppLovin যোগ করুন।

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

AppLovin-এর টেস্ট বিজ্ঞাপন কীভাবে চালু করবেন সেই সম্পর্কে জানতে MAX টেস্ট মোড গাইডে দেওয়া নির্দেশাবলী অনুসরণ করুন।

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

    npm

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

    তন্তু

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

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

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

AppLovin React Native অ্যাডাপ্টার ভার্সন 0.1.0 এবং পরবর্তী ভার্সন UMP SDK এবং কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে জিডিপিআর (GDPR) সম্মতি সিগন্যাল পাস করাকে সাপোর্ট করে যা Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন AppLovin SDK-তে ইন্টিগ্রেট করে। আরও তথ্যের জন্য, TCF v2 সম্মতি দেখুন।

অপ্রাপ্তবয়স্ক ব্যবহারকারীদের ঘোষণা করুন

AppLovin, কোনও বাচ্চার সাথে কানেকশনে AppLovin SDK-এর ইনিশিয়ালাইজেশন সমর্থন করে না। আরও তথ্যের জন্য, "বাচ্চাদের ডেটা বা বাচ্চাদের জন্য পরিষেবা বা অ্যাপ ব্যবহার করার উপর নিষেধাজ্ঞা শুধুমাত্র বাচ্চাদের জন্য" Android বা iOS-এর জন্য AppLovin-এর ডকুমেন্টেশন দেখুন।

Google Mobile Ads React Native মিডিয়েশন প্লাগ-ইন AppLovin -এর জন্য অটোমেটিক মিডিয়েশন বন্ধ করে দেয় AppLovin -এর জন্য সেইসব অ্যাপে যেগুলি বয়স সংক্রান্ত ট্রিটমেন্ট সেট করুন ব্যবহার করে কোনও ব্যবহারকারীকে শিশু হিসেবে ঘোষণা করে।

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

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

AppLovin-এর জন্য Google মোবাইল বিজ্ঞাপন মিডিয়েশন প্লাগ-ইনে AppLovinMediation.setDoNotSell() পদ্ধতি অন্তর্ভুক্ত আছে। নিম্নলিখিত স্যাম্পেল কোড থেকে জানা যায় যে কীভাবে AppLovin SDK-তে সম্মতি সংক্রান্ত তথ্য পাস করতে হয়। এই বিকল্পগুলি AppLovin SDK-তে সঠিকভাবে ফরওয়ার্ড করা হয়েছে কিনা তা নিশ্চিত করতে, Google Mobile Ads SDK ইনিশিয়ালাইজ করার আগে সেট করতে হবে।

import { AppLovinMediation } from '@google/gma-mediation-applovin';
// ...

AppLovinMediation.setDoNotSell(true);

আরও তথ্যের জন্য AppLovin-এর গোপনীয়তা ডকুমেন্টেশন দেখুন।

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

Android

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

iOS

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

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

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

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

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

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

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

ঐচ্ছিক ধাপ

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

নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার সেট করার জন্য বিজ্ঞাপনের অনুরোধে AppLovinMediationExtras অবজেক্ট পাস করার ক্ষেত্রে AppLovin অ্যাডাপ্টার কাজ করে। নিম্নলিখিত স্যাম্পেল কোড থেকে জানা যায় isMuted প্যারামিটার ব্যবহার করে ভিডিও বিজ্ঞাপনে কীভাবে অডিও বন্ধ করতে হয়:

import { AdRequest } from '@google/mobile-ads';
import { AppLovinMediationExtras } from '@google/gma-mediation-applovin';

const request: AdRequest = {
  // ...
  mediationExtras: [
    new AppLovinMediationExtras({
      isMuted: true, // Mute audio for AppLovin ads
    }),
  ],
};

অপ্টিমাইজেশন

আপনার লঞ্চ অ্যাক্টিভিটিতে কল যোগ করলে, অ্যাপ চালু হওয়ার সাথে সাথেই AppLovin ইভেন্ট ট্র্যাক করতে পারে।

ত্রুটি কোড

অ্যাডাপ্টার AppLovin থেকে বিজ্ঞাপন পেতে না পারলে, প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত ত্রুটি চেক করতে পারেন:

Android

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Android

সমস্যার কোড কারণ
-১০০৯ থেকে -১, ২০৪ AppLovin SDK-তে কোনও সমস্যা হয়েছে। আরও জানতে AppLovin-এর ডকুমেন্টেশন দেখুন।
১০১ অনুরোধ করা বিজ্ঞাপনের সাইজ AppLovin-এর সাথে কাজ করে এমন ব্যানারের সাইজের সাথে মেলে না।
103 প্রাসঙ্গিক তথ্য নাল।
104 AppLovin বিড টোকেন খালি আছে।
১০৫ একই জোনের জন্য একাধিক বিজ্ঞাপনের অনুরোধ করা হয়েছে। AppLovin প্রতিটি জোনে একবারে শুধু ১টি বিজ্ঞাপন লোড করতে পারে।
106 বিজ্ঞাপন দেখানোর জন্য রেডি নয়।
108 অনুরোধ করা বিজ্ঞাপনের ফর্ম্যাট AppLovin অ্যাডাপ্টারে কাজ করে না।
১০৯ প্রসঙ্গটি কোনও অ্যাক্টিভিটি ইনস্ট্যান্স নয়।
110 SDK কী নেই।
112 ব্যবহারকারী একজন বাচ্চা।
১১৩ বিজ্ঞাপন ইউনিট আইডি নেই।

iOS

সমস্যার কোড কারণ
-১০০৯ থেকে -১, ২০৪ AppLovin SDK-তে কোনও সমস্যা হয়েছে। আরও তথ্যের জন্য AppLovin-এর ডকুমেন্টেশন দেখুন।
১০১ অনুরোধ করা বিজ্ঞাপনের সাইজ AppLovin-এর সাথে কাজ করে এমন ব্যানারের সাইজের সাথে মেলে না।
102 AdMob UI-তে কনফিগার করা AppLovin সার্ভার প্যারামিটার নেই/ভুল।
103 AppLovin বিজ্ঞাপন দেখানো যায়নি।
104 একই জোনের জন্য একাধিক বিজ্ঞাপনের অনুরোধ করা হয়েছে। AppLovin প্রতিটি জোনে একবারে শুধু ১টি বিজ্ঞাপন লোড করতে পারে।
১০৫ AppLovin SDK কী খুঁজে পাওয়া যায়নি।
107 বিড টোকেন খালি আছে।
108 অনুরোধ করা বিজ্ঞাপনের ফর্ম্যাট AppLovin অ্যাডাপ্টারে কাজ করে না।
110 AppLovin একটি সফল লোড কলব্যাক পাঠিয়েছে কিন্তু শূন্য বিজ্ঞাপন লোড করেছে।
111 AppLovin SDK-এর ইনস্ট্যান্স ফিরিয়ে আনা যায়নি।
112 ব্যবহারকারী একজন বাচ্চা।
১১৩ AppLovin SDK শেয়ার করা ইনস্ট্যান্স শুরু করা হয়নি।
114 AppLovin SDK বিড টোকেন ফেরত দিতে পারেনি।
115 বিজ্ঞাপন ইউনিট আইডি নেই। বিজ্ঞাপন লোড করা যাচ্ছে না।
১১৬ বিজ্ঞাপন রেডি নেই। বিজ্ঞাপন দেখানো যাচ্ছে না।

ভার্সন 0.1.0

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