Pangle را با میانجیگری ادغام کنید

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Pangle با استفاده از میانجی‌گری استفاده کنید، که هم ادغام آبشار و هم پیشنهاد قیمت را پوشش می‌دهد. نحوه افزودن Pangle به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Pangle SDK و آداپتور در یک برنامه Flutter را پوشش می دهد.

ادغام ها و قالب های تبلیغاتی پشتیبانی شده

آداپتور میانجی‌گری Ad Manager برای Pangle دارای قابلیت‌های زیر است:

یکپارچه سازی
مناقصه
آبشار
فرمت ها
برنامه باز شود
بنر
بینابینی
پاداش داده شد
بینابینی پاداش
بومی

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • فلاتر 3.7.0 یا بالاتر
  • [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی‌شده در مناقصه، از افزونه میانجی‌گری تبلیغات موبایل Google برای Pangle 2.4.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
  • برای استقرار در اندروید
    • Android API سطح 23 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه Flutter در حال کار که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در Pangle UI تنظیم کنید

ثبت نام کنید یا به حساب Pangle خود وارد شوید .

یک برنامه جدید اضافه کنید

به تب Applications رفته و روی دکمه Add App کلیک کنید.

سیستم عاملی را که می خواهید برای آن برنامه ایجاد کنید انتخاب کنید و بقیه فرم را پر کنید. سپس، روی ارسال کلیک کنید.

اندروید

iOS

شناسه برنامه برنامه خود را یادداشت کنید.

اندروید

iOS

یک مکان تبلیغاتی ایجاد کنید

هنگامی که برنامه شما ایجاد شد، روی دکمه افزودن کلیک کنید تا مکان تبلیغات شما ایجاد شود.

اندروید

iOS

مناقصه

قالب تبلیغ و نام مکان تبلیغ خود را انتخاب کنید و مناقصه درون برنامه ای را به عنوان نوع قیمت گذاری انتخاب کنید. بقیه فرم را پر کنید و روی ارسال کلیک کنید.

پس از ایجاد آگهی شما، شناسه قرار دادن آگهی را یادداشت کنید.

اندروید

iOS

آبشار

قالب تبلیغ و نام مکان تبلیغ و CPM جهانی خود را به عنوان نوع قیمت گذاری انتخاب کنید. بقیه فرم را پر کنید و روی ارسال کلیک کنید.

پس از ایجاد آگهی شما، شناسه قرار دادن آگهی را یادداشت کنید.

اندروید

iOS

app-ads.txt خود را به روز کنید

فروشندگان مجاز برای برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا مطمئن شوید موجودی آگهی‌های برنامه شما فقط از طریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از ضرر قابل توجه در درآمد تبلیغات، باید فایل app-ads.txt را پیاده سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

برای پیاده سازی app-ads.txt برای Pangle، به نحوه افزودن Pangle به فایل app-ads.txt مراجعه کنید.

حالت تست را روشن کنید

دستورالعمل‌های Pangle's How to add a Test Ad Guide را در مورد نحوه فعال کردن تبلیغات آزمایشی Pangle دنبال کنید.

مرحله 2: تقاضای Pangle را در رابط کاربری Ad Manager تنظیم کنید

تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید

اندروید

برای دستورالعمل‌ها، به مرحله 2 در راهنمای Android مراجعه کنید.

iOS

برای دستورالعمل‌ها، مرحله 2 را در راهنمای iOS ببینید.

Pangle DSP را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید

برای افزودن Pangle DSP به فهرست شرکای تبلیغات مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

مرحله 3: Pangle SDK و آداپتور را وارد کنید

ادغام از طریق pub.dev

(فقط اندروید) مخازن زیر را به فایل build.gradle داخل فهرست android پروژه خود اضافه کنید:

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

وابستگی زیر را با آخرین نسخه Pangle SDK و آداپتور در فایل pubspec.yaml بسته خود اضافه کنید:

dependencies:
  gma_mediation_pangle: ^

ادغام دستی

آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل را برای Pangle دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml خود مراجعه کنید:

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

مرحله 4: تنظیمات حریم خصوصی را در Pangle SDK اجرا کنید

برای پیروی از خط‌مشی رضایت کاربر اتحادیه اروپا Google ، باید اطلاعات مشخصی را به کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا، و سوئیس ارائه کنید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر فضای ذخیره‌سازی محلی در مواردی که از نظر قانونی لازم است، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات کسب کنید. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع آگهی در زنجیره میانجی شما هستید. Google نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.

افزونه میانجیگری تبلیغات موبایلی Google برای Pangle شامل متد Pangle.SetGDPRConsent() است. کد نمونه زیر نحوه ارسال اطلاعات رضایت به Pangle SDK را نشان می دهد. اطلاعات رضایت را قبل از راه‌اندازی کیت توسعه نرم‌افزار Google Mobile Ads تنظیم کنید تا مطمئن شوید که به‌درستی به Pangle SDK بازارسال می‌شوند.

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetGDPRConsent(0);

برای جزئیات بیشتر و مقادیری که در هر روش می توان ارائه کرد، به راهنمای ادغام Pangle مراجعه کنید.

قوانین حفظ حریم خصوصی ایالات متحده

قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف از طریق پیوند برجسته "اطلاعات شخصی من را نفروشید" در صفحه اصلی طرف "فروشنده" ارائه می شود. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.

افزونه میانجیگری تبلیغات موبایلی Google برای Pangle شامل متد Pangle.SetPAConsent() است. کد نمونه زیر نحوه ارسال اطلاعات رضایت به Pangle SDK را نشان می دهد. اطلاعات رضایت را قبل از راه‌اندازی کیت توسعه نرم‌افزار Google Mobile Ads تنظیم کنید تا مطمئن شوید که به‌درستی به Pangle SDK بازارسال می‌شوند.

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetPAConsent(0);

برای جزئیات بیشتر و مقادیری که در هر روش می توان ارائه کرد، به راهنمای ادغام Pangle مراجعه کنید.

مرحله 5: کد مورد نیاز را اضافه کنید

اندروید

هیچ کد اضافی برای ادغام Pangle مورد نیاز نیست.

iOS

ادغام SKAdNetwork

مستندات Pangle را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.

مرحله 6: اجرای خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید و حالت تست را در Pangle UI فعال کرده اید .

تبلیغات آزمایشی را تأیید کنید

برای تأیید اینکه آگهی‌های آزمایشی را از Pangle دریافت می‌کنید، با استفاده از منبع(های) آگهی Pangle (مناقصه) و Pangle (آبشار) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.

کدهای خطا

اگر آداپتور نتواند تبلیغی را از Pangle دریافت کند، ناشران می‌توانند با استفاده از ResponseInfo در کلاس‌های زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:

اندروید 

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

iOS 

GADMediationAdapterPangle

در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور Pangle هنگام بارگیری نشدن آگهی ارسال می‌شوند:

اندروید

کد خطا دامنه دلیل
101 com.google.ads.mediation.pangle پارامترهای سرور نامعتبر (مثلاً شناسه برنامه یا شناسه مکان وجود ندارد).
102 com.google.ads.mediation.pangle اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از Pangle مطابقت ندارد.
103 com.google.ads.mediation.pangle پاسخ پیشنهادی موجود نیست یا نامعتبر است.
-1-60000 com.pangle.ads Pangle SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Pangle مراجعه کنید.

iOS

کد خطا دامنه دلیل
101 com.google.ads.mediation.pangle پارامترهای سرور نامعتبر (مثلاً شناسه برنامه یا شناسه مکان وجود ندارد).
102 com.google.ads.mediation.pangle اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از Pangle مطابقت ندارد.
-1-60000 ارسال شده توسط Pangle SDK Pangle SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات Pangle مراجعه کنید.

تغییرات آداپتور Pangle Flutter Mediation

نسخه 3.3.0 (در حال پیشرفت)

نسخه 3.2.1

نسخه 3.2.0

نسخه 3.1.1

نسخه 3.1.0

نسخه 3.0.0

نسخه 2.2.0

نسخه 2.1.0

نسخه 2.0.0

نسخه 1.1.0

نسخه 1.0.0