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

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

این راهنما به شما نشان می‌دهد که چگونه از GMA Next-Gen SDK برای بارگذاری و نمایش تبلیغات از Verve HyBid SDK با استفاده از میانجیگری که ادغام‌های پیشنهاد قیمت را پوشش می‌دهد، استفاده کنید. این راهنما نحوه اضافه کردن Verve HyBid SDK به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام Verve HyBid SDK و آداپتور آن در یک برنامه اندروید را پوشش می‌دهد.

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

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

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

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

پیش‌نیازها

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

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

• آخرین نسخه GMA Next-Gen SDK .

• میانجیگری را تنظیم کنید .

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

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

مرحله ۲: تنظیم درخواست Verve HyBid SDK در رابط کاربری Ad Manager

وارد حساب مدیر تبلیغات خود شوید.

فعال کردن اشتراک‌گذاری امن سیگنال

به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.

سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید

به Inventory > Secure Signals بروید. در زیر Secure signals ، Verve HyBid SDK را جستجو کنید و گزینه Enable app integration را فعال کنید.

روی ذخیره کلیک کنید.

امکان اشتراک‌گذاری امن سیگنال برای مناقصه SDK

به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیش‌فرض ، گزینه «اجازه اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.

روی ذخیره کلیک کنید.

پیکربندی پیشنهاد قیمت Verve HyBid SDK

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

روی پیشنهاددهنده جدید کلیک کنید.

گروه Verve را به عنوان پیشنهاد دهنده انتخاب کنید.

برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.

روی انجام شد کلیک کنید.

پیکربندی نگاشت واحد تبلیغات

به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

شرکت Verve HyBid SDK را انتخاب کنید.

به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.

واحد تبلیغاتی خاص (Specific ad unit) را انتخاب کنید. یک واحد تبلیغاتی و قالب آن، برنامه موبایل (Mobile app) را به عنوان نوع موجودی (Inventory type ) و برنامه موبایل خود را انتخاب کنید. سپس، Zone ID و AppToken به دست آمده در بخش قبل را وارد کنید.

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

در نهایت، روی ذخیره کلیک کنید.

مهم: واحد تبلیغاتی انتخاب شده را حداقل با یک گروه بازده هدف قرار دهید.

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

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

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

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

توجه: عدم ادغام نسخه‌های سازگار Verve HyBid SDK و GMA Next-Gen SDK ممکن است منجر به مشکلات ساخت شود.

ادغام با اندروید استودیو (توصیه می‌شود)

در فایل 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.3.1")
    implementation("com.google.ads.mediation:verve:3.9.1.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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

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

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

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

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

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

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

جاوا

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);
VerveMediationSnippets.java

کاتلین

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)
VerveMediationSnippets.kt

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

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

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

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

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

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

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

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

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

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

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

کدهای خطا

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

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.