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

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

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

آداپتور میانجی Ad Manager برای 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 بروید و روی New کلیک کنید.

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

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

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

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

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

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

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

به Unity Ads Monetization > Placements بروید، سپس روی Add Unit ads کلیک کنید.

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

اندروید

iOS

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

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

اندروید

iOS

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

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

اندروید

iOS

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

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

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

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

اندروید

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

iOS

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

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

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

مرحله 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: اجرای خود را آزمایش کنید

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

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

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

برای تأیید اینکه آگهی‌های آزمایشی را از 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 ساخته و آزمایش شده است.