ادغام تبلیغات Unity با واسطه

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

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

آداپتور میانجی AdMob برای Unity Ads دارای قابلیت‌های زیر است:

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

1 ادغام مناقصه در نسخه آزمایشی بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

الزامات

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

مرحله 1: تنظیمات را در رابط کاربری Unity Ads تنظیم کنید

ثبت نام کنید یا وارد Unity Ads شوید .

یک پروژه ایجاد کنید

در داشبورد Unity Ads ، به Projects بروید و روی Create Project کلیک کنید.

فرم را پر کنید و روی Create Project کلیک کنید تا پروژه خود را اضافه کنید.

به کسب درآمد > شروع به کار بروید، سپس روی شروع به کار کلیک کنید.

در حالت Project Setup ، I plan to use Mediation و Google Admob for Mediation Partner را انتخاب کنید، سپس روی Next کلیک کنید.

تنظیمات تبلیغات خود را انتخاب کنید، سپس روی Next کلیک کنید.

فرم را پر کنید، سپس روی افزودن پروژه کلیک کنید.

به شناسه بازی توجه کنید.

یک واحد تبلیغاتی ایجاد کنید

به کسب درآمد > واحدهای تبلیغاتی بروید، سپس روی افزودن واحد تبلیغات کلیک کنید.

نام واحد تبلیغات را وارد کنید، سپس پلتفرم و قالب تبلیغ خود را انتخاب کنید.

اندروید

iOS

در نهایت برای ذخیره واحد تبلیغاتی خود روی Create کلیک کنید.

یک مکان اضافه کنید

مناقصه

برای ایجاد مکان های مناقصه با مدیر حساب Google خود تماس بگیرید.

آبشار

پس از ایجاد پروژه، به مسیر کسب درآمد > مکان‌ها بروید. برای ایجاد یک مکان جدید، روی افزودن مکان برای واحد تبلیغات خود کلیک کنید.

جزئیات لازم را پر کنید و روی Add Placement کلیک کنید.

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

اندروید

iOS

کلید API گزارش Unity Ads را پیدا کنید

مناقصه

این مرحله برای ادغام پیشنهادها لازم نیست.

آبشار

علاوه بر شناسه بازی و شناسه مکان ، به کلید Unity Ads API و شناسه هسته سازمان نیز برای تنظیم شناسه واحد تبلیغات AdMob خود نیاز دارید.

به Monetization > Setup > API Management بروید و کلید دسترسی به API Stats را یادداشت کنید.

سپس، به کسب درآمد > تنظیمات سازمان بروید و شناسه اصلی سازمان را یادداشت کنید.

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

حالت تست را می توان از داشبورد Unity Ads فعال کرد. در زیر تنظیمات پروژه خود، تب Testing را انتخاب کنید.

می‌توانید با کلیک کردن روی دکمه ویرایش هر پلتفرم، گزینه Override test client و انتخاب Force test mode ON (یعنی استفاده از تبلیغات آزمایشی) برای همه دستگاه‌ها، حالت آزمایش را برای برنامه خود اجبار کنید.

اندروید

iOS

همچنین، می‌توانید حالت تست را برای دستگاه‌های خاص با کلیک کردن روی دکمه Add Test Device فعال کنید.

فرم را پر کنید و روی ذخیره کلیک کنید.

مرحله 2: درخواست Unity Ads را در رابط کاربری AdMob تنظیم کنید

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

اندروید

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

iOS

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

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

برای افزودن Unity Ads به فهرست شرکای آگهی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

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

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

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

dependencies:
  gma_mediation_unity: ^1.0.0

ادغام دستی

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

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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

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

افزونه میانجی‌گری تبلیغات موبایل Google برای Unity Ads شامل متد GmaMediationUnity.setGDPRConsent() است. کد نمونه زیر نحوه انتقال اطلاعات رضایت به Unity Ads SDK را نشان می دهد. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setGDPRConsent(true);

برای جزئیات بیشتر و مقادیری که می‌توان در هر روش ارائه کرد، به APIهای رضایت حریم خصوصی و داده‌های Unity Ads و پیروی از راهنمای GDPR مراجعه کنید.

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

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

افزونه میانجیگری تبلیغات موبایل Google برای Unity Ads شامل متد GmaMediationUnity.setCCPAConsent() است. کد نمونه زیر نحوه انتقال اطلاعات رضایت به Unity Ads SDK را نشان می دهد. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

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

اندروید

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

iOS

ادغام SKAdNetwork

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

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

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

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید و حالت تست را در رابط کاربری Unity Ads فعال کرده اید .

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

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

کدهای خطا

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

اندروید 

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

iOS 

GADMAdapterUnity
GADMediationAdapterUnity

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

اندروید

کد خطا دلیل
0-10 UnityAds SDK یک خطا برگرداند. برای جزئیات بیشتر به کد مراجعه کنید.
101 پارامترهای سرور UnityAds پیکربندی شده در رابط کاربری Admob گم شده/نامعتبر است.
102 UnityAds یک مکان با حالت NO_FILL برگرداند.
103 UnityAds یک مکان را با وضعیت DISABLED برگرداند.
104 UnityAds سعی کرد تبلیغی را با زمینه پوچ نشان دهد.
105 زمینه مورد استفاده برای مقداردهی اولیه، بارگیری و/یا نمایش تبلیغات از Unity Ads یک نمونه Activity نیست.
106 UnityAds سعی کرد تبلیغی را نشان دهد که برای نمایش آماده نیست.
107 UnityAds در دستگاه پشتیبانی نمی شود.
108 UnityAds می تواند تنها 1 تبلیغ را در هر مکان بارگیری کند.
109 UnityAds با یک وضعیت ERROR به پایان رسید.
200-204 بنر UnityAds یک خطای خاص. برای جزئیات بیشتر به کد مراجعه کنید.

iOS

0-9 UnityAds SDK یک خطا برگرداند. برای جزئیات بیشتر به مستندات Unity مراجعه کنید.
101 پارامترهای سرور UnityAds پیکربندی شده در رابط کاربری Admob گم شده/نامعتبر است.
102 دستگاه توسط UnityAds پشتیبانی نمی شود.
103 UnityAds با حالت خطا ارائه شد. kUnityAdsFinishStateError.
104 شیء تبلیغ Unity پس از فراخوانی اولیه ساز آن صفر می شود.
105 به دلیل آماده نبودن آگهی، تبلیغات Unity نمایش داده نشد.
106 UnityAds به نام یک مکان، پاسخ تماس را با وضعیت قرار دادن تغییر داد. kUnityAdsPlacementStateNoFill.
107 UnityAds به نام یک مکان، پاسخ تماس را با وضعیت قرار دادن تغییر داد. kUnityAdsPlacementStateDisabled.
108 قبلاً یک آگهی برای این مکان بارگیری شده است. UnityAds SDK از بارگیری تبلیغات چندگانه برای یک مکان پشتیبانی نمی کند.

Unity Ads Flutter Mediation Adapter Changelog

نسخه 1.1.0

  • سازگاری تایید شده با آداپتور اندروید Unity نسخه 4.12.3.0
  • سازگاری تایید شده با آداپتور Unity iOS نسخه 4.12.3.1
  • ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.

نسخه 1.0.0

  • انتشار اولیه
  • سازگاری تایید شده با آداپتور اندروید Unity نسخه 4.10.0.0
  • سازگاری تأیید شده با آداپتور Unity iOS نسخه 4.10.0.0
  • با افزونه Flutter Ads Google Mobile نسخه 5.0.0 ساخته و آزمایش شده است.