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

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

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

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

الزامات

  • یونیتی 4 یا بالاتر
  • جدیدترین SDK تبلیغات موبایل گوگل
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در myTarget UI تنظیم کنید

ابتدا ثبت نام کنید یا وارد حساب کاربری myTarget خود شوید . با کلیک بر روی APPS در هدر، به صفحه برنامه ها بروید. با کلیک کردن روی افزودن برنامه، برنامه خود را اضافه کنید.

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

اندروید

سپس، URL Google Play را برای برنامه خود ارائه دهید.

iOS

سپس، URL iTunes ** را برای برنامه خود ارائه دهید.

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

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

بینابینی

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

پاداش داده شد

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

بومی

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

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

علاوه بر slot_id ، برای تنظیم شناسه واحد تبلیغات AdMob خود به رمز دسترسی دائم myTarget نیز نیاز دارید. به تب Profile بروید و Access Tokens را انتخاب کنید. برای مشاهده رمز دسترسی دائم myTarget خود، روی Create Token یا Show Token کلیک کنید.

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

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

مرحله 2: تقاضای myTarget را در آن تنظیم کنید Ad Manager UI

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

اندروید

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

جزئیات OpenUPM

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

ثبت واحدها

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

از 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 شما کپی می کند.

اجباری حل و فصل

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

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

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

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

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

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

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

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

MyTarget.SetCCPAUserConsent(true);

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

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

اندروید

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

iOS

ادغام SKAdNetwork

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

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

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

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

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

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

کدهای خطا

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

اندروید 

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

iOS 

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

اندروید

کد خطا دلیل
100 myTarget SDK یک خطا برگرداند.
101 پارامترهای سرور myTarget پیکربندی شده در Ad Manager رابط کاربری موجود نیست/نامعتبر است.
102 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط myTarget مطابقت ندارد.
103 درخواست آگهی یک درخواست تبلیغ بومی یکپارچه نیست.
104 آگهی بومی بارگیری شده از myTarget با آگهی بومی درخواستی متفاوت است.
105 آگهی بومی بارگیری شده از myTarget برخی از دارایی های مورد نیاز (مانند تصویر یا نماد) را ندارد.

iOS

کد خطا دلیل
100 myTarget SDK هنوز تبلیغی در دسترس ندارد.
101 پارامترهای سرور myTarget پیکربندی شده در Ad Manager رابط کاربری موجود نیست/نامعتبر است.
102 آداپتور myTarget از قالب آگهی درخواستی پشتیبانی نمی کند.
103 سعی کردم یک تبلیغ myTarget را نشان دهم که بارگذاری نشده است.
104 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط myTarget مطابقت ندارد.
105 دارایی‌های تبلیغاتی بومی مورد نیاز وجود ندارد.

MyTarget Unity Mediation Plugin Changelog

نسخه 3.20.0

نسخه 3.19.0

نسخه 3.18.2

نسخه 3.18.1

نسخه 3.18.0

نسخه 3.17.1

نسخه 3.17.0

نسخه 3.16.2

نسخه 3.16.1

نسخه 3.16.0

نسخه 3.15.0

نسخه 3.14.0

نسخه 3.13.2

نسخه 3.13.1

نسخه 3.13.0

نسخه 3.12.0

نسخه 3.11.4

نسخه 3.11.3

نسخه 3.11.2

نسخه 3.11.1

نسخه 3.11.0

نسخه 3.10.2

نسخه 3.10.1

نسخه 3.10.0

نسخه 3.9.0

نسخه 3.8.2

نسخه 3.8.1

نسخه 3.8.0

نسخه 3.7.0

نسخه 3.6.1

نسخه 3.6.0

نسخه 3.5.2

نسخه 3.5.1

نسخه 3.5.0

نسخه 3.4.0

نسخه 3.3.0

نسخه 3.2.0

نسخه 3.1.0

نسخه 3.0.0

  • افزونه را برای پشتیبانی از API پاداشدهی بتا باز جدید به روز کرد.
  • از آداپتور اندروید myTarget نسخه 5.3.9.0 پشتیبانی می کند.
  • از آداپتور iOS myTarget نسخه 5.0.4.0 پشتیبانی می کند.

نسخه 2.3.2

  • از آداپتور اندروید myTarget نسخه 5.2.5.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS myTarget نسخه 4.8.9.0.

نسخه 2.3.1

  • از آداپتور اندروید myTarget نسخه 5.2.5.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS myTarget نسخه 4.8.5.0.

نسخه 2.3.0

  • از آداپتور اندروید myTarget نسخه 5.2.2.0 پشتیبانی می کند.
  • از آداپتور iOS myTarget نسخه 4.8.0.0 پشتیبانی می کند.

نسخه 2.2.0

  • از آداپتور اندروید myTarget نسخه 5.1.4.0 پشتیبانی می کند.
  • از آداپتور iOS myTarget نسخه 4.8.0.0 پشتیبانی می کند.

نسخه 2.1.2

  • از آداپتور اندروید myTarget نسخه 5.1.3.0 پشتیبانی می کند.
  • از آداپتور iOS myTarget نسخه 4.7.11.0 پشتیبانی می کند.

نسخه 2.1.1

  • از آداپتور اندروید myTarget نسخه 5.1.1.0 پشتیبانی می کند.
  • از آداپتور iOS myTarget نسخه 4.7.10.0 پشتیبانی می کند.

نسخه 2.1.0

  • پشتیبانی از myTarget Android SDK نسخه 5.1.0.
  • پشتیبانی از myTarget iOS SDK نسخه 4.7.9.
  • روش های زیر را اضافه کرد:
    • روش MyTarget.SetUserConsent() برای ارسال وضعیت رضایت کاربر به MyTarget SDK.
    • روش MyTarget.SetUserAgeRestricted که پرچمی را برای نشان دادن اینکه آیا کاربر در یک دسته محدود سنی شناخته شده است (یعنی زیر 16 سال) تنظیم می کند.
    • روش MyTarget.IsUserConsent() برای دریافت وضعیت رضایت فعلی کاربر.
    • متد MyTarget.IsUserAgeRestricted() برای دریافت پرچمی که نشان می دهد کاربر در یک دسته بندی با محدودیت سنی شناخته شده است (یعنی زیر 16 سال).

نسخه 2.0.1

  • پشتیبانی از myTarget Android SDK نسخه 5.0.2.
  • پشتیبانی از myTarget iOS SDK نسخه 4.7.8.

نسخه 2.0.0

  • پشتیبانی از myTarget Android SDK نسخه 5.0.0.
  • پشتیبانی از myTarget iOS SDK نسخه 4.7.7.

نسخه 1.1.0

  • پشتیبانی از myTarget Android SDK نسخه 4.7.2.
  • پشتیبانی از myTarget iOS SDK نسخه 4.7.6.

نسخه 1.0.0

  • اولین انتشار!
  • پشتیبانی از myTarget Android SDK نسخه 4.6.27.
  • پشتیبانی از myTarget iOS SDK نسخه 4.6.24.