ادغام Verve HyBid SDK با میانجیگری

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

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

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

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

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

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

پیش‌نیازها

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

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

مرحله ۱: تنظیمات را در رابط کاربری 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 و ایالت ایالات متحده اضافه کنید

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

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

در فایل settings.gradle.kts در سطح پروژه، مخازن زیر را اضافه کنید:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://verve.jfrog.io/artifactory/verve-gradle-release")
    }
  }
}

سپس، در فایل build.gradle.kts سطح برنامه خود، وابستگی‌ها و پیکربندی‌های پیاده‌سازی زیر را اضافه کنید. از آخرین نسخه‌های Verve HyBid SDK و آداپتور آن استفاده کنید:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:verve:3.9.1.0")
}

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

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

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

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

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

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

جاوا 

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);

کاتلین 

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)

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

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

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

برای یکپارچه‌سازی Verve HyBid SDK نیازی به کد اضافی نیست.

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

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

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

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

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

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

کدهای خطا

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

net.pubnative.lite.sdk
com.google.ads.mediation.verve

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

کد خطا دلیل
۱۰۰ تا ۱۰۳ Verve HyBid SDK خطایی را برگرداند.
۱۰۱ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط Verve HyBid SDK مطابقت ندارد.
۱۰۲ توکن برنامه موجود نیست یا خالی است.
۱۰۳ زمینه تهی است.

لیست تغییرات آداپتور میانجیگری اندروید Verve

نسخه ۳.۹.۱.۰

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

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

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

نسخه ۳.۹.۰.۰

  • درخواست‌های دارای محدودیت سنی برای Verve SDK را زمانی فیلتر کنید که AgeRestrictedTreatment جدید روی CHILD تنظیم شده باشد.
  • سازگاری تأیید شده با Verve HyBid SDK نسخه ۳.۹.۰.

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

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

نسخه ۳.۸.۲.۰

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

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

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

نسخه ۳.۸.۱.۱

  • نماهای قابل کلیک را فیلتر کنید تا کلیک روی اطلاعات محتوا از کلیک روی تبلیغ معمولی برای VerveNativeAd متمایز شود.

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

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

نسخه ۳.۸.۱.۰

  • ویژگی برای ساخت آداپتور با وابستگی به GMA Next-Gen SDK اضافه شد.
  • سازگاری تأیید شده با Verve HyBid SDK نسخه ۳.۸.۱.

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

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

نسخه ۳.۷.۱.۱

  • بررسی اندازه بنر از آداپتور Verve حذف شد تا مشکلات جمع‌آوری سیگنال برطرف شود.

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

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

نسخه ۳.۷.۱.۰

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

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

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