myTarget را با میانجیگری ادغام کنید

پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر

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

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

ادغام
مناقصه
آبشار
قالب‌ها
بنر
بینابینی
پاداش داده شده
تبلیغات بینابینی پاداش‌دار

الزامات

  • آخرین افزونه تبلیغات موبایلی گوگل برای یونیتی
  • یونیتی ۲۰۱۹.۴ یا بالاتر
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه یونیتی فعال که با افزونه یونیتی تبلیغات موبایلی گوگل پیکربندی شده است. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
  • راهنمای شروع میانجیگری را تکمیل کنید

مرحله ۱: تنظیمات را در رابط کاربری myTarget تنظیم کنید

وارد حساب کاربری myTarget خود شوید . با کلیک روی APPS در بالای صفحه، به صفحه برنامه‌ها بروید. با کلیک روی ADD APP، برنامه خود را اضافه کنید.

اگر برنامه شما از هر دو پلتفرم اندروید و iOS پشتیبانی می‌کند، باید هر کدام را جداگانه تنظیم کنید.

اندروید

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

آی‌او‌اس

در مرحله بعد، آدرس اینترنتی iTunes ** را برای برنامه خود وارد کنید.

هنگام افزودن یک برنامه، myTarget از شما می‌خواهد که قبل از تکمیل فرآیند، یک واحد تبلیغاتی ایجاد کنید.

از بین قالب‌های تبلیغاتی موجود، BANNER را انتخاب کنید و سپس روی دکمه‌ی ADD AD UNIT کلیک کنید.

بینابینی

از بین قالب‌های تبلیغاتی موجود، INTERSTITIAL را انتخاب کنید و سپس روی دکمه‌ی ADD AD UNIT کلیک کنید.

پاداش داده شده

از بین قالب‌های تبلیغاتی موجود، ویدیوی جایزه‌دار (REWARDED VIDEO) را انتخاب کنید و سپس روی دکمه‌ی «افزودن واحد تبلیغات» (ADD AD UNIT) کلیک کنید.

بومی

از بین قالب‌های تبلیغاتی موجود، NATIVE را انتخاب کنید و سپس روی ADD AD UNIT کلیک کنید.

در صفحه جزئیات واحد تبلیغاتی خود، شناسه اسلات خود را که می‌توانید در تنظیمات واحد تبلیغاتی با عنوان slot_id پیدا کنید، یادداشت کنید. این شناسه اسلات برای تنظیم واحد تبلیغاتی AdMob شما در بخش بعدی استفاده خواهد شد.

علاوه بر slot_id ، برای تنظیم شناسه واحد تبلیغاتی AdMob خود به توکن دسترسی دائمی myTarget خود نیز نیاز خواهید داشت. به برگه پروفایل بروید و توکن‌های دسترسی را انتخاب کنید. برای مشاهده توکن دسترسی دائمی myTarget خود، روی ایجاد توکن یا نمایش توکن کلیک کنید.

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .

برای پیاده‌سازی app-ads.txt برای myTarget، به نحوه ایجاد و انتشار یک فایل مراجعه کنید.

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

برای افزودن و پیکربندی یک دستگاه آزمایشی در رابط کاربری myTarget، دستورالعمل‌های موجود در مستندات myTarget را دنبال کنید.

مرحله ۲: تنظیم تقاضای myTarget در رابط کاربری AdMob

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

اندروید

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

آی‌او‌اس

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

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

برای افزودن Mail.ru به فهرست شرکای تبلیغاتی با مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.

مرحله ۳: وارد کردن SDK و آداپتور myTarget

رابط خط فرمان OpenUPM

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید افزونه‌ی Google Mobile Ads myTarget Mediation برای Unity را با اجرای دستور زیر از دایرکتوری ریشه‌ی پروژه، روی پروژه‌ی خود نصب کنید:

openupm add com.google.ads.mobile.mediation.mytarget

اوپن‌یو‌پی‌ام

در ویرایشگر پروژه یونیتی خود، گزینه Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.

در زیر تب Scoped Registries ، OpenUPM را به عنوان یک رجیستری Scoped با جزئیات زیر اضافه کنید:

  • نام: OpenUPM
  • آدرس اینترنتی: https://package.openupm.com
  • محدوده(ها): com.google

جزئیات OpenUPM

سپس، به مسیر Window > Package Manager بروید تا Unity Package Manager باز شود و از منوی کشویی، My Registrys را انتخاب کنید.

رجیستری‌های یونیتی

بسته Google Mobile Ads MyTarget Mediation را انتخاب کرده و روی نصب کلیک کنید.

نصب از OpenUPM

بسته یونیتی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای myTarget را از لینک دانلود موجود در Changelog دانلود کنید و GoogleMobileAdsMyTargetMediation.unitypackage را از فایل زیپ استخراج کنید.

در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsMyTargetMediation.unitypackage را که دانلود کرده‌اید، پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

وارد کردن از یونیتی

سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تجزیه و تحلیل وابستگی‌ها را از ابتدا انجام می‌دهد و وابستگی‌های اعلام شده را در پوشه Assets/Plugins/Android برنامه Unity شما کپی می‌کند.

عزم راسخ

مرحله ۴: تنظیمات حریم خصوصی را در myTarget SDK پیاده‌سازی کنید

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

افزونه میانجیگری تبلیغات موبایل گوگل برای myTarget نسخه ۲.۱.۰ شامل متدهای SetUserConsent() و SetUserAgeRestricted() است. نمونه کد زیر نحوه ارسال اطلاعات رضایت کاربر به myTarget SDK را نشان می‌دهد. اگر تصمیم به فراخوانی این متد دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق افزونه Unity تبلیغات موبایل گوگل، این کار را انجام دهید.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

اگر مشخص شده باشد که کاربر در یک دسته بندی با محدودیت سنی قرار دارد، می‌توانید متد SetUserAgeRestricted() را نیز فراخوانی کنید.

MyTarget.SetUserAgeRestricted(true);

برای اطلاعات بیشتر به راهنمای حریم خصوصی و GDPR سایت myTarget مراجعه کنید.

قوانین حفظ حریم خصوصی ایالت‌های آمریکا

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

افزونه میانجیگری تبلیغات موبایل گوگل برای myTarget نسخه ۳.۱۳.۳ شامل متد SetCCPAUserConsent(bool) است. نمونه کد زیر نحوه ارسال اطلاعات رضایت کاربر به myTarget SDK را نشان می‌دهد. اگر تصمیم به فراخوانی این متد دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق افزونه Unity تبلیغات موبایل گوگل، این کار را انجام دهید.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

برای اطلاعات بیشتر با پشتیبانی myTarget تماس بگیرید.

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

اندروید

برای ادغام myTarget هیچ کد اضافی لازم نیست.

آی‌او‌اس

ادغام شبکه SKAd

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات myTarget را دنبال کنید.

مرحله ۶: پیاده‌سازی خود را آزمایش کنید

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

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

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

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

کدهای خطا

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

اندروید 

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

آی‌او‌اس 

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

اندروید

کد خطا دلیل
۱۰۰ myTarget SDK خطایی را برگرداند.
۱۰۱ پارامترهای سرور myTarget که در رابط کاربری AdMob پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند.
۱۰۲ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط myTarget مطابقت ندارد.
۱۰۳ درخواست تبلیغ، یک درخواست تبلیغ بومی یکپارچه نیست.
۱۰۴ تبلیغ بومی بارگذاری شده از myTarget با تبلیغ بومی درخواستی متفاوت است.
۱۰۵ تبلیغ بومی بارگذاری شده از myTarget فاقد برخی از ویژگی‌های مورد نیاز (مثلاً تصویر یا آیکون) است.

آی‌او‌اس

کد خطا دلیل
۱۰۰ هنوز تبلیغی برای myTarget SDK در دسترس نیست.
۱۰۱ پارامترهای سرور myTarget که در رابط کاربری AdMob پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند.
۱۰۲ آداپتور myTarget از قالب تبلیغ درخواستی پشتیبانی نمی‌کند.
۱۰۳ سعی کردم یک تبلیغ myTarget نمایش دهم که بارگیری نشد.
۱۰۴ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط myTarget مطابقت ندارد.
۱۰۵ فقدان محتوای تبلیغاتی بومی مورد نیاز.

تغییرات افزونه میانجیگری myTarget Unity

نسخه ۳.۳۱.۰

نسخه ۳.۳۰.۱

نسخه ۳.۳۰.۰

نسخه ۳.۲۹.۰

نسخه ۳.۲۸.۰

نسخه ۳.۲۷.۱

نسخه ۳.۲۷.۰

نسخه ۳.۲۶.۰

نسخه ۳.۲۵.۰

نسخه ۳.۲۴.۰

نسخه ۳.۲۳.۰

نسخه ۳.۲۲.۰

نسخه ۳.۲۱.۱

نسخه ۳.۲۱.۰

نسخه ۳.۲۰.۰

نسخه ۳.۱۹.۰

نسخه ۳.۱۸.۲

نسخه ۳.۱۸.۱

نسخه ۳.۱۸.۰

نسخه ۳.۱۷.۱

نسخه ۳.۱۷.۰

نسخه ۳.۱۶.۲

نسخه ۳.۱۶.۱

نسخه ۳.۱۶.۰

نسخه ۳.۱۵.۰

نسخه ۳.۱۴.۰

نسخه ۳.۱۳.۲

نسخه ۳.۱۳.۱

نسخه ۳.۱۳.۰

نسخه ۳.۱۲.۰

نسخه ۳.۱۱.۴

نسخه ۳.۱۱.۳

نسخه ۳.۱۱.۲

نسخه ۳.۱۱.۱

نسخه ۳.۱۱.۰

نسخه ۳.۱۰.۲

نسخه ۳.۱۰.۱

نسخه ۳.۱۰.۰

نسخه ۳.۹.۰

نسخه ۳.۸.۲

نسخه ۳.۸.۱

نسخه ۳.۸.۰

نسخه ۳.۷.۰

نسخه ۳.۶.۱

نسخه ۳.۶.۰

نسخه ۳.۵.۲

نسخه ۳.۵.۱

نسخه ۳.۵.۰

نسخه ۳.۴.۰

نسخه ۳.۳.۰

نسخه ۳.۲.۰

نسخه ۳.۱.۰

نسخه ۳.۰.۰

  • افزونه برای پشتیبانی از API پاداش‌دهی بتای باز جدید به‌روزرسانی شد.
  • از آداپتور اندروید myTarget نسخه ۵.۳.۹.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۵.۰.۴.۰ برای myTarget پشتیبانی می‌کند.

نسخه ۲.۳.۲

  • از آداپتور اندروید myTarget نسخه ۵.۲.۵.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۴.۸.۹.۰ برای myTarget پشتیبانی می‌کند.

نسخه ۲.۳.۱

  • از آداپتور اندروید myTarget نسخه ۵.۲.۵.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۴.۸.۵.۰ برای myTarget پشتیبانی می‌کند.

نسخه ۲.۳.۰

  • از آداپتور اندروید myTarget نسخه ۵.۲.۲.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۴.۸.۰.۰ برای myTarget پشتیبانی می‌کند.

نسخه ۲.۲.۰

  • از آداپتور اندروید myTarget نسخه ۵.۱.۴.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۴.۸.۰.۰ برای myTarget پشتیبانی می‌کند.

نسخه ۲.۱.۲

  • از آداپتور اندروید myTarget نسخه ۵.۱.۳.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۴.۷.۱۱.۰ برای myTarget پشتیبانی می‌کند.

نسخه ۲.۱.۱

  • از آداپتور اندروید myTarget نسخه ۵.۱.۱.۰ پشتیبانی می‌کند.
  • از آداپتور iOS نسخه ۴.۷.۱۰.۰ برای myTarget پشتیبانی می‌کند.

نسخه ۲.۱.۰

  • از نسخه ۵.۱.۰ کیت توسعه نرم‌افزار اندروید myTarget پشتیبانی می‌کند.
  • از نسخه ۴.۷.۹ کیت توسعه نرم‌افزاری iOS برای myTarget پشتیبانی می‌کند.
  • متدهای زیر اضافه شد:
    • متد MyTarget.SetUserConsent() برای ارسال وضعیت رضایت کاربر به MyTarget SDK.
    • متد MyTarget.SetUserAgeRestricted که یک پرچم (flag) تنظیم می‌کند تا نشان دهد که آیا کاربر در یک دسته بندی با محدودیت سنی (یعنی زیر ۱۶ سال) قرار دارد یا خیر.
    • متد MyTarget.IsUserConsent() برای دریافت وضعیت رضایت فعلی کاربر.
    • از متد MyTarget.IsUserAgeRestricted() برای دریافت پرچمی که نشان می‌دهد کاربر در یک دسته سنی محدود (یعنی زیر ۱۶ سال) قرار دارد، استفاده کنید.

نسخه ۲.۰.۱

  • از نسخه ۵.۰.۲ کیت توسعه نرم‌افزار اندروید myTarget پشتیبانی می‌کند.
  • از نسخه ۴.۷.۸ کیت توسعه نرم‌افزاری iOS برای myTarget پشتیبانی می‌کند.

نسخه ۲.۰.۰

  • از نسخه ۵.۰.۰ کیت توسعه نرم‌افزار اندروید myTarget پشتیبانی می‌کند.
  • از نسخه ۴.۷.۷ کیت توسعه نرم‌افزاری iOS برای myTarget پشتیبانی می‌کند.

نسخه ۱.۱.۰

  • از نسخه ۴.۷.۲ کیت توسعه نرم‌افزار اندروید myTarget پشتیبانی می‌کند.
  • از نسخه ۴.۷.۶ کیت توسعه نرم‌افزاری iOS برای myTarget پشتیبانی می‌کند.

نسخه ۱.۰.۰

  • اولین انتشار!
  • از نسخه ۴.۶.۲۷ کیت توسعه نرم‌افزار اندروید myTarget پشتیبانی می‌کند.
  • از کیت توسعه نرم‌افزاری iOS نسخه ۴.۶.۲۴ برای myTarget پشتیبانی می‌کند.