ادغام Mintegral با مناقصه (بتا)

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

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

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

یکپارچه سازی
مناقصه 1
آبشار 2
فرمت ها
برنامه باز شود
بنر
بینابینی
پاداش داده شد
بینابینی پاداش
بومی
1 ادغام مناقصه در نسخه بتای بسته است (به جز قالب تبلیغات بومی در بتای باز).

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 و آداپتور را وارد کنید

  • خط زیر را به Podfile پروژه خود اضافه کنید:

    pod 'GoogleMobileAdsMediationMintegral'

  • از خط فرمان اجرا کنید:

    pod install --repo-update

ادغام دستی

  • آخرین نسخه Mintegral SDK را برای iOS دانلود کنید و همه فایل‌ها و بسته‌های .framework را در پروژه خود پیوند دهید.
  • آخرین نسخه آداپتور Mintegral را از لینک دانلود در Changelog دانلود کنید و MintegralAdapter.xcframework در پروژه خود پیوند دهید.

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

تحت «خط‌مشی رضایت کاربر اتحادیه اروپا» 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.
،

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

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

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

یکپارچه سازی
مناقصه 1
آبشار 2
فرمت ها
برنامه باز شود
بنر
بینابینی
پاداش داده شد
بینابینی پاداش
بومی
1 ادغام مناقصه در نسخه بتای بسته است (به جز قالب تبلیغات بومی در بتای باز).

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 و آداپتور را وارد کنید

  • خط زیر را به Podfile پروژه خود اضافه کنید:

    pod 'GoogleMobileAdsMediationMintegral'

  • از خط فرمان اجرا کنید:

    pod install --repo-update

ادغام دستی

  • آخرین نسخه Mintegral SDK را برای iOS دانلود کنید و همه فایل‌ها و بسته‌های .framework را در پروژه خود پیوند دهید.
  • آخرین نسخه آداپتور Mintegral را از لینک دانلود در Changelog دانلود کنید و MintegralAdapter.xcframework در پروژه خود پیوند دهید.

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

تحت «خط‌مشی رضایت کاربر اتحادیه اروپا» 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.