این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Mintegral با استفاده از AdMob Mediation استفاده کنید، که هم ادغامهای آبشار و هم پیشنهاد قیمت را پوشش میدهد. نحوه افزودن Mintegral به پیکربندی میانجی واحد تبلیغاتی و نحوه ادغام Mintegral SDK و آداپتور در یک برنامه iOS را پوشش میدهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای Mintegral دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | |
آبشار | |
فرمت ها | |
برنامه باز شود | 1 |
بنر | |
بینابینی | |
پاداش داده شد | |
بینابینی پاداش | |
بومی | 2 |
2 ادغام مناقصه و آبشار برای قالب تبلیغات بومی در بتا باز هستند.
الزامات
هدف استقرار 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 خود را پیدا کنید
مناقصه
این مرحله برای ادغام پیشنهادها لازم نیست.
آبشار
برای تنظیم شناسه واحد تبلیغات AdMob خود به کلید API گزارش Mintegral نیاز دارید. به Account > API Tools بروید. از آسمان و راز خود یادداشت کنید.
مرحله 2: تقاضای Mintegral را در رابط کاربری AdMob تنظیم کنید
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
باید Mintegral را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.
ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر یک گروه میانجی موجود دارید که میخواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید، و به افزودن Mintegral به عنوان منبع آگهی بروید.
برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.
قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.
به گروه میانجی خود یک نام بدهید و مکانهایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.
این گروه میانجی را با یک یا چند واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.
اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کردهاید مشاهده کنید:
Mintegral را به عنوان منبع تبلیغاتی اضافه کنید
مناقصه
در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس Mintegral را انتخاب کنید.
روی نحوه امضای قرارداد مشارکت و تنظیم یک مشارکت در مناقصه با Mintegral کلیک کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر قبلاً نقشه ای برای Mintegral دارید، می توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
سپس کلید برنامه ، شناسه برنامه ، شناسه مکان و شناسه واحد آگهی را که در بخش قبل به دست آمدهاند وارد کنید. سپس روی Done کلیک کنید.
آبشار
در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس Mintegral را انتخاب کنید.
Mintegral را انتخاب کنید. سپس یک مقدار eCPM برای Mintegral وارد کنید و روی Continue کلیک کنید.
اگر قبلاً نقشه ای برای Mintegral دارید، می توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.
سپس کلید برنامه ، شناسه برنامه ، شناسه مکان و شناسه واحد آگهی را که در بخش قبل به دست آمدهاند وارد کنید. سپس روی Done کلیک کنید.
Mobvista/Mintegral را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید
برای افزودن Mobvista/Mintegral به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات 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: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.
Mintegral برای دریافت آگهیهای آزمایشی Mintegral برای بنرها، قالبهای تبلیغاتی با پاداش و بومی، توصیه میکند از کلیدهای برنامه، شناسههای برنامه، شناسههای مکان و شناسههای واحد آگهی ارائه شده در صفحه شناسه آزمون Mintegral استفاده کنید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را از Mintegral دریافت میکنید، با استفاده از منبع(های) آگهی Mintegral (مناقصه) و Mintegral (آبشار) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
مراحل اختیاری
Mintegral را به لیست شرکای تبلیغاتی CCPA اضافه کنید
برای افزودن Mintegral به لیست شرکای تبلیغاتی CCPA در رابط کاربری AdMob، مراحل موجود در تنظیمات 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.