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 یافت می‌شود. این شناسه شکاف برای راه‌اندازی واحد تبلیغات AdMob شما در بخش بعدی استفاده می‌شود.

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

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

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

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

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

اندروید

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

iOS

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

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

برای افزودن Mail.ru به لیست شرکای آگهی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات 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: اجرای خود را آزمایش کنید

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

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید و حالت آزمایشی را در 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 پیکربندی شده در رابط کاربری AdMob گم شده/نامعتبر است.
102 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط myTarget مطابقت ندارد.
103 درخواست آگهی یک درخواست تبلیغ بومی یکپارچه نیست.
104 آگهی بومی بارگیری شده از myTarget با آگهی بومی درخواستی متفاوت است.
105 آگهی بومی بارگیری شده از myTarget برخی از دارایی های مورد نیاز (مانند تصویر یا نماد) را ندارد.

iOS

کد خطا دلیل
100 myTarget SDK هنوز تبلیغی در دسترس ندارد.
101 پارامترهای سرور myTarget پیکربندی شده در رابط کاربری AdMob گم شده/نامعتبر است.
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 پشتیبانی می کند.
  • پشتیبانی از آداپتور myTarget iOS نسخه 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.
،

این راهنما به شما نشان می‌دهد که چگونه از 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 یافت می‌شود. این شناسه شکاف برای راه‌اندازی واحد تبلیغات AdMob شما در بخش بعدی استفاده می‌شود.

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

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

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

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

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

اندروید

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

iOS

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

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

برای افزودن Mail.ru به لیست شرکای آگهی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات 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: اجرای خود را آزمایش کنید

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

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید و حالت آزمایشی را در 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 پیکربندی شده در رابط کاربری AdMob گم شده/نامعتبر است.
102 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط myTarget مطابقت ندارد.
103 درخواست آگهی یک درخواست تبلیغ بومی یکپارچه نیست.
104 آگهی بومی بارگیری شده از myTarget با آگهی بومی درخواستی متفاوت است.
105 آگهی بومی بارگیری شده از myTarget برخی از دارایی های مورد نیاز (مانند تصویر یا نماد) را ندارد.

iOS

کد خطا دلیل
100 myTarget SDK هنوز تبلیغی در دسترس ندارد.
101 پارامترهای سرور myTarget پیکربندی شده در رابط کاربری AdMob گم شده/نامعتبر است.
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 پشتیبانی می کند.
  • پشتیبانی از آداپتور myTarget iOS نسخه 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.
،

این راهنما به شما نشان می‌دهد که چگونه از 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 یافت می‌شود. این شناسه شکاف برای راه‌اندازی واحد تبلیغات AdMob شما در بخش بعدی استفاده می‌شود.

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

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

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

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

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

اندروید

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

در ویرایشگر پروژه وحدت خود ، ویرایش > تنظیمات پروژه > مدیر بسته را انتخاب کنید تا تنظیمات مدیر بسته یونیتی را باز کنید.

در زیر برگه Scoped Registers ، OpenUpm را به عنوان یک رجیستری scoped با جزئیات زیر اضافه کنید:

  • نام: OpenUPM
  • URL: https://package.openupm.com
  • دامنه (ها): com.google

جزئیات OpenUpm

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

ثبت نام های وحدت

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

نصب از OpenUpm

پکیج یونیتی

آخرین نسخه افزونه Google Mobile Ads Vergin for MyTarget را از لینک بارگیری در ChangeLog بارگیری کرده و GoogleMobileAdsMyTargetMediation.unitypackage را از پرونده ZIP استخراج کنید.

در ویرایشگر پروژه وحدت خود ، دارایی ها > بسته وارد کردن > بسته سفارشی را انتخاب کنید و فایل GoogleMobileAdsMyTargetMediation.unitypackage را که بارگیری کرده اید پیدا کنید. اطمینان حاصل کنید که تمام پرونده ها انتخاب شده و روی واردات کلیک کنید.

واردات از وحدت

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

اراده نیرو

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

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

افزونه Google Mobile Ads Ads برای 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 Mobile Ads Ads برای 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

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

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

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

اطمینان حاصل کنید که دستگاه تست خود را برای ADMOB ثبت کرده و حالت تست را در UI MyTarget فعال کنید .

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

برای تأیید اینکه شما از MyTarget تبلیغات تست دریافت می کنید ، آزمایش منبع تبلیغاتی تک را در بازرس AD با استفاده از منبع (های ) تبلیغ MyTarget (آبشار ) فعال کنید.

کدهای خطا

اگر آداپتور نتواند آگهی از MyTarget دریافت کند ، ناشران می توانند خطای اساسی را از پاسخ AD با استفاده از 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 پیکربندی شده در UI ADMOB از دست رفته/نامعتبر هستند.
102 اندازه تبلیغات درخواست شده با اندازه بنر پشتیبانی شده MyTarget مطابقت ندارد.
103 درخواست تبلیغ یک درخواست آگهی بومی یکپارچه نیست.
104 آگهی بومی بارگذاری شده از MyTarget با آگهی بومی درخواست شده متفاوت است.
105 آگهی بومی بارگذاری شده از MyTarget برخی از دارایی های مورد نیاز (به عنوان مثال تصویر یا نماد) را از دست نمی دهد.

iOS

کد خطا دلیل
100 MyTarget SDK هنوز تبلیغی در دسترس ندارد.
101 پارامترهای سرور MyTarget پیکربندی شده در UI ADMOB از دست رفته/نامعتبر هستند.
102 آداپتور MyTarget از فرمت تبلیغاتی که درخواست می شود پشتیبانی نمی کند.
103 سعی کرد یک تبلیغ MyTarget را نشان دهد که بارگذاری نشده است.
104 اندازه تبلیغات درخواست شده با اندازه بنر پشتیبانی شده MyTarget مطابقت ندارد.
105 از دست رفته دارایی های تبلیغاتی بومی مورد نیاز.

افزونه Mytarget Unity 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 پاداش جدید با بتای باز به روز کرد.
  • از آداپتور Android MyTarget نسخه 5.3.9.0 پشتیبانی می کند.
  • از آداپتور iOS MyTarget نسخه 5.0.4.0 پشتیبانی می کند.

نسخه 2.3.2

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

نسخه 2.3.1

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

نسخه 2.3.0

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

نسخه 2.2.0

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

نسخه 2.1.2

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

نسخه 2.1.1

  • از آداپتور Android 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 پشتیبانی می کند.
،

این راهنما نحوه استفاده از Google Mobile Ads SDK را برای بارگیری و نمایش تبلیغات از MyTarget با استفاده از میانجی ، پوشش ادغام آبشار نشان می دهد. این شامل نحوه اضافه کردن MyTarget به پیکربندی واسطه ای واحد تبلیغاتی ، و نحوه ادغام SDK و آداپتور MyTarget در یک برنامه وحدت است.

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

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

الزامات

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

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

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

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

اندروید

در مرحله بعد ، URL Google Play را برای برنامه خود تهیه کنید.

iOS

بعد ، URL iTunes ** را برای برنامه خود تهیه کنید.

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

بنر را از قالب های تبلیغاتی موجود انتخاب کنید ، و سپس بر روی دکمه Add Ad Unit کلیک کنید.

بینابینی

از قالب های تبلیغاتی موجود بینابینی را انتخاب کرده و سپس بر روی دکمه Add Ad Unit کلیک کنید.

پاداش داده شد

ویدیوی پاداش را از قالب های تبلیغاتی موجود انتخاب کنید و سپس بر روی دکمه Add Ad Unit کلیک کنید.

بومی

از قالب های تبلیغاتی موجود ، Native را انتخاب کنید و سپس روی Add Ad Unit کلیک کنید.

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

علاوه بر SLAT_ID ، برای تنظیم شناسه واحد ADMOB AD UNIT خود به نشانه دسترسی دائمی MyTarget خود نیز نیاز خواهید داشت. به برگه پروفایل بروید و Access Tokens را انتخاب کنید. برای مشاهده نشانه دسترسی دائمی MyTarget خود ، روی ایجاد Token یا Show Token کلیک کنید.

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

دستورالعمل های موجود در مستندات MyTarget را دنبال کنید تا یک دستگاه تست در MyTarget UI اضافه و پیکربندی کنید.

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

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

اندروید

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

iOS

برای راهنمایی ، به مرحله 2 در راهنمای iOS مراجعه کنید.

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

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

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

Openupm-cli

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

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

اوپوم

در ویرایشگر پروژه وحدت خود ، ویرایش > تنظیمات پروژه > مدیر بسته را انتخاب کنید تا تنظیمات مدیر بسته یونیتی را باز کنید.

در زیر برگه Scoped Registers ، OpenUpm را به عنوان یک رجیستری scoped با جزئیات زیر اضافه کنید:

  • نام: OpenUPM
  • URL: https://package.openupm.com
  • دامنه (ها): com.google

جزئیات OpenUpm

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

ثبت نام های وحدت

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

نصب از OpenUpm

پکیج یونیتی

آخرین نسخه افزونه Google Mobile Ads Vergin for MyTarget را از لینک بارگیری در ChangeLog بارگیری کرده و GoogleMobileAdsMyTargetMediation.unitypackage را از پرونده ZIP استخراج کنید.

در ویرایشگر پروژه وحدت خود ، دارایی ها > بسته وارد کردن > بسته سفارشی را انتخاب کنید و فایل GoogleMobileAdsMyTargetMediation.unitypackage را که بارگیری کرده اید پیدا کنید. اطمینان حاصل کنید که تمام پرونده ها انتخاب شده و روی واردات کلیک کنید.

واردات از وحدت

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

اراده نیرو

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

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

افزونه Google Mobile Ads Ads برای 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 Mobile Ads Ads برای 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

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

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

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

اطمینان حاصل کنید که دستگاه تست خود را برای ADMOB ثبت کرده و حالت تست را در UI MyTarget فعال کنید .

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

برای تأیید اینکه شما از MyTarget تبلیغات تست دریافت می کنید ، آزمایش منبع تبلیغاتی تک را در بازرس AD با استفاده از منبع (های ) تبلیغ MyTarget (آبشار ) فعال کنید.

کدهای خطا

اگر آداپتور نتواند آگهی از MyTarget دریافت کند ، ناشران می توانند خطای اساسی را از پاسخ AD با استفاده از 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 پیکربندی شده در UI ADMOB از دست رفته/نامعتبر هستند.
102 اندازه تبلیغات درخواست شده با اندازه بنر پشتیبانی شده MyTarget مطابقت ندارد.
103 درخواست تبلیغ یک درخواست آگهی بومی یکپارچه نیست.
104 آگهی بومی بارگذاری شده از MyTarget با آگهی بومی درخواست شده متفاوت است.
105 آگهی بومی بارگذاری شده از MyTarget برخی از دارایی های مورد نیاز (به عنوان مثال تصویر یا نماد) را از دست نمی دهد.

iOS

کد خطا دلیل
100 MyTarget SDK هنوز تبلیغی در دسترس ندارد.
101 پارامترهای سرور MyTarget پیکربندی شده در UI ADMOB از دست رفته/نامعتبر هستند.
102 آداپتور MyTarget از فرمت تبلیغاتی که درخواست می شود پشتیبانی نمی کند.
103 سعی کرد یک تبلیغ MyTarget را نشان دهد که بارگذاری نشده است.
104 اندازه تبلیغات درخواست شده با اندازه بنر پشتیبانی شده MyTarget مطابقت ندارد.
105 از دست رفته دارایی های تبلیغاتی بومی مورد نیاز.

افزونه Mytarget Unity 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 پاداش جدید با بتای باز به روز کرد.
  • از آداپتور Android MyTarget نسخه 5.3.9.0 پشتیبانی می کند.
  • از آداپتور iOS MyTarget نسخه 5.0.4.0 پشتیبانی می کند.

نسخه 2.3.2

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

نسخه 2.3.1

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

نسخه 2.3.0

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

نسخه 2.2.0

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

نسخه 2.1.2

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

نسخه 2.1.1

  • از آداپتور Android 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 پشتیبانی می کند.