ادغام Verve HyBid SDK با AdMob Mediation

پلتفرم مورد نظر: اندروید، iOS، اندروید (قدیمی)

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

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

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

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

^۱- یکپارچه‌سازی پیشنهاد قیمت در مرحله‌ی آلفا است. برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

پیش‌نیازها

قبل از ادامه، موارد زیر را بررسی کنید:

• هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.

• آخرین نسخه Google Mobile Ads SDK .

• میانجیگری AdMob را راه‌اندازی کنید .

مرحله ۱: تنظیمات را در رابط کاربری Verve HyBid SDK انجام دهید

برای تنظیمات پیکربندی، با Verve تماس بگیرید .

مرحله ۲: تنظیم تقاضای Verve HyBid SDK در رابط کاربری AdMob

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

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

ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به مرحله بعد بروید: افزودن Verve HyBid SDK به عنوان منبع تبلیغات .

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

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

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

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

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

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

در قسمت «منابع تبلیغات» ، زیر کارت پیشنهاد قیمت ، گزینه «افزودن منبع تبلیغات» را انتخاب کنید. سپس «Verve HyBid SDK» را انتخاب کنید.

روی نحوه امضای قرارداد مشارکت و تنظیم مشارکت در مناقصه با Verve HyBid SDK کلیک کنید.



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



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



در مرحله بعد، Zone ID و AppToken به دست آمده در بخش قبل را وارد کنید. سپس روی Done کلیک کنید.

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

مهم: تأیید کنید که مجوز مدیریت حساب را برای تکمیل پیکربندی مربوط به رضایت اتحادیه اروپا و GDPR، مقررات ایالتی ایالات متحده و پلتفرم پیام‌رسانی کاربر دارید. برای جزئیات بیشتر به مدیریت دسترسی کاربر به حساب خود مراجعه کنید.

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

مرحله ۳: کیت توسعه نرم‌افزاری و آداپتور Verve HyBid را وارد کنید

توجه: عدم ادغام نسخه‌های سازگار Verve HyBid SDK و Google Mobile Ads SDK ممکن است منجر به مشکلات ساخت شود.

استفاده از مدیر بسته Swift

قبل از ادامه، باید حداقل نسخه آداپتور پشتیبانی شده ۳.۸.۰.۰ را داشته باشید.

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

1. در Xcode، به مسیر File > Add Package Dependencies... بروید.

2. در اعلانی که ظاهر می‌شود، آدرس بسته‌ی زیر را جستجو کنید:

   https://github.com/googleads/googleads-mobile-ios-mediation-verve.git
   

3. در بخش «قانون وابستگی» ، شاخه (Branch) را انتخاب کنید.

4. در فیلد متن، main را وارد کنید.

از کوکوپادز استفاده کنید

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

  pod 'GoogleMobileAdsMediationVerve'
  

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

  pod install --repo-update

ادغام دستی

• آخرین نسخه Verve iOS SDK را دانلود کنید و VerveSDK.framework را به پروژه خود لینک دهید.

• آخرین نسخه آداپتور Verve را از لینک دانلود موجود در Changelog دانلود کنید و VerveAdapter.framework را در پروژه خود لینک دهید.

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

  • AdSupport
  • AVFoundation
  • CoreGraphics
  • CoreMedia
  • CoreTelephony
  • StoreKit
  • SystemConfiguration
  • UIKit
  • WebKit
  • libz.tbd

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

رضایت اتحادیه اروپا و GDPR

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

کیت توسعه نرم‌افزار Verve HyBid به طور خودکار رضایت‌نامه GDPR تنظیم‌شده توسط پلتفرم‌های مدیریت رضایت‌نامه از جمله UMP SDK را می‌خواند. برای اطلاعات بیشتر، به انطباق با GDPR TCF مراجعه کنید.

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

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

Verve HyBid SDK از طریق یک روش از تنظیمات حریم خصوصی پشتیبانی می‌کند. کد نمونه زیر این اطلاعات رضایت را به Verve HyBid SDK ارسال می‌کند. اگر اطلاعات رضایت را به صورت دستی به Verve HyBid SDK ارسال می‌کنید، توصیه می‌کنیم قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK ، نمونه را فراخوانی کنید.

سویفت

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)
VerveMediationSwiftSnippets.swift

usPrivacyString با رشته‌ی حریم خصوصی ایالات متحده‌ی خود جایگزین کنید.

هدف-سی

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];
VerveMediationObjectiveCSnippets.m

kUSPrivacyString با رشته‌ی حریم خصوصی آمریکایی خود جایگزین کنید.

برای جزئیات بیشتر، به مستندات حریم خصوصی Verve HyBid SDK در مورد انطباق با CCPA مراجعه کنید.

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

پیاده‌سازی SKAdNetwork

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات Verve HyBid SDK را دنبال کنید.

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

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

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

مهم: قبل از انتشار برنامه، حالت آزمایشی را برای AdMob و Verve HyBid SDK غیرفعال کنید.

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

برای تأیید اینکه تبلیغات آزمایشی را از Verve HyBid SDK دریافت می‌کنید، با استفاده از منبع(های ) تبلیغاتی Verve (Bidding )، آزمایش منبع تبلیغاتی واحد را در ad inspector فعال کنید.

برای پیکربندی‌های بیشتر، مستندات Verve HyBid SDK را دنبال کنید.

کدهای خطا

اگر آداپتور نتواند تبلیغی از Verve HyBid SDK دریافت کند، ناشران می‌توانند خطای اساسی را از پاسخ تبلیغ با استفاده از GADResponseInfo.adNetworkInfoArray تحت کلاس‌های زیر بررسی کنند:

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

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

کد خطا	دلیل
۱۰۰ تا ۱۰۶	Verve HyBid SDK خطایی را برگرداند.
۱۰۱	توکن برنامه موجود نیست.
۱۰۲	کاربر کودک است.
۱۰۳	Verve HyBid SDK در مقداردهی اولیه ناموفق بود.
۱۰۴	پیکربندی تبلیغات نامعتبر است.
۱۰۵	اندازه بنر پشتیبانی نشده.
۱۰۶	آگهی تمام صفحه برای ارائه آماده نیست.
۱۱۵	شناسه واحد تبلیغ وجود ندارد. نمی‌توان تبلیغ را بارگیری کرد.
۱۱۶	آگهی آماده نیست. نمی‌توان آگهی را نمایش داد.

تغییرات آداپتور Verve iOS Mediation

نسخه ۳.۹.۰.۰

• حداقل نسخه کیت توسعه نرم‌افزاری iOS برای تبلیغات موبایلی گوگل به 13.3 به‌روزرسانی شد تا نسخه‌های فرعی (minor) قابل استفاده باشند.
• سازگاری تأیید شده با HyBid SDK نسخه 3.9.0.

ساخته و آزمایش شده با:

• نسخه ۱۳.۶.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۹.۰ کیت توسعه نرم‌افزار HyBid.

نسخه ۳.۸.۱.۱

• درخواست‌های دارای محدودیت سنی برای Verve SDK را زمانی فیلتر کنید که ageRestrictedTreatment جدید روی GADAgeRestrictedTreatmentChild تنظیم شده باشد.

ساخته و آزمایش شده با:

• نسخه ۱۳.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۸.۱ کیت توسعه نرم‌افزار HyBid.

نسخه ۳.۸.۱.۰

• سازگاری تأیید شده با HyBid SDK نسخه ۳.۸.۱.

ساخته و آزمایش شده با:

• نسخه ۱۳.۴.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۸.۱ کیت توسعه نرم‌افزار HyBid.

نسخه ۳.۸.۰.۰

• بررسی اندازه بنر از آداپتور حذف شد تا مشکلات جمع‌آوری سیگنال و بارگذاری تبلیغات برطرف شود.
• سازگاری تأیید شده با HyBid SDK نسخه ۳.۸.۰.

ساخته و آزمایش شده با:

• نسخه ۱۳.۲.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۸.۰ کیت توسعه نرم‌افزار HyBid.

نسخه ۳.۷.۱.۳

• وابستگی SDK تبلیغات موبایل گوگل به نسخه ۱۳.۰.۰ به‌روزرسانی شد.

ساخته و آزمایش شده با:

• نسخه ۱۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۷.۱ کیت توسعه نرم‌افزار HyBid.

نسخه ۳.۷.۱.۲

• حداقل نسخه iOS برنامه CocoaPods به 13.0 به‌روزرسانی شد.

ساخته و آزمایش شده با:

• نسخه ۱۳.۰.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۷.۱ کیت توسعه نرم‌افزار HyBid.

نسخه ۳.۷.۱.۱

• انتشار اولیه!
• از قالب‌های تبلیغات بنری، بینابینی، پاداشی، بینابینی پاداشی و بومی پشتیبانی می‌کند.
• سازگاری تأیید شده با HyBid SDK نسخه ۳.۷.۱.

ساخته و آزمایش شده با:

• نسخه ۱۲.۱۳.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۳.۷.۱ کیت توسعه نرم‌افزار HyBid.