این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Mintegral با استفاده از میانجیگری استفاده کنید، که هم ادغام آبشار و هم پیشنهاد قیمت را پوشش میدهد. نحوه افزودن Mintegral به پیکربندی میانجی واحد تبلیغاتی و نحوه ادغام Mintegral SDK و آداپتور در یک برنامه iOS را پوشش میدهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای Mintegral دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | 1 |
آبشار | 2 |
فرمت ها | |
برنامه باز شود | |
بنر | |
بینابینی | |
پاداش داده شد | |
بینابینی پاداش | |
بومی |
2 ادغام Waterfall در نسخه بتا بسته است.
الزامات
هدف استقرار iOS 11.0 یا بالاتر
[برای مناقصه]: برای ادغام همه قالبهای تبلیغاتی پشتیبانی شده در مناقصه، از آداپتور Mintegral 7.5.3.0 یا بالاتر ( آخرین نسخه توصیه میشود ) استفاده کنید.
جدیدترین SDK تبلیغات موبایل گوگل
راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در Mintegral UI تنظیم کنید
ثبت نام کنید یا به حساب Mintegral خود وارد شوید .
کلید برنامه را پیدا کنید
به برگه تنظیمات برنامه بروید و کلید APP را یادداشت کنید.
یک برنامه جدید اضافه کنید
از تب APP Setting ، روی دکمه Add APP کلیک کنید.
پلتفرم را انتخاب کنید و بقیه فرم را پر کنید. سپس روی ذخیره کلیک کنید.
به شناسه APP برنامه خود توجه داشته باشید.
یک مکان تبلیغاتی ایجاد کنید
هنگامی که برنامه شما ایجاد شد، به برگه Placements & Units بروید و مطابق شکل زیر بر روی دکمه Add Placement کلیک کنید تا محل تبلیغات خود را ایجاد کنید.
نام مکان و قالب آگهی را وارد کنید.
Header Bidding را به عنوان نوع مناقصه انتخاب کنید. بقیه فرم را پر کنید و روی ذخیره کلیک کنید.
پس از ایجاد آگهی شما، شناسه قرار دادن را یادداشت کنید.
روی منوی کشویی 1 AD Units کلیک کنید و شناسه واحد AD را یادداشت کنید.
کلید API گزارش Mintegral خود را پیدا کنید
مناقصه
این مرحله برای ادغام پیشنهادها لازم نیست.
آبشار
برای تنظیم شناسه واحد تبلیغات Ad Manager خود به کلید API گزارش Mintegral نیاز دارید. به Account > API Tools بروید. از آسمان و راز خود یادداشت کنید.
مرحله 2: تقاضای Mintegral را در رابط کاربری Ad Manager تنظیم کنید
به حساب Ad Manager خود وارد شوید.
اضافه کردن Mintegral در شرکت ها
مناقصه
این مرحله برای ادغام پیشنهادها لازم نیست.
آبشار
به Admin > Companies بروید، سپس روی دکمه New company در تب All companys کلیک کنید. شبکه تبلیغات را انتخاب کنید.
Mintegral را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید.
شما نیازی به وارد کردن نام کاربری یا رمز عبور ندارید. پس از اتمام روی ذخیره کلیک کنید.
اشتراک گذاری سیگنال ایمن را فعال کنید
مناقصه
به Admin > تنظیمات جهانی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراکگذاری ایمن سیگنال را بررسی کرده و آن را تغییر دهید. روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغام آبشار لازم نیست.
مناقصه Mintegral را پیکربندی کنید
مناقصه
به Delivery > Bidders بروید و روی New bidder در زیر برگه SDK Bidding کلیک کنید.
Mintegral را به عنوان پیشنهاد دهنده انتخاب کنید.
روی افزودن کتابخانه سیگنال این مناقصهدهنده به فهرست سیگنالهای مجاز و اجازه اشتراکگذاری سیگنالها با این پیشنهاد دهنده را تغییر دهید. سپس، روی Continue کلیک کنید.
روی Continue کلیک کنید.
روی Done کلیک کنید.
آبشار
این مرحله برای ادغام آبشار لازم نیست.
پیکربندی نقشه واحد تبلیغات
مناقصه
به Delivery > Bidders بروید و شرکت Mintegral را در برگه SDK Bidding انتخاب کنید.
به برگه نگاشت واحد آگهی بروید و روی نقشه واحد آگهی جدید کلیک کنید.
واحد تبلیغات خاص را انتخاب کنید. یک واحد تبلیغات و قالب، برنامه موبایل را به عنوان نوع موجودی ، و برنامه تلفن همراه خود را انتخاب کنید. سپس کلید برنامه ، شناسه برنامه ، شناسه مکان و شناسه واحد آگهی را که در بخش قبل به دست آمدهاید، وارد کنید. در نهایت روی Save کلیک کنید.
آبشار
به مسیر Delivery > Yield Groups بروید و روی دکمه گروه بازده جدید کلیک کنید. برنامه موبایل خود را انتخاب کنید.
به پایین بروید و روی افزودن شریک بازده کلیک کنید.
شرکتی را که برای Mintegral ایجاد کردید در قسمت قبل انتخاب کنید. میانجی SDK موبایل را به عنوان نوع یکپارچه سازی ، iOS را به عنوان پلتفرم و Active را به عنوان وضعیت انتخاب کنید.
کلید برنامه ، شناسه برنامه ، شناسه مکان و شناسه واحد آگهی را که در بخش قبل به دست آمدهاید و مقدار پیشفرض CPM را وارد کنید. روی ذخیره کلیک کنید.
Mobvista/Mintegral را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید
برای افزودن Mobvista/Mintegral به فهرست شرکای آگهی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری Ad Manager، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.
مرحله 3: Mintegral SDK و آداپتور را وارد کنید
استفاده از CocoaPods (توصیه می شود)
خط زیر را به Podfile پروژه خود اضافه کنید:
pod 'GoogleMobileAdsMediationMintegral'
از خط فرمان اجرا کنید:
pod install --repo-update
ادغام دستی
- آخرین نسخه Mintegral SDK را برای iOS دانلود کنید و همه فایلها و بستههای
.framework
را در پروژه خود پیوند دهید. - آخرین نسخه آداپتور Mintegral را از لینک دانلود در Changelog دانلود کنید و
MintegralAdapter.xcframework
در پروژه خود پیوند دهید.
مرحله 4: تنظیمات حریم خصوصی را در Mintegral SDK اجرا کنید
رضایت اتحادیه اروپا و GDPR
تحت «خطمشی رضایت کاربر اتحادیه اروپا» Google، باید اطمینان حاصل کنید که اطلاعات مشخصی در رابطه با استفاده از شناسههای دستگاه و دادههای شخصی به کاربران منطقه اقتصادی اروپا (EEA) داده میشود و از آنها رضایت گرفته میشود. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. هنگام درخواست رضایت، باید هر شبکه تبلیغاتی را در زنجیره میانجی خود شناسایی کنید که ممکن است دادههای شخصی را جمعآوری، دریافت یا استفاده کند و اطلاعاتی درباره استفاده هر شبکه ارائه دهد. Google در حال حاضر نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.
Mintegral SDK شامل روش setConsentStatus
برای ارسال اطلاعات رضایت به Mintegral SDK است.
کد نمونه زیر نحوه ارسال اطلاعات رضایت به Mintegral SDK را نشان می دهد. این گزینهها باید قبل از راهاندازی SDK تبلیغات تلفن همراه Google تنظیم شوند تا مطمئن شوید که به درستی به Mintegral SDK بازارسال میشوند.
سویفت
import MTGSDK
// ...
MTGSDK.sharedInstance().setConsentStatus(true)
هدف-C
#import <MTGSDK/MTGSDK.h>
// ...
[[MTGSDK sharedInstance] setConsentStatus:YES];
برای اطلاعات بیشتر به اسناد حریم خصوصی Mintegral مراجعه کنید.
قوانین حفظ حریم خصوصی ایالات متحده
قوانین حفظ حریم خصوصی ایالات ایالات متحده مستلزم اعطای حق انصراف به کاربران از «فروش» «اطلاعات شخصی» خود (همانطور که قانون آن شرایط را تعریف میکند)، با انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروخت» ارائه میکند. در صفحه اصلی حزب "فروش". راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکههای تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنماییهای هر یک از آن شبکهها برای اطمینان از رعایت آن پیروی کنید.
Mintegral SDK شامل متد setDoNotTrackStatus
برای ارسال اطلاعات رضایت به Mintegral SDK است.
کد نمونه زیر نحوه ارسال اطلاعات رضایت به Mintegral SDK را نشان می دهد. اگر میخواهید این روش را فراخوانی کنید، قبل از راهاندازی SDK تبلیغات تلفن همراه Google با آن تماس بگیرید تا مطمئن شوید که به درستی به SDK Mintegral بازارسال میشوند.
سویفت
import MTGSDK
// ...
MTGSDK.sharedInstance().setDoNotTrackStatus(false)
هدف-C
#import <MTGSDK/MTGSDK.h>
// ...
[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];
برای اطلاعات بیشتر به مستندات حریم خصوصی Mintegral مراجعه کنید.
مرحله 5: کد مورد نیاز را اضافه کنید
ادغام SKAdNetwork
مستندات Mintegral را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist
پروژه خود اضافه کنید.
مرحله 6: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید.
Mintegral برای دریافت آگهیهای آزمایشی Mintegral برای بنرها، قالبهای تبلیغاتی با پاداش و بومی، توصیه میکند از کلیدهای برنامه، شناسههای برنامه، شناسههای مکان و شناسههای واحد آگهی ارائه شده در صفحه شناسه آزمون Mintegral استفاده کنید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را از Mintegral دریافت میکنید، با استفاده از منبع(های) آگهی Mintegral (مناقصه) و Mintegral (آبشار) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
مراحل اختیاری
Mintegral را به لیست شرکای تبلیغاتی CCPA اضافه کنید
برای افزودن Mintegral به لیست شرکای تبلیغاتی CCPA در رابط کاربری Ad Manager مراحل را در تنظیمات CCPA دنبال کنید.
تبلیغات بومی
رندر آگهی
آداپتور Mintegral تبلیغات بومی خود را به عنوان اشیاء GADNativeAd
برمی گرداند. فیلدهای زیر را برای GADNativeAd
پر می کند.
میدان | دارایی ها همیشه توسط آداپتور Mintegral گنجانده شده است |
---|---|
تیتر | |
تصویر | 1 |
بدن | |
نماد | |
فراخوان به اقدام | |
امتیاز ستاره | |
فروشگاه | |
قیمت | |
تبلیغ کننده |
1 آداپتور Mintegral دسترسی مستقیم به دارایی تصویر اصلی را برای تبلیغات بومی خود فراهم نمی کند. در عوض، آداپتور GADMediaView
را با یک ویدیو یا یک تصویر پر می کند.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از Mintegral دریافت کند، میتوانید با استفاده از GADResponseInfo.adNetworkInfoArray
در کلاسهای زیر، خطای اساسی مربوط به پاسخ آگهی را بررسی کنید:
GADMediationAdapterMintegral
در اینجا کدها و پیامهای همراهی هستند که توسط آداپتور Mintegral هنگام بارگیری نشدن آگهی ارسال میشوند:
کد خطا | دامنه | دلیل |
---|---|---|
101 | com.google.mediation.mintegral | پارامترهای سرور نامعتبر (مثلاً شناسه برنامه یا شناسه مکان وجود ندارد). |
102 | com.google.mediation.mintegral | Mintegral SDK یک خطای عدم پر کردن را برگرداند. |
103 | com.google.mediation.mintegral | Mintegral SDK نتوانست تبلیغی را نشان دهد. |
104 | com.google.mediation.mintegral | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده Mintegral مطابقت ندارد. |
تغییرات آداپتور میانجی iOS Mintegral
نسخه 7.7.3.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.7.3.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.10.0.
- Mintegral SDK نسخه 7.7.3.
نسخه 7.7.2.1
- آداپتور دیگر بررسی نمیکند که آیا آگهیهای بینابینی و پاداشدار قبل از نمایش آماده هستند یا خیر.
-
CFBundleShortVersionString
بهروزرسانی کرد تا به جای چهار مؤلفه، سه مؤلفه داشته باشد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.10.0.
- Mintegral SDK نسخه 7.7.2.
نسخه 7.7.2.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.7.2.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.9.0.
- Mintegral SDK نسخه 7.7.2.
نسخه 7.7.1.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.7.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.8.0.
- Mintegral SDK نسخه 7.7.1.
نسخه 7.7.0.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.7.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.8.0.
- Mintegral SDK نسخه 7.7.0.
نسخه 7.6.9.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.6.9.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.7.0.
- Mintegral SDK نسخه 7.6.9.
نسخه 7.6.8.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.6.8.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.7.0.
- Mintegral SDK نسخه 7.6.8.
نسخه 7.6.7.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.6.7.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.6.0.
- Mintegral SDK نسخه 7.6.7.
نسخه 7.6.6.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.6.6.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.5.0.
- Mintegral SDK نسخه 7.6.6.
نسخه 7.6.4.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.6.4.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.4.0.
- Mintegral SDK نسخه 7.6.4.
نسخه 7.6.3.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.6.3.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.3.0.
- Mintegral SDK نسخه 7.6.3.
نسخه 7.6.2.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.6.2.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.3.0.
- Mintegral SDK نسخه 7.6.2.
نسخه 7.6.1.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.6.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.3.0.
- Mintegral SDK نسخه 7.6.1.
نسخه 7.6.0.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.6.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.2.0.
- Mintegral SDK نسخه 7.6.0.
نسخه 7.5.9.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.5.9.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.2.0.
- Mintegral SDK نسخه 7.5.9.
نسخه 7.5.8.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.5.8.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.1.0.
- Mintegral SDK نسخه 7.5.8.
نسخه 7.5.7.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.5.7.
- اکنون به حداقل نسخه iOS 12.0 نیاز دارد.
- اکنون به Google Mobile Ads SDK نسخه 11.0 یا بالاتر نیاز دارد.
- شامل
Info.plist
در چارچوب های موجود درMintegralAdapter.xcframework
.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.0.1.
- Mintegral SDK نسخه 7.5.7.
نسخه 7.5.6.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.5.6.
-
GADMediationAdapterMintegral.h
به عنوان یک هدر عمومی تبدیل کرد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.0.0.
- Mintegral SDK نسخه 7.5.6.
نسخه 7.5.3.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.5.3.
- پشتیبانی مناقصه برای قالب تبلیغات باز برنامه اضافه شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.14.0.
- Mintegral SDK نسخه 7.5.3.
نسخه 7.4.8.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.4.8.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.13.0.
- Mintegral SDK نسخه 7.4.8.
نسخه 7.4.7.0
- فایل podspec را بهروزرسانی کرد تا به جای
MintegralAdSDK
بهMintegralAdSDK/All
وابسته باشد. - سازگاری تایید شده با Mintegral SDK نسخه 7.4.7.
- پشتیبانی از آبشار برای قالب تبلیغات باز برنامه اضافه شده است.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.12.0.
- Mintegral SDK نسخه 7.4.7.
نسخه 7.4.4.0
- پشتیبانی از واترمارک برای تبلیغات مناقصه اضافه شده است.
- سازگاری تایید شده با Mintegral SDK نسخه 7.4.4.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.10.0.
- Mintegral SDK نسخه 7.4.4.
نسخه 7.4.3.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.4.3.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.9.0.
- Mintegral SDK نسخه 7.4.3.
نسخه 7.4.1.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.4.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.7.0.
- Mintegral SDK نسخه 7.4.1.
نسخه 7.3.9.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.3.9.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.7.0.
- Mintegral SDK نسخه 7.3.9.
نسخه 7.3.8.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.3.8.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.6.0.
- Mintegral SDK نسخه 7.3.8.
نسخه 7.3.7.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.3.7.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.5.0.
- Mintegral SDK نسخه 7.3.7.
نسخه 7.3.6.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.3.6.
- پشتیبانی از معماری
armv7
حذف شد. - اکنون به حداقل نسخه iOS 11.0 نیاز دارد.
- اکنون به Google Mobile Ads SDK نسخه 10.4.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.5.0.
- Mintegral SDK نسخه 7.3.6.
نسخه 7.3.4.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.3.4.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.2.0.
- Mintegral SDK نسخه 7.3.4.
نسخه 7.3.3.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.3.3.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.2.0.
- Mintegral SDK نسخه 7.3.3.
نسخه 7.3.0.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.3.0.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.1.0.
- Mintegral SDK نسخه 7.3.0.
نسخه 7.2.9.1
- پشتیبانی از آبشار برای بنر (شامل MREC)، فرمت های تبلیغاتی بینابینی، پاداش و بومی اضافه شده است.
- به Google Mobile Ads SDK نسخه 10.0.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.0.0.
- Mintegral SDK نسخه 7.2.9.
نسخه 7.2.9.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.2.9.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 9.14.0.
- Mintegral SDK نسخه 7.2.9.
نسخه 7.2.8.0
- سازگاری تایید شده با Mintegral SDK نسخه 7.2.8.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 9.14.0.
- Mintegral SDK نسخه 7.2.8.
نسخه 7.2.6.0
- انتشار اولیه!
- پشتیبانی مناقصه برای بنر (شامل MREC)، قالبهای تبلیغاتی بینابینی، پاداش و بومی اضافه شد.
- سازگاری تایید شده با Mintegral SDK نسخه 7.2.6.
- به Google Mobile Ads SDK نسخه 9.8.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 9.13.0.
- Mintegral SDK نسخه 7.2.6.