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

پلتفرم مورد نظر را انتخاب کنید: اندروید (بتا) جدید-منتخب اندروید، iOS، یونیتی ، فلاتر

این راهنما به شما نشان می‌دهد که چگونه از GMA Next-Gen SDK برای بارگذاری و نمایش تبلیغات از myTarget با استفاده از AdMob Mediation استفاده کنید و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن myTarget به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام myTarget SDK و آداپتور آن در یک برنامه اندروید را پوشش می‌دهد.

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

آداپتور میانجیگری برای myTarget دارای قابلیت‌های زیر است:

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

الزامات

  • اندروید API سطح ۲۴ یا بالاتر

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

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

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

هنگام افزودن یک برنامه، 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

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

شما باید myTarget را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.

ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به مرحله بعد بروید و گزینه Add myTarget as an ad source را انتخاب کنید .

برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.

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

به گروه میانجیگری خود یک نام بدهید و مکان‌هایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کرده‌اید پر شده است:

myTarget را به عنوان منبع تبلیغات اضافه کنید


در زیر کارت Waterfall در بخش Ad Sources ، گزینه Add Ad Source را انتخاب کنید.

myTarget را انتخاب کنید و سوئیچ Optimize را فعال کنید. توکن دسترسی دائمی (Permanent Access Token) که در بخش قبل به دست آوردید را وارد کنید تا بهینه‌سازی منبع تبلیغات برای myTarget تنظیم شود. سپس یک مقدار eCPM برای myTarget وارد کنید و روی Continue کلیک کنید.



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

سپس، شناسه اسلات (Slot ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.

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

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

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

در فایل gradle سطح برنامه خود، وابستگی‌ها و پیکربندی‌های پیاده‌سازی زیر را اضافه کنید:

کاتلین 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:mytarget:5.27.4.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

گرووی 

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:mytarget:5.27.4.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

ادغام دستی

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

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

در SDK نسخه ۵.۱.۰، myTarget یک API برای رضایت کاربر اضافه کرد تا از الزامات حریم خصوصی پشتیبانی کند. نمونه کد زیر نحوه ارسال این اطلاعات رضایت به myTarget SDK را نشان می‌دهد. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق GMA Next-Gen SDK این کار را انجام دهید.

جاوا 

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

کاتلین 

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

علاوه بر این، اگر کاربر در دسته بندی سنی محدود قرار دارد، می‌توانید از کد زیر برای ارسال این اطلاعات رضایت به myTarget SDK استفاده کنید.

جاوا 

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

کاتلین 

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

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

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

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

در SDK نسخه ۵.۹.۰، myTarget یک API برای رضایت کاربر اضافه کرده است تا از الزامات حریم خصوصی پشتیبانی کند. نمونه کد زیر نحوه ارسال این اطلاعات رضایت به myTarget SDK را نشان می‌دهد. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق GMA Next-Gen SDK این کار را انجام دهید.

جاوا 

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

کاتلین 

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

برای اطلاعات بیشتر و مقادیری که می‌توان در متد ارائه داد، با پشتیبانی myTarget تماس بگیرید.

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

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

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

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

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

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

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

مراحل اختیاری

استفاده از تبلیغات بومی

رندرینگ آگهی

آداپتور myTarget تبلیغات بومی خود را به عنوان اشیاء NativeAd برمی‌گرداند. توضیحات فیلد تبلیغات بومی زیر را برای یک NativeAd پر می‌کند.

میدان پر شده توسط آداپتور myTarget
تیتر همیشه
تصویر همیشه
بدن همیشه
آیکون برنامه همیشه
فراخوان برای اقدام همیشه
رتبه‌بندی ستاره‌ای تضمین نشده
فروشگاه تضمین نشده
قیمت تضمین نشده
لوگو تضمین نشده
تبلیغ کننده همیشه

myTarget SDK همیشه برای عرض و ارتفاع mediaView 0 را برمی‌گرداند، بنابراین آداپتور myTarget همیشه برای getAspectRatio() 0 را برمی‌گرداند. myTarget SDK این مشکل را در نسخه‌های آینده برطرف خواهد کرد.

ردیابی نمایش و کلیک

GMA Next-Gen SDK از فراخوانی‌های myTarget SDK برای ردیابی نمایش و کلیک استفاده می‌کند، بنابراین گزارش‌های هر دو منبع باید با اختلاف کم یا بدون اختلاف مطابقت داشته باشند.

کدهای خطا

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

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

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

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