মধ্যস্থতা সঙ্গে Pangle একীভূত

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা) নতুন নির্বাচিত অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে AdMob Mediation ব্যবহার করে Pangle থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে GMA Next-Gen SDK ব্যবহার করতে হয়, যা ওয়াটারফল এবং বিডিং ইন্টিগ্রেশন উভয়কেই অন্তর্ভুক্ত করে। এটি একটি বিজ্ঞাপন ইউনিটের মেডিয়েশন কনফিগারেশনে Pangle কীভাবে যুক্ত করতে হয় এবং Pangle SDK এবং অ্যাডাপ্টারকে একটি Android অ্যাপে কীভাবে সংহত করতে হয় তা কভার করে।

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট

প্যাঙ্গেলের জন্য মেডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:

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

আবশ্যকতা

  • অ্যান্ড্রয়েড এপিআই লেভেল ২৪ বা তার বেশি
  • [বিডিংয়ের জন্য]: বিডিংয়ে সমস্ত সমর্থিত বিজ্ঞাপন ফর্ম্যাট একীভূত করতে, প্যাঙ্গেল অ্যাডাপ্টার 5.5.0.4.0 বা উচ্চতর ( সর্বশেষ সংস্করণটি প্রস্তাবিত ) ব্যবহার করুন।

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

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

একটি নতুন অ্যাপ্লিকেশন যোগ করুন

অ্যাপ্লিকেশন ট্যাবে যান এবং অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

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

আপনার অ্যাপ্লিকেশনের অ্যাপ আইডিটি নোট করুন।

একটি বিজ্ঞাপন প্লেসমেন্ট তৈরি করুন

আপনার অ্যাপ্লিকেশন তৈরি হয়ে গেলে, আপনার বিজ্ঞাপনের স্থান তৈরি করতে যোগ করুন বোতামে ক্লিক করুন।

বিডিং

আপনার বিজ্ঞাপনের ফর্ম্যাট এবং বিজ্ঞাপন প্লেসমেন্টের নাম নির্বাচন করুন, এবং মূল্য নির্ধারণের ধরণ হিসেবে ইন-অ্যাপ বিডিং নির্বাচন করুন। ফর্মের বাকি অংশটি পূরণ করুন এবং জমা দিন ক্লিক করুন।

আপনার বিজ্ঞাপনের স্থান তৈরি হয়ে গেলে, বিজ্ঞাপনের স্থান নির্ধারণের আইডিটি লক্ষ্য করুন।

জলপ্রপাত

আপনার বিজ্ঞাপনের ফর্ম্যাট এবং বিজ্ঞাপন প্লেসমেন্টের নাম এবং মূল্য নির্ধারণের ধরণ হিসেবে গ্লোবাল CPM নির্বাচন করুন। ফর্মের বাকি অংশ পূরণ করুন এবং জমা দিন ক্লিক করুন।

আপনার বিজ্ঞাপনের স্থান তৈরি হয়ে গেলে, বিজ্ঞাপনের স্থান নির্ধারণের আইডিটি লক্ষ্য করুন।

প্যাঙ্গেল রিপোর্টিং এপিআই কী খুঁজুন

বিডিং

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

জলপ্রপাত

পৃষ্ঠার নীচে বাম কোণে থাকা ব্যবহারকারী আইডিটি লক্ষ্য করুন।

Integrations > SDK & API > Pangle Reporting API 2.0 এ ক্লিক করুন। Role ID এবং Security Key তে মনোযোগ দিন।

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

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

Pangle-এর জন্য app-ads.txt বাস্তবায়ন করতে, আপনার app-ads.txt ফাইলে Pangle কীভাবে যোগ করবেন তা দেখুন।

পরীক্ষা মোড চালু করুন

Pangle-এর "How to a Test Ad" নির্দেশিকায় Pangle-এর পরীক্ষামূলক বিজ্ঞাপন কীভাবে সক্ষম করবেন সে সম্পর্কে নির্দেশাবলী অনুসরণ করুন।

ধাপ ২: AdMob UI-তে Pangle চাহিদা সেট আপ করুন

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

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা কনফিগারেশনে Pangle যোগ করতে হবে।

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, "মধ্যস্থতা" ট্যাবে যান। যদি আপনার কাছে এমন কোনও মধ্যস্থতা গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তাহলে সেই মধ্যস্থতা গ্রুপের নামে ক্লিক করে এটি সম্পাদনা করুন এবং "Pangle as an ad source" এ যান।

একটি নতুন মধ্যস্থতা গ্রুপ তৈরি করতে, মধ্যস্থতা গ্রুপ তৈরি করুন নির্বাচন করুন।

আপনার বিজ্ঞাপনের ফর্ম্যাট এবং প্ল্যাটফর্ম লিখুন, তারপর চালিয়ে যান ক্লিক করুন।

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

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

এখন আপনার নির্বাচিত বিজ্ঞাপন ইউনিটগুলি দিয়ে বিজ্ঞাপন ইউনিট কার্ডটি পূর্ণ দেখতে পাবেন:

বিজ্ঞাপনের উৎস হিসেবে Pangle যোগ করুন

বিডিং


বিজ্ঞাপন উৎস বিভাগের বিডিং কার্ডের অধীনে, বিজ্ঞাপন উৎস যোগ করুন নির্বাচন করুন। তারপর Pangle নির্বাচন করুন।

"কীভাবে একটি অংশীদারিত্ব চুক্তি স্বাক্ষর করবেন" এ ক্লিক করুন এবং Pangle-এর সাথে একটি বিডিং অংশীদারিত্ব স্থাপন করুন ।



Acknowledge & agree এ ক্লিক করুন, তারপর Continue এ ক্লিক করুন।



যদি আপনার কাছে ইতিমধ্যেই Pangle-এর জন্য একটি ম্যাপিং থাকে, তাহলে আপনি এটি নির্বাচন করতে পারেন। অন্যথায়, Add maping এ ক্লিক করুন।



এরপর, পূর্ববর্তী বিভাগে প্রাপ্ত অ্যাপ আইডি এবং বিজ্ঞাপন প্লেসমেন্ট আইডি লিখুন। তারপর সম্পন্ন ক্লিক করুন।



জলপ্রপাত


বিজ্ঞাপন উৎস বিভাগের ওয়াটারফল কার্ডের অধীনে, বিজ্ঞাপন উৎস যোগ করুন নির্বাচন করুন।

Pangle নির্বাচন করুন। তারপর Pangle-এর জন্য একটি eCPM মান লিখুন এবং Continue-এ ক্লিক করুন।



যদি আপনার কাছে ইতিমধ্যেই Pangle-এর জন্য একটি ম্যাপিং থাকে, তাহলে আপনি এটি নির্বাচন করতে পারেন। অন্যথায়, Add maping এ ক্লিক করুন।

এরপর, পূর্ববর্তী বিভাগে প্রাপ্ত অ্যাপ আইডি এবং বিজ্ঞাপন প্লেসমেন্ট আইডি লিখুন। তারপর সম্পন্ন ক্লিক করুন।


GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালার বিজ্ঞাপন অংশীদারদের তালিকায় Pangle DSP যোগ করুন

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

ধাপ ৩: প্যাঙ্গেল SDK এবং অ্যাডাপ্টার আমদানি করুন

আপনার প্রজেক্ট-লেভেল settings.gradle.kts ফাইলে, নিম্নলিখিত সংগ্রহস্থলগুলি যোগ করুন:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifact.bytedance.com/repository/pangle/")
    }
  }
}

আপনার অ্যাপ-লেভেল গ্রেডল ফাইলে, নিম্নলিখিত বাস্তবায়ন নির্ভরতা এবং কনফিগারেশন যোগ করুন:

কোটলিন 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03")
    implementation("com.google.ads.mediation:pangle:7.9.1.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

খাঁজকাটা 

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03'
    implementation 'com.google.ads.mediation:pangle:7.9.1.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

ম্যানুয়াল ইন্টিগ্রেশন

  1. অ্যান্ড্রয়েডের জন্য Pangle SDK এর সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং ডাউনলোড করা আর্কাইভ ফোল্ডার থেকে open_ad_sdk.aar ফাইলটি বের করে আপনার প্রোজেক্টে যুক্ত করুন।

  2. গুগলের ম্যাভেন রিপোজিটরিতে প্যাঙ্গেল অ্যাডাপ্টার আর্টিফ্যাক্টগুলিতে নেভিগেট করুন। সর্বশেষ সংস্করণটি নির্বাচন করুন, প্যাঙ্গেল অ্যাডাপ্টারের .aar ফাইলটি ডাউনলোড করুন এবং এটি আপনার প্রকল্পে যুক্ত করুন।

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

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

Pangle অ্যাডাপ্টারটি PangleMediationAdapter.setGDPRConsent() পদ্ধতি প্রদান করে যা সম্মতির তথ্য Pangle অ্যাডাপ্টারে এবং তারপর Pangle SDK-তে ফরোয়ার্ড করে। নিম্নলিখিত নমুনা কোডটি Pangle SDK-তে সম্মতির তথ্য কীভাবে পাঠাতে হয় তা দেখায়। GMA Next-Gen SDK চালু করার আগে সম্মতির তথ্য সেট করুন যাতে সেগুলি Pangle SDK-তে সঠিকভাবে ফরোয়ার্ড করা হয়।

জাভা 

import com.google.ads.mediation.pangle.PangleMediationAdapter;
// ...

PangleMediationAdapter.setGDPRConsent(PAGConstant.PAGGDPRConsentType.PAG_GDPR_CONSENT_TYPE_CONSENT);

কোটলিন 

import com.google.ads.mediation.pangle.PangleMediationAdapter
// ...

PangleMediationAdapter.setGDPRConsent(PAGConstant.PAGGDPRConsentType.PAG_GDPR_CONSENT_TYPE_CONSENT)

আরও বিস্তারিত জানার জন্য এবং প্রতিটি পদ্ধতিতে কী কী মান দেওয়া যেতে পারে তার জন্য Pangle-এর Android ইন্টিগ্রেশন গাইড দেখুন।

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

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

Pangle অ্যাডাপ্টারটি PangleMediationAdapter.setPAConsent() পদ্ধতি প্রদান করে যা সম্মতির তথ্য Pangle অ্যাডাপ্টারে এবং তারপর Pangle SDK-তে ফরোয়ার্ড করে। নিম্নলিখিত নমুনা কোডটি Pangle SDK-তে সম্মতির তথ্য কীভাবে পাঠাতে হয় তা দেখায়। GMA Next-Gen SDK চালু করার আগে সম্মতির তথ্য সেট করুন যাতে সেগুলি Pangle SDK-তে সঠিকভাবে ফরোয়ার্ড করা হয়।

জাভা 

import com.google.ads.mediation.pangle.PangleMediationAdapter;
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);

কোটলিন 

import com.google.ads.mediation.pangle.PangleMediationAdapter
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)

আরও বিস্তারিত জানার জন্য এবং প্রতিটি পদ্ধতিতে কী কী মান দেওয়া যেতে পারে তার জন্য Pangle-এর Android ইন্টিগ্রেশন গাইড দেখুন।

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

প্রোগার্ড অস্পষ্টতা

যদি আপনি অ্যান্ড্রয়েড কোড অস্পষ্ট করার জন্য ProGuard ব্যবহার করেন, তাহলে Pangle SDK কোড অস্পষ্ট না হয়ে যায় তা নিশ্চিত করতে Pangle এর ডকুমেন্টেশনের নির্দেশাবলী অনুসরণ করুন।

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

পরীক্ষামূলক বিজ্ঞাপন সক্ষম করুন

নিশ্চিত করুন যে আপনি AdMob-এর জন্য আপনার পরীক্ষামূলক ডিভাইসটি নিবন্ধন করেছেন এবং Pangle UI-তে পরীক্ষামূলক মোড সক্ষম করেছেন ।

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

আপনি Pangle থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, Pangle (বিডিং) এবং Pangle (ওয়াটারফল) বিজ্ঞাপন উৎস(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক বিভাগে একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন।

ঐচ্ছিক পদক্ষেপ

নেটিভ বিজ্ঞাপন

বিজ্ঞাপন রেন্ডারিং

Pangle অ্যাডাপ্টারটি তার নেটিভ বিজ্ঞাপনগুলিকে NativeAd অবজেক্ট হিসেবে ফেরত পাঠায়। এটি NativeAd এর জন্য নিম্নলিখিত ক্ষেত্রগুলি পূরণ করে।

মাঠ প্যাঙ্গেল অ্যাডাপ্টার দ্বারা সর্বদা সম্পদ অন্তর্ভুক্ত থাকে
শিরোনাম
ভাবমূর্তি ১
শরীর
আইকন
কর্মের আহ্বান
তারকা রেটিং
দোকান
দাম
বিজ্ঞাপনদাতা

১. প্যাঙ্গেল অ্যাডাপ্টারটি তার নেটিভ বিজ্ঞাপনের জন্য মূল চিত্র সম্পদে সরাসরি অ্যাক্সেস প্রদান করে না। পরিবর্তে, অ্যাডাপ্টারটি MediaView একটি ভিডিও বা চিত্র দিয়ে পূর্ণ করে।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি Pangle থেকে কোনও বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে আপনি নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo.getAdSourceResponses() ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

কোনও বিজ্ঞাপন লোড না হলে Pangle অ্যাডাপ্টার দ্বারা প্রেরিত কোড এবং তার সাথে থাকা বার্তাগুলি এখানে দেওয়া হল:

ত্রুটি কোড ডোমেইন কারণ
১০১ com.google.ads.mediation.pangle সম্পর্কে ভুল সার্ভার প্যারামিটার (যেমন অ্যাপ আইডি বা প্লেসমেন্ট আইডি অনুপস্থিত)।
১০২ com.google.ads.mediation.pangle সম্পর্কে অনুরোধ করা বিজ্ঞাপনের আকার Pangle সমর্থিত ব্যানারের আকারের সাথে মেলে না।
১০৩ com.google.ads.mediation.pangle সম্পর্কে অনুপস্থিত অথবা অবৈধ বিড প্রতিক্রিয়া।
-১-৬০০০০ com.pangle.ads সম্পর্কে Pangle SDK একটি ত্রুটি ফেরত দিয়েছে। আরও বিস্তারিত জানার জন্য Pangle এর ডকুমেন্টেশন দেখুন।