Vungle را با میانجیگری ادغام کنید

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

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

ادغام
مناقصه 1
آبشار
فرمت ها
بنر 2
بینابینی
پاداش داده شد

1 ادغام مناقصه در بتا است.

تبلیغات بنری فقط برای واسطه گری آبشار پشتیبانی می شود. مناقصه در حال حاضر از تبلیغات بنری پشتیبانی نمی کند.

الزامات

  • یونیتی 4 یا بالاتر
  • آخرین Google Mobile Ads SDK [برای مناقصه]: افزونه میانجیگری تبلیغات تلفن همراه Google برای Vungle 3.8.2 یا بالاتر (آخرین نسخه توصیه می شود)
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 10.0 یا بالاتر
    • [برای مناقصه]: آداپتور Vungle 6.11.0.1 یا بالاتر (آخرین نسخه توصیه می شود)
  • یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.

محدودیت ها

  • Vungle از بارگیری چندین آگهی با استفاده از شناسه مرجع مکان پشتیبانی نمی‌کند.
    • اگر درخواست دیگری برای آن مکان در حال بارگیری یا در انتظار نمایش باشد، آداپتور Vungle به‌خوبی دومین درخواست را انجام نمی‌دهد.
  • Vungle فقط از بارگیری 1 بنر تبلیغاتی در یک زمان پشتیبانی می کند.
    • اگر یک آگهی بنری قبلاً بارگذاری شده باشد، آداپتور Vungle درخواست‌های بنر بعدی را به خوبی انجام نمی‌دهد.

مرحله 1: Vungle را تنظیم کنید

ثبت نام کنید یا به حساب Vungle خود وارد شوید .

با کلیک بر روی دکمه افزودن برنامه، برنامه خود را به داشبورد Vungle Applications اضافه کنید.

فرم را پر کنید و تمام جزئیات لازم را وارد کنید.

اندروید

iOS

پس از ایجاد برنامه، برنامه خود را از داشبورد Vungle Applications انتخاب کنید.

اندروید

iOS

به شناسه برنامه توجه داشته باشید.

اندروید

iOS

مکان های جدید اضافه کنید

برای ایجاد یک مکان جدید برای استفاده با میانجیگری AdMob، به داشبورد Vungle Placements بروید، روی دکمه افزودن مکان کلیک کنید و برنامه خود را از لیست کشویی انتخاب کنید.

جزئیات اضافه کردن مکان‌های جدید در زیر آمده است:

بنر را انتخاب کنید، نام محل مورد نظر خود را وارد کنید و بقیه فرم را پر کنید. [فقط آبشار] برای ایجاد مکان، روی دکمه ادامه در پایین صفحه کلیک کنید.

بنر 300x250

MREC را انتخاب کنید، نام محل مورد نظر خود را وارد کنید و بقیه فرم را پر کنید. [فقط آبشار] برای ایجاد مکان، روی دکمه ادامه در پایین صفحه کلیک کنید.

بینابینی

Interstitial را انتخاب کنید، نام محل مورد نظر خود را وارد کنید و بقیه فرم را پر کنید. [فقط آبشار] برای ایجاد مکان، روی دکمه ادامه در پایین صفحه کلیک کنید.

پاداش داده شد

Rewarded را انتخاب کنید، نام محل مورد نظر خود را وارد کنید و بقیه فرم را پر کنید. [فقط آبشار] برای ایجاد مکان، روی دکمه ادامه در پایین صفحه کلیک کنید.

نحوه کسب درآمد از موجودی خود را مشخص کنید

مناقصه

در بخش کسب درآمد، سوئیچ In-App Bidding را روی Enabled قرار دهید، سپس روی دکمه Continue کلیک کنید.

آبشار

بدون نیاز به مراحل اضافی

شناسه مرجع را یادداشت کنید و روی Sounds Good کلیک کنید.

بنر 300x250

بینابینی

پاداش داده شد

کلید API گزارش خود را پیدا کنید

مناقصه

این مرحله برای ادغام پیشنهادها لازم نیست.

آبشار

علاوه بر شناسه برنامه و شناسه مرجع ، برای تنظیم شناسه واحد تبلیغات AdMob خود به کلید API گزارش Vungle نیز نیاز دارید. به داشبورد Vungle Reports بروید و روی دکمه Reporting API Key کلیک کنید تا Reporting API Key خود را مشاهده کنید.

مرحله 2: واحد تبلیغات AdMob خود را پیکربندی کنید

باید Vungle را به پیکربندی میانجی برای واحدهای تبلیغات AdMob خود اضافه کنید. ابتدا وارد حساب AdMob خود شوید.

به تب Mediation بروید. اگر یک گروه میانجی موجود دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید، و به افزودن Vungle به عنوان منبع آگهی بروید.

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

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

اندروید

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

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

اکنون باید کارت واحدهای تبلیغاتی را که با واحدهای تبلیغاتی انتخاب کرده اید پر شده است، همانطور که در زیر نشان داده شده است:

iOS

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

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

اکنون باید کارت واحدهای تبلیغاتی را که با واحدهای تبلیغاتی انتخاب کرده اید پر شده است، همانطور که در زیر نشان داده شده است:

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

مناقصه

در زیر کارت مناقصه در بخش منابع آگهی ، افزودن منبع آگهی را انتخاب کنید. سپس Vungle را انتخاب کنید.

در مرحله بعد، شناسه برنامه و همچنین شناسه مرجع قرارگیری را که در قسمت قبل به دست آمده است وارد کنید و روی Done کلیک کنید.

در نهایت روی Save کلیک کنید.

آبشار

در کارت منابع آگهی ، افزودن شبکه تبلیغاتی را انتخاب کنید. Vungle را انتخاب کنید و سوئیچ Optimize را فعال کنید. برای Reporting API Key ، کلید Reporting API را که در بخش قبل به دست آمده است وارد کنید تا بهینه‌سازی منبع آگهی را برای Vungle تنظیم کنید. سپس یک مقدار eCPM برای Vungle وارد کنید و روی Continue کلیک کنید.

شناسه برنامه و شناسه مرجع قرارگیری را که در بخش قبل به دست آمده است وارد کنید. اگر از نسخه 4.x یا بالاتر Vungle SDK استفاده می‌کنید، شناسه مرجع قرار دادن می‌تواند خالی بماند.

اندروید

iOS

تبلیغات با پاداش

در تنظیمات واحد تبلیغات پاداش داده شده خود، کادر Apply to all networks in Mediation groups را علامت بزنید تا بدون توجه به اینکه کدام شبکه تبلیغاتی ارائه می شود، همان پاداش را به کاربر ارائه دهید.

اگر پاداش را لغو نکنید، آداپتور Vungle به طور پیش‌فرض پاداشی از نوع vungle با مقدار 1 را انتخاب می‌کند. Vungle SDK مقادیر پاداش خاصی را برای تبلیغات پاداش داده شده خود ارائه نمی کند.

برای اطلاعات بیشتر درباره تنظیم مقادیر پاداش برای واحدهای تبلیغاتی AdMob، به ایجاد واحد تبلیغات مراجعه کنید.

مرحله 3: Vungle SDK و آداپتور را وارد کنید

آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل برای Vungle را از لینک دانلود در Changelog دانلود کنید و GoogleMobileAdsVungleMediation.unitypackage از فایل فشرده استخراج کنید.

در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsVungleMediation.unitypackage را که دانلود کرده اید پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی Import کلیک کنید.

سپس، Assets > Play Services Resolver > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه Unity Play Services Resolver تفکیک وابستگی‌ها را از ابتدا انجام می‌دهد و وابستگی‌های اعلام‌شده را در فهرست Assets/Plugins/Android برنامه Unity شما کپی می‌کند.

مرحله 4: کد اضافی مورد نیاز است

هیچ کد اضافی برای ادغام Vungle مورد نیاز نیست.

مرحله 5: اجرای خود را آزمایش کنید

برای فعال کردن تبلیغات آزمایشی، به داشبورد Vungle خود بروید و به برنامه‌ها بروید.

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

اندروید

iOS

خودشه! اکنون یک ادغام میانجی کاری با Vungle دارید.

مراحل اختیاری

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

بخش زیر نحوه فعال یا غیرفعال کردن تبلیغات شخصی شده برای Vungle را به شما نشان می دهد.

افزونه میانجی‌گری تبلیغات موبایلی Google برای Vungle نسخه 3.9.2 شامل متد Vungle.UpdateConsentStatus() است که می‌توانید دو مقدار ممکن را ارسال کنید:

  • VungleConsentStatus.OPTED_IN
  • VungleConsentStatus.OPTED_OUT

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

using GoogleMobileAds.Api.Mediation.Vungle;
// ...

Vungle.UpdateConsentStatus(VungleConsentStatus.OPTED_IN);

برای جزئیات بیشتر به مقالات GDPR و حریم خصوصی Vungle مراجعه کنید.

Vungle را به لیست شرکای تبلیغاتی GDPR اضافه کنید

برای افزودن Vungle به لیست شرکای تبلیغاتی GDPR در رابط کاربری AdMob، مراحل تنظیمات GDPR را دنبال کنید.

CCPA

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

افزونه میانجیگری تبلیغات تلفن همراه Google برای Vungle نسخه 3.9.2 شامل متد Vungle.UpdateCCPAStatus() است که می توانید دو مقدار ممکن را ارسال کنید:

  • VungleCCPAStatus.OPTED_IN
  • VungleCCPAStatus.OPTED_OUT

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

using GoogleMobileAds.Api.Mediation.Vungle;
// ...

Vungle.UpdateCCPAStatus(VungleCCPAStatus.OPTED_IN);

برای جزئیات بیشتر به مقاله حریم خصوصی Vungle مراجعه کنید.

Vungle را به لیست شرکای تبلیغاتی CCPA اضافه کنید

برای افزودن Vungle به لیست شرکای تبلیغاتی CCPA در رابط کاربری AdMob، مراحل تنظیمات CCPA را دنبال کنید.

کدهای خطا

اگر آداپتور نتواند تبلیغی را از Vungle دریافت کند، ناشران می‌توانند با استفاده از ResponseInfo در کلاس‌های زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:

iOS

قالب نام کلاس
بنر GADMAdapterVungleInterstitial
بینابینی GADMAdapterVungleInterstitial
پاداش داده شد GADMAdapterVungleRewardBasedVideoAd

در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور Vungle هنگام بارگیری نشدن آگهی ارسال می‌شوند:

iOS

کد خطا دلیل
1-100 Vungle SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات مراجعه کنید.
101 پارامترهای سرور Vungle پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است.
102 یک آگهی قبلاً برای این پیکربندی شبکه بارگیری شده است. Vungle SDK نمی‌تواند آگهی دومی را برای همان شناسه مکان بارگیری کند.
103 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از Vungle مطابقت ندارد.
104 Vungle SDK نتوانست آگهی بنر را ارائه دهد.
105 Vungle SDK تنها از بارگیری 1 آگهی بنر در یک زمان پشتیبانی می کند، صرف نظر از شناسه مکان.
106 Vungle SDK پاسخ تماسی ارسال کرد و گفت که تبلیغ قابل پخش نیست.

Vungle Unity Mediation Plugin Changelog

نسخه 3.9.2

نسخه 3.9.1

نسخه 3.9.0

نسخه 3.8.2

نسخه 3.8.1

نسخه 3.8.0

نسخه 3.7.5

نسخه 3.7.4

نسخه 3.7.3

نسخه 3.7.2

نسخه 3.7.1

نسخه 3.7.0

نسخه 3.6.0

نسخه 3.5.1

نسخه 3.5.0

نسخه 3.4.1

نسخه 3.4.0

نسخه 3.3.1

نسخه 3.3.0

نسخه 3.2.0

نسخه 3.1.4

  • از آداپتور اندروید نسخه 6.3.24.1 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 6.3.2.3.

نسخه 3.1.3

  • از آداپتور اندروید نسخه 6.3.24.1 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 6.3.2.2.

نسخه 3.1.2

  • افزونه را برای پشتیبانی از API پاداشدهی بتا باز جدید به روز کرد.
  • از آداپتور اندروید نسخه 6.3.24.1 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 6.3.2.1.

نسخه 3.1.1

  • از آداپتور اندروید نسخه 6.3.24.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 6.3.2.0.
  • روش Vungle.UpdateConsentStatus() را برای اختیاری کردن پارامتر consentMessageVersion به روز کرد. اکنون مقدار consentMessageVersion برای iOS نادیده گرفته شده است.
  • Vungle.GetCurrentConsentMessageVersion() منسوخ شده برای iOS.

نسخه 3.1.0

  • از آداپتور اندروید نسخه 6.3.17.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 6.3.0.0.
  • متد Vungle.UpdateConsentStatus() را برای گرفتن یک پارامتر String اضافی برای نسخه پیام رضایت ارائه شده توسط ناشر به روز کرد.
  • روش Vungle.GetCurrentConsentMessageVersion() برای دریافت نسخه پیام رضایت ارائه شده توسط ناشر اضافه شد.

نسخه 3.0.1

  • از آداپتور اندروید نسخه 6.2.5.1 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 6.2.0.3.

نسخه 3.0.0

  • از آداپتور اندروید نسخه 6.2.5.0 پشتیبانی می کند.
  • پشتیبانی از آداپتور iOS نسخه 6.2.0.2.
  • روش های زیر را اضافه کرد:
    • روش Vungle.UpdateConsentStatus() برای تنظیم وضعیت رضایتی که در Vungle SDK ثبت خواهد شد.
    • روش Vungle.GetCurrentConsentStatus() برای دریافت وضعیت رضایت فعلی کاربر.

نسخه 2.0.0

  • پشتیبانی از آداپتور اندروید نسخه 5.3.2.1.
  • پشتیبانی از آداپتور iOS نسخه 6.2.0.0.

نسخه 1.1.0

  • پشتیبانی از آداپتور اندروید نسخه 5.3.2.1.
  • پشتیبانی از آداپتور iOS نسخه 5.4.0.0.

نسخه 1.0.0

  • اولین انتشار!
  • پشتیبانی از آداپتور اندروید نسخه 5.3.0.0.
  • پشتیبانی از آداپتور iOS نسخه 5.3.0.0.