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

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

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

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

یکپارچه سازی
مناقصه	^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 بروید و روی New کلیک کنید.

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

به Unity Ads Monetization بروید، سپس روی شروع به کار کلیک کنید.

در مدال پروژه جدید ، I will use Mediation و Google Admob for Mediation Partner را انتخاب کنید، سپس روی Next کلیک کنید.

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

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

مناقصه آبشار

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

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

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

به Unity Ads Monetization > Placements بروید، سپس پروژه خود را انتخاب کنید و روی Add unit ad کلیک کنید.

توجه: اگر هنگام پیکربندی پروژه شما، Bidding برای تنظیم مکان انتخاب شده باشد، مجموعه ای از قرار دادن مناقصه برای همه قالب های تبلیغاتی پشتیبانی شده و پلت فرم های انتخابی به طور خودکار ایجاد می شود.

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

اندروید iOS

مناقصه آبشار

Bidding را برای راه اندازی انتخاب کنید. در قسمت Placement ، نام مکان را وارد کنید.

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

برای راه اندازی، آبشار را انتخاب کنید. در قسمت Placement ، نام مکان ، GEO Tagging و Target را وارد کنید.

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

در نهایت، روی افزودن واحد تبلیغات کلیک کنید تا واحد تبلیغات و مکان شما ذخیره شود.

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

مناقصه آبشار

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

به Unity Ads Monetization > مدیریت API بروید و کلید API را در دسترسی به API Stats در کسب درآمد یادداشت کنید.

سپس، به Unity Ads Monetization > Organization Settings بروید و شناسه اصلی سازمان را یادداشت کنید.

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

حالت تست را می توان از داشبورد Unity Ads فعال کرد. به Unity Ads Monetization > Testing بروید.

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

اندروید iOS

همچنین، می‌توانید با کلیک روی افزودن دستگاه آزمایشی، حالت آزمایش را برای دستگاه‌های خاص فعال کنید.

جزئیات دستگاه آزمایشی خود را وارد کنید، سپس روی ذخیره کلیک کنید.

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

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

اندروید iOS

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

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

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

مهم: بررسی کنید که مجوز مدیریت حساب برای تکمیل پیکربندی برای رضایت اتحادیه اروپا و GDPR، CPRA و پلت فرم پیام‌رسانی کاربر را دارید. برای جزئیات بیشتر به مدیریت دسترسی کاربر به حساب خود مراجعه کنید.

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

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

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

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

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

dependencies:
  gma_mediation_unity: ^1.2.0

ادغام دستی

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

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

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

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

تحت «خط‌مشی رضایت کاربر اتحادیه اروپا» 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: کد مورد نیاز را اضافه کنید

اندروید iOS

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

ادغام 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 در کلاس‌های زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:

اندروید iOS

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

GADMAdapterUnity
GADMediationAdapterUnity

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

اندروید iOS

کد خطا	دلیل
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 یک خطای خاص. برای جزئیات بیشتر به کد مراجعه کنید.

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.2.0

• از آداپتور یونیتی اندروید نسخه 4.13.0.0 پشتیبانی می کند.
• از آداپتور Unity iOS نسخه 4.12.5.0 پشتیبانی می کند.

• با افزونه Flutter تبلیغات موبایل Google نسخه 5.3.1 ساخته و آزمایش شده است.

نسخه 1.1.0

• از آداپتور یونیتی اندروید نسخه 4.12.3.0 پشتیبانی می کند.
• از آداپتور Unity iOS نسخه 4.12.3.1 پشتیبانی می کند.

• ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.

نسخه 1.0.0

• انتشار اولیه
• از آداپتور یونیتی اندروید نسخه 4.10.0.0 پشتیبانی می کند.
• از آداپتور Unity iOS نسخه 4.10.0.0 پشتیبانی می کند.

• با افزونه Flutter Ads Google Mobile نسخه 5.0.0 ساخته و آزمایش شده است.