این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Liftoff Monetize با استفاده از میانجیگری استفاده کنید، که هم یکپارچه‌سازی مناقصه و آبشار را پوشش می‌دهد. نحوه افزودن Liftoff Monetize به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Vungle SDK و آداپتور در یک برنامه Flutter را پوشش می دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | |
| فرمت ها | |
| برنامه باز شود | 1 ، 2 |
| بنر | 1 |
| بینابینی | |
| پاداش داده شد | |
| بینابینی پاداش | 1 |
| بومی | 1 ، 2 |
1 ادغام پیشنهاد برای این قالب در نسخه بتا باز است.
2 ادغام Waterfall برای این فرمت در نسخه بتا باز است.
الزامات
- جدیدترین SDK تبلیغات موبایل گوگل
- فلاتر 3.7.0 یا بالاتر
- [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی‌شده در مناقصه، از افزونه میانجیگری Google Mobile Ads برای AppLovin 5.1.0 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه Flutter در حال کار که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در Liftoff Monetize UI تنظیم کنید
ثبت نام کنید یا به حساب Liftoff Monetize خود وارد شوید .
با کلیک بر روی دکمه افزودن برنامه ، برنامه خود را به داشبورد Liftoff Monetize اضافه کنید.
فرم را پر کنید و تمام جزئیات لازم را وارد کنید.
اندروید
iOS
پس از ایجاد برنامه، برنامه خود را از داشبورد Liftoff Monetize Applications انتخاب کنید.
اندروید
iOS
به شناسه برنامه توجه داشته باشید.
اندروید
iOS
مکان های جدید اضافه کنید
برای ایجاد یک مکان جدید برای استفاده با میانجیگری AdMob، به داشبورد Liftoff Monetize Placements بروید، روی دکمه افزودن مکان کلیک کنید و برنامه خود را از لیست کشویی انتخاب کنید.
جزئیات اضافه کردن مکان‌های جدید در زیر آمده است:
برنامه باز شود
Interstitial را انتخاب کنید و نام مکان را وارد کنید. سپس گزینه Yes را برای Skippable انتخاب کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.
بنر
بنر را انتخاب کنید، یک نام مکان وارد کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.
بنر 300x250
MREC را انتخاب کنید، یک نام مکان وارد کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.
بینابینی
Interstitial را انتخاب کنید، یک نام مکان وارد کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.
پاداش داده شد
Rewarded را انتخاب کنید، یک نام مکان وارد کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.
بینابینی پاداش
Rewarded را انتخاب کنید. یک نام مکان را وارد کنید، Skippable را فعال کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.
بومی
بومی را انتخاب کنید، یک نام مکان وارد کنید و بقیه فرم را پر کنید. [فقط مناقصه] در بخش کسب درآمد ، سوئیچ پیشنهاد قیمت درون برنامه را روی فعال قرار دهید. برای ایجاد مکان، روی دکمه Continue در پایین صفحه کلیک کنید.
شناسه مرجع را یادداشت کنید و روی Sounds Good کلیک کنید.
برنامه باز شود
بنر
بنر 300x250
بینابینی
پاداش داده شد
بینابینی پاداش
بومی
کلید API گزارش خود را پیدا کنید
مناقصه
این مرحله برای ادغام پیشنهادها لازم نیست.
آبشار
علاوه بر شناسه برنامه و شناسه مرجع ، برای تنظیم شناسه واحد تبلیغات AdMob خود به کلید API گزارش درآمدزایی Liftoff نیز نیاز دارید. به داشبورد Liftoff Monetize Reports بروید و روی دکمه Reporting API Key کلیک کنید تا Reporting API Key خود را مشاهده کنید.
حالت تست را روشن کنید
برای فعال کردن تبلیغات آزمایشی، به داشبورد Liftoff Monetize بروید و به برنامه‌ها بروید.
برنامه خود را که می‌خواهید تبلیغات آزمایشی را برای آن فعال کنید، در بخش شناسه مرجع قرار دادن برنامه خود انتخاب کنید. تبلیغات آزمایشی را می توان با انتخاب حالت تست برای نمایش تبلیغات آزمایشی فقط در قسمت وضعیت فعال کرد.
اندروید
iOS
مرحله ۲: تقاضای Liftoff Monetize را در رابط کاربری AdMob تنظیم کنید
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعمل‌ها، به مرحله 2 در راهنمای Android مراجعه کنید.
iOS
برای دستورالعمل‌ها، مرحله 2 را در راهنمای iOS ببینید.
Liftoff را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید
برای افزودن Liftoff به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
مرحله 3: Vungle SDK و آداپتور Liftoff Monetize را وارد کنید
ادغام از طریق pub.dev
وابستگی زیر را با آخرین نسخه‌های Liftoff Monetize SDK و آداپتور در فایل pubspec.yaml بسته خود اضافه کنید:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
ادغام دستی
آخرین نسخه افزونه میانجیگری تبلیغات موبایل گوگل را برای Liftoff Monetize دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml خود مراجعه کنید:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
مرحله 4: تنظیمات حریم خصوصی را در Liftoff Monetize SDK اجرا کنید
رضایت اتحادیه اروپا و GDPR
تحت «خط‌مشی رضایت کاربر اتحادیه اروپا» Google، باید اطمینان حاصل کنید که اطلاعات مشخصی در رابطه با استفاده از شناسه‌های دستگاه و داده‌های شخصی به کاربران منطقه اقتصادی اروپا (EEA) داده می‌شود و از آنها رضایت گرفته می‌شود. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. هنگام درخواست رضایت، باید هر شبکه تبلیغاتی را در زنجیره میانجی خود شناسایی کنید که ممکن است داده‌های شخصی را جمع‌آوری، دریافت یا استفاده کند و اطلاعاتی درباره استفاده هر شبکه ارائه دهد. Google در حال حاضر نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.
افزونه میانجیگری تبلیغات تلفن همراه Google برای Liftoff Monetize شامل متد GmaMediationLiftoffmonetize.setGDPRStatus() است. کد نمونه زیر نحوه انتقال اطلاعات رضایت به Vungle SDK را نشان می دهد. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK با آن تماس بگیرید.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
برای جزئیات بیشتر و مقادیر قابل ارائه در روش، دستورالعمل‌های اجرای توصیه‌شده GDPR را برای Android و iOS ببینید.
قوانین حفظ حریم خصوصی ایالات متحده
قوانین حفظ حریم خصوصی ایالات متحده مستلزم دادن حق انصراف کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف ارائه شده از طریق پیوند برجسته "اطلاعات شخصی من را نفروش" در "فروش" "صفحه اصلی حزب. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.
افزونه میانجیگری تبلیغات موبایل Google برای Liftoff Monetize شامل روش GmaMediationLiftoffmonetize.setCCPAStatus() است. کد نمونه زیر نحوه انتقال اطلاعات رضایت به Vungle SDK را نشان می دهد. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK با آن تماس بگیرید.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
برای جزئیات بیشتر و مقادیر قابل ارائه در روش، دستورالعمل‌های اجرای توصیه‌شده CCPA برای Android و iOS را ببینید.
مرحله 5: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی مورد نیاز نیست ادغام Liftoff Monetize.
iOS
ادغام SKAdNetwork
برای افزودن شناسه های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات Liftoff Monetize را دنبال کنید.
مرحله 6: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید و حالت آزمایشی را در رابط کاربری Liftoff Monetize فعال کرده اید .
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را از Liftoff Monetize دریافت می‌کنید، با استفاده از منبع(های) آگهی Liftoff Monetize (مناقصه) و Liftoff Monetize (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از Liftoff Monetize دریافت کند، ناشران می‌توانند با استفاده از ResponseInfo در کلاس‌های زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:
اندروید
| قالب | نام کلاس |
|---|---|
| باز کردن برنامه (مناقصه) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| برنامه باز (آبشار) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| بنر (مناقصه) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| بنر (آبشار) | com.vungle.mediation.VungleInterstitialAdapter |
| بینابینی (مناقصه) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| بینابینی (آبشار) | com.vungle.mediation.VungleInterstitialAdapter |
| پاداش داده شده (مناقصه) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| پاداش (آبشار) | com.vungle.mediation.VungleAdapter |
| بینابینی با پاداش (مناقصه) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| بینابینی با پاداش (آبشار) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
| قالب | نام کلاس |
|---|---|
| باز کردن برنامه (مناقصه) | GADMediationAdapterVungle |
| برنامه باز (آبشار) | GADMediationAdapterVungle |
| بنر (مناقصه) | GADMediationAdapterVungle |
| بنر (آبشار) | GADMAdapterVungleInterstitial |
| بینابینی (مناقصه) | GADMediationAdapterVungle |
| بینابینی (آبشار) | GADMAdapterVungleInterstitial |
| پاداش داده شده (مناقصه) | GADMediationAdapterVungle |
| پاداش (آبشار) | GADMAdapterVungleRewardBasedVideoAd |
| بینابینی با پاداش (مناقصه) | GADMediationAdapterVungle |
| بینابینی با پاداش (آبشار) | GADMediationAdapterVungle |
در اینجا کدها و پیام‌های همراهی که توسط آداپتور Liftoff Monetize پرتاب می‌شود، زمانی که آگهی بارگیری نمی‌شود، آمده است:
اندروید
| کد خطا | دلیل |
|---|---|
| 101 | پارامترهای سرور نامعتبر (مانند شناسه برنامه یا شناسه مکان). |
| 102 | اندازه بنر درخواستی با اندازه تبلیغ معتبر Liftoff Monetize مطابقت ندارد. |
| 103 | Liftoff Monetize به یک زمینه Activity برای درخواست تبلیغات نیاز دارد. |
| 104 | Vungle SDK نمی‌تواند چندین آگهی را برای شناسه مکان یکسان بارگیری کند. |
| 105 | Vungle SDK راه اندازی نشد. |
| 106 | Vungle SDK یک بار تماس با موفقیت را برگرداند، اما Banners.getBanner() یا Vungle.getNativeAd() null برگرداندند. |
| 107 | Vungle SDK برای پخش آگهی آماده نیست. |
| 108 | Vungle SDK کد پیشنهادی نامعتبر را برگرداند. |
iOS
| کد خطا | دلیل |
|---|---|
| 101 | پارامترهای سرور نامعتبر (مانند شناسه برنامه یا شناسه مکان). |
| 102 | یک آگهی قبلاً برای این پیکربندی شبکه بارگیری شده است. Vungle SDK نمی‌تواند آگهی دومی را برای همان شناسه مکان بارگیری کند. |
| 103 | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده Liftoff Monetize مطابقت ندارد. |
| 104 | Vungle SDK نتوانست آگهی بنر را ارائه دهد. |
| 105 | Vungle SDK تنها از بارگیری 1 آگهی بنر در یک زمان پشتیبانی می کند، صرف نظر از شناسه مکان. |
| 106 | Vungle SDK پاسخ تماسی ارسال کرد و گفت که تبلیغ قابل پخش نیست. |
| 107 | Vungle SDK برای پخش آگهی آماده نیست. |
برای خطاهای ناشی از Vungle SDK، به کدهای خطا مراجعه کنید: Vungle SDK برای iOS و Android .
لاگ تغییر آداپتور میانجی فلوتر Liftoff Monetize
نسخه بعدی
- ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.
نسخه 1.1.0
- سازگاری تأیید شده با آداپتور Liftoff Monetize Android نسخه 7.4.0.1
- سازگاری تأیید شده با آداپتور LiftoffMonetize iOS نسخه 7.4.0.1
- با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.
نسخه 1.0.0
- انتشار اولیه
- سازگاری تأیید شده با آداپتور Liftoff Monetize Android نسخه 7.3.1.0
- سازگاری تأیید شده با آداپتور LiftoffMonetize iOS نسخه 7.3.2.0
- با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.