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

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

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

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

Pangle-এর মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
অ্যাপ খোলা
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত
পুরস্কৃত ইন্টারস্টিশিয়াল
স্থানীয়

প্রয়োজনীয়তা

  • অ্যান্ড্রয়েড এপিআই লেভেল ২৪ বা তার বেশি

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

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

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

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

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

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

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

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

নিলাম

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

আপনার বিজ্ঞাপন প্লেসমেন্ট তৈরি হয়ে গেলে, বিজ্ঞাপন প্লেসমেন্ট আইডি (Ad Placement ID) লিখে রাখুন।

জলপ্রপাত

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

আপনার বিজ্ঞাপন প্লেসমেন্ট তৈরি হয়ে গেলে, বিজ্ঞাপন প্লেসমেন্ট আইডি (Ad Placement ID) লিখে রাখুন।

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

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

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

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

Pangle টেস্ট অ্যাড কীভাবে চালু করবেন, তা জানতে Pangle-এর ' How to add a Test Ad' গাইডের নির্দেশনাগুলো অনুসরণ করুন।

ধাপ ২: অ্যাড ম্যানেজার UI-তে Pangle ডিমান্ড সেট আপ করুন

আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।

কোম্পানিগুলিতে প্যাঙ্গল যোগ করুন

নিলাম

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

জলপ্রপাত

অ্যাডমিন > কোম্পানিজ- এ যান, তারপর অল কোম্পানিজ ট্যাবে থাকা নিউ কোম্পানি বাটনে ক্লিক করুন। অ্যাড নেটওয়ার্ক নির্বাচন করুন।

অ্যাড নেটওয়ার্ক হিসেবে Pangle নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং মিডিয়েশন সক্রিয় করুন।

আপনাকে কোনো ইউজারনেম বা পাসওয়ার্ড দিতে হবে না। কাজ শেষ হলে সেভ-এ ক্লিক করুন।

নিরাপদ সংকেত আদান-প্রদান সক্ষম করুন

নিলাম

অ্যাডমিন > গ্লোবাল সেটিংস- এ যান। অ্যাড এক্সচেঞ্জ অ্যাকাউন্ট সেটিংস ট্যাবে যান এবং ‘সিকিওর সিগন্যাল শেয়ারিং’ পর্যালোচনা করে সেটি চালু করুন। ‘সেভ’- এ ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

দরপত্রের অনুরোধে সুরক্ষিত সংকেত শেয়ার করুন

নিলাম

Inventory > Secure Signals- এ যান। Secure signals- এর অধীনে, Pangle DSP অনুসন্ধান করুন এবং Enable app integration টগলটি অন করুন।

সংরক্ষণ করুন- এ ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

SDK বিডিং-এর জন্য নিরাপদ সিগন্যাল শেয়ারিং-এর অনুমতি দিন

নিলাম

ডেলিভারি > ডিমান্ড চ্যানেল সেটিংস- এ যান। ডিফল্ট সেটিংস ট্যাবে, SDK বিডিং-এর জন্য ‘Allow secure signal sharing’ অপশনটি চালু করুন।

সংরক্ষণ করুন- এ ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

প্যাঙ্গল বিডিং কনফিগার করুন

নিলাম

ডেলিভারি > বিডার্স- এ যান এবং গো টু এসডিকে বিডিং-এ ক্লিক করুন।

নতুন দরদাতা-তে ক্লিক করুন।

পঙ্গলকে দরদাতা হিসেবে নির্বাচন করুন।

এই বিডারের জন্য SDK বিডিং সক্রিয় করতে ' চালিয়ে যান'-এ ক্লিক করুন।

সম্পন্ন ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

বিজ্ঞাপন ইউনিট ম্যাপিং কনফিগার করুন

নিলাম

ডেলিভারি > বিডার্স- এ যান এবং গো টু এসডিকে বিডিং-এ ক্লিক করুন।

পঙ্গলের জন্য কোম্পানি নির্বাচন করুন।

অ্যাড ইউনিট ম্যাপিং ট্যাবে যান এবং নতুন অ্যাড ইউনিট ম্যাপিং-এ ক্লিক করুন।

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

অবশেষে, সেভ-এ ক্লিক করুন।

জলপ্রপাত

ডেলিভারি > ইল্ড গ্রুপস -এ যান এবং নিউ ইল্ড গ্রুপ বোতামে ক্লিক করুন। আপনার মোবাইল অ্যাপ্লিকেশনটি নির্বাচন করুন।

নিচে স্ক্রোল করুন এবং ‘Add yield partner’-এ ক্লিক করুন।

পূর্ববর্তী বিভাগে Pangle-এর জন্য আপনার তৈরি করা কোম্পানিটি নির্বাচন করুন। ইন্টিগ্রেশন টাইপ হিসেবে মোবাইল এসডিকে মিডিয়েশন , প্ল্যাটফর্ম হিসেবে অ্যান্ড্রয়েড এবং স্ট্যাটাস হিসেবে অ্যাক্টিভ বেছে নিন।

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

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

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

ধাপ ৩: Pangle 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.25.0-beta01")
    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.25.0-beta01'
    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 ePrivacy Directive এবং General Data Protection Regulation (GDPR)-এর প্রয়োজনীয়তাগুলো প্রতিফলিত করে। আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পৌঁছেছে কিনা তা যাচাই করার দায়িত্ব আপনার। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ প্রেরণ করতে অক্ষম।

Pangle SDK সংস্করণ 7.9.0.9 থেকে শুরু করে, Pangle স্বয়ংক্রিয়ভাবে সেইসব সম্মতি ব্যবস্থাপনা প্ল্যাটফর্ম দ্বারা নির্ধারিত GDPR সম্মতি পড়ে নেয়, যেগুলো Google-এর Additional Consent স্পেসিফিকেশন সমর্থন করে, যার মধ্যে UMP SDK অন্তর্ভুক্ত।

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

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

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-এর অ্যান্ড্রয়েড ইন্টিগ্রেশন গাইড দেখুন।

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

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

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

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

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারে রেজিস্টার করুন এবং প্যাঙ্গল ইউআই-তে টেস্ট মোড চালু করুন ।

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

আপনি Pangle থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, অ্যাড ইন্সপেক্টরে Pangle (Bidding) এবং Pangle (Waterfall) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

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

স্থানীয় বিজ্ঞাপন

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

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

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

১. পঙ্গল অ্যাডাপ্টার তার নেটিভ বিজ্ঞাপনগুলির জন্য মূল ইমেজ অ্যাসেটে সরাসরি অ্যাক্সেস দেয় না। পরিবর্তে, অ্যাডাপ্টারটি 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-এর ডকুমেন্টেশন দেখুন।