বিডিংয়ের সাথে Meta Audience Network ইন্টিগ্রেট করা

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

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

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

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

১ Meta Audience Network ২০২১ সালে শুধু বিডিং হয়ে গেছে।

পূর্বশর্ত

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

  • লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
  • React Native ফ্রেমওয়ার্ক ভার্সন 0.85.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 15.0 বা তার পরবর্তী যেকোনও ভার্সন।
    • লেটেস্ট Meta Audience Network SDK-এর জন্য সাধারণত Xcode-এর লেটেস্ট ভার্সন প্রয়োজন হয়।
  • 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 মেডিয়েশন সেট-আপ করুন।

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

Business Manager শুরু করার পৃষ্ঠাতে সাইন-আপ ও লগ-ইন করুন।

শুরু করুন তারপর নতুন অ্যাকাউন্ট তৈরি করুন বিকল্পে ক্লিক করুন।

আপনার ব্যবসার বিবরণ দিয়ে প্রয়োজনীয় ফিল্ড পূরণ করুন এবং পরবর্তী বিকল্পে ক্লিক করুন।

প্রপার্টি তৈরি করুন

প্রয়োজনীয় তথ্য পূরণ করার পরে, আপনার অ্যাপের জন্য একটি প্রপার্টি তৈরি করার প্রম্পট দেখানো হবে। আপনার অ্যাপের জন্য প্রপার্টির যে নাম দিতে চান সেটি লিখুন এবং পরবর্তী বিকল্পে ক্লিক করুন।

এরপর, মনিটাইজ করার জন্য আপনার প্ল্যাটফর্ম বেছে নিন।

আপনার অ্যাপের বিবরণ যোগ করে পরবর্তী বিকল্পে ক্লিক করুন।

Android

iOS

নতুন পেমেন্ট অ্যাকাউন্ট যোগ করুন বিকল্পে ক্লিক করে আপনার পেমেন্ট অ্যাকাউন্ট সেট-আপ করুন। পেমেন্ট সংক্রান্ত তথ্য লিখতে আপনাকে একটি নতুন পৃষ্ঠায় রিডাইরেক্ট করা হবে। প্রয়োজনীয় বিবরণ পূরণ করে পরবর্তী বিকল্পে ক্লিক করুন।

মিডিয়েশন প্ল্যাটফর্ম হিসেবে Google AdMob বেছে নিন, তারপর প্লেসমেন্ট তৈরি করুন বিকল্পে ক্লিক করুন।

ফর্ম্যাট বেছে নিন, ফর্ম পূরণ করুন এবং তৈরি করুন বিকল্পে ক্লিক করুন।

প্লেসমেন্ট আইডি নোট করে নিন।

হয়ে গেছে বিকল্পে ক্লিক করুন।

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

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

Meta Audience Network-এর জন্য app-ads.txt প্রয়োগ করতে, app-ads.txt-এর মাধ্যমে অনুমোদিত বিক্রেতা শনাক্ত করা দেখুন।

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

Meta Audience Network টেস্ট বিজ্ঞাপন কীভাবে চালু করবেন সেই সম্পর্কে বিস্তারিত নির্দেশাবলীর জন্য Testing Audience Network Implementation guide দেখুন।

ধাপ ২: AdMob UI-তে Meta Audience Network-এর চাহিদা সেট-আপ করা

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

    npm

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

    তন্তু

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

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

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

জিডিপিআর (GDPR) এবং Meta বিজ্ঞাপন সম্পর্কে তথ্যের জন্য Meta-এর নির্দেশিকা পর্যালোচনা করুন।

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

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

ক্যালিফোর্নিয়ার ব্যবহারকারীদের জন্য, Meta-এর ডেটা প্রসেসিং বিকল্প পর্যালোচনা করুন।

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

Android

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

iOS

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

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

বিজ্ঞাপন ট্র্যাকিং চালু করা আছে

আপনি iOS 14 বা তার পরবর্তী ভার্সনের জন্য তৈরি করলে, Meta Audience Network-এর বিজ্ঞাপন ট্র্যাকিং ফ্ল্যাগ কীভাবে সেট করতে হয় সেই সংক্রান্ত নির্দেশাবলী চেক করুন।

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

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

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

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

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

ঐচ্ছিক ধাপ

Android 9-এ ক্যাশিং

Android

Android 9 (API লেভেল ২৮) থেকে শুরু করে, ডিফল্ট হিসেবে ক্লিয়ারটেক্সট সংক্রান্ত সহায়তা বন্ধ করা থাকে, যা Meta Audience Network SDK-এর মিডিয়া ক্যাশিংয়ের কার্যকারিতাকে প্রভাবিত করবে এবং ব্যবহারকারীর অভিজ্ঞতা ও বিজ্ঞাপন থেকে উপার্জনের উপর প্রভাব ফেলতে পারে। আপনার অ্যাপে নেটওয়ার্ক সুরক্ষা কনফিগারেশন আপডেট করতে, Meta-র ডকুমেন্টেশন অনুসরণ করুন।

iOS

iOS ইন্টিগ্রেশনের ক্ষেত্রে প্রযোজ্য নয়।

ত্রুটি কোড

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

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

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

Android

সমস্যার কোড কারণ
১০১ সার্ভার প্যারামিটার ভুল (যেমন, প্লেসমেন্ট আইডি নেই)।
102 অনুরোধ করা বিজ্ঞাপনের সাইজ Meta Audience Network-এর সাথে মানানসই ব্যানার সাইজের সাথে মিলছে না।
103 প্রকাশককে অবশ্যই Activity কনটেক্সট সহ বিজ্ঞাপনের অনুরোধ করতে হবে।
104 Meta Audience Network SDK শুরু করা যায়নি।
১০৫ প্রকাশক ইউনিফায়েড নেটিভ বিজ্ঞাপনের জন্য অনুরোধ করেননি।
106 লোড করা নেটিভ বিজ্ঞাপনটি প্রত্যাশিত অবজেক্টের থেকে আলাদা।
107 ব্যবহার করা Context অবজেক্টটি সঠিক নয়।
108 লোড করা বিজ্ঞাপনে প্রয়োজনীয় নেটিভ বিজ্ঞাপন অ্যাসেট নেই।
১০৯ বিড পেলোড থেকে নেটিভ বিজ্ঞাপন তৈরি করা যায়নি।
110 Meta Audience Network SDK তাদের ইন্টারস্টিশিয়াল/পুরস্কার প্রদানকারী বিজ্ঞাপন দেখাতে পারেনি।
111 Meta Audience Network AdView অবজেক্ট তৈরি করার সময় ব্যতিক্রম ঘটেছে।
1000-9999 Meta Audience Network একটি SDK-নির্দিষ্ট সমস্যা রিটার্ন করেছে। আরও জানতে Meta Audience Network-এর ডকুমেন্টেশন দেখুন।

iOS

সমস্যার কোড কারণ
১০১ সার্ভার প্যারামিটার ভুল (যেমন, প্লেসমেন্ট আইডি নেই)।
102 অনুরোধ করা বিজ্ঞাপনের সাইজ Meta Audience Network-এর সাথে মানানসই ব্যানার সাইজের সাথে মিলছে না।
103 Meta Audience Network বিজ্ঞাপন অবজেক্ট শুরু করা যায়নি।
104 Meta Audience Network SDK তাদের ইন্টারস্টিশিয়াল/পুরস্কার প্রদানকারী বিজ্ঞাপন দেখাতে পারেনি।
১০৫ ব্যানার বিজ্ঞাপনের রুট ভিউ কন্ট্রোলার হল nil।
106 Meta Audience Network SDK শুরু করা যায়নি।
1000-9999 Meta Audience Network একটি SDK-নির্দিষ্ট সমস্যা রিটার্ন করেছে। আরও জানতে Meta Audience Network-এর ডকুমেন্টেশন দেখুন।

ভার্সন 0.1.0

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