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

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

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

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

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

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

الزامات

• جدیدترین SDK تبلیغات موبایل گوگل
• فلاتر 3.7.0 یا بالاتر
• برای استقرار در اندروید
  • 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 را تنظیم کنید Ad Manager UI

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

اندروید

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

iOS

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

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

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

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

توجه: عدم ادغام نسخه‌های Unity Ads و Google Mobile Ads SDK ممکن است به مشکلات ساخت منجر شود.

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

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

dependencies:
  gma_mediation_unity: ^1.0.0

ادغام دستی

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

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

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

رضایت اتحادیه اروپا و GDPR

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

افزونه میانجی گری تبلیغات موبایل گوگل برای تبلیغات Unityشامل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 نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.

افزونه میانجی گری تبلیغات موبایل گوگل برای تبلیغات Unityشامل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 فعال کرده اید .

مهم: قبل از انتشار برنامه، حالت آزمایشی 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 ساخته و آزمایش شده است.