ادغام خط با واسطه (بتا)، ادغام خط با واسطه (بتا)

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

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

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

یکپارچه سازی
مناقصه
آبشار 1
فرمت ها
بنر
بینابینی
پاداش داده شد

1ادغام Waterfall در نسخه بتا بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

الزامات

  • یونیتی 4 یا بالاتر
  • جدیدترین SDK تبلیغات موبایل گوگل
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

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

وارد حساب لاین خود شوید .

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

کلیک کنید広告枠管理 (مدیریت جایگاه آگهی) >メディア (رسانه) . سپس، روی新規作成 (ایجاد جدید) کلیک کنید.

فرم را پر کنید و روی登録 (ثبت نام) کلیک کنید.

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

یک مکان تبلیغاتی ایجاد کنید

روی شناسه برنامه‌ای که می‌خواهید درج آگهی اضافه کنید کلیک کنید. سپس،詳細 (جزئیات) را انتخاب کنید.

رویスロット 追加 (افزودن شکاف) کلیک کنید.

فرم را پر کنید و پس از انجام، روی (登録) ثبت نام کلیک کنید.

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

مرحله 2: تقاضای خط را در آن تنظیم کنید Ad Manager UI

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

اندروید

برای دستورالعمل‌ها، به مرحله 2 در راهنمای Android مراجعه کنید.

iOS

برای دستورالعمل‌ها، مرحله 2 را در راهنمای iOS ببینید.

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

OpenUPM-CLI

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای دستور زیر از دایرکتوری ریشه پروژه خود، پلاگین میانجی‌گری خط تبلیغات Google Mobile را برای Unity در پروژه خود نصب کنید: 

openupm add com.google.ads.mobile.mediation.line

OpenUPM

در ویرایشگر پروژه Unity خود، Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.

در برگه Scoped Registries ، OpenUPM را به عنوان یک رجیستری محدوده با جزئیات زیر اضافه کنید:

  • نام: OpenUPM
  • آدرس اینترنتی: https://package.openupm.com
  • محدوده (ها): com.google

جزئیات OpenUPM

سپس به مسیر Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوی کشویی انتخاب کنید.

ثبت واحدها

بسته Google Mobile Ads Line Mediation را انتخاب کنید و روی Install کلیک کنید.

از OpenUPM نصب کنید

پکیج یونیتی

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

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

واردات از یونیتی

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

اجباری حل و فصل

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

اندروید

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

iOS

ادغام SKAdNetwork

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

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

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

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

دستورالعمل‌های موجود در اسناد Android و iOS لاین را در مورد نحوه فعال کردن تبلیغات آزمایشی Line دنبال کنید.

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

برای تأیید اینکه آگهی‌های آزمایشی را از Line دریافت می‌کنید، با استفاده از منبع(های) آگهی Line (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.

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

پارامترهای خاص شبکه

افزونه میانجی Line Unity از پارامتر درخواست اضافی زیر پشتیبانی می کند که می تواند از طریق کلاس LineMediationExtras به آداپتور ارسال شود:

  • SetEnableAdSound(boolean) : وضعیت شروع صدای پیش‌فرض آگهی‌های بنر، بینابینی و پاداش را مشخص می‌کند.

در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغاتی است که این پارامترها را تنظیم می کند: 

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

کدهای خطا

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

اندروید 

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

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

اندروید

کد خطا دامنه دلیل
1-10 com.five_corp.ad خط SDK یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات لاین مراجعه کنید.
101 com.google.ads.mediation.line شناسه برنامه موجود نیست یا نامعتبر است.
102 com.google.ads.mediation.line شناسه اسلات وجود ندارد یا نامعتبر است.
103 com.google.ads.mediation.line اندازه آگهی درخواستی با اندازه آگهی بنر پشتیبانی شده خط مطابقت ندارد.
104 com.google.ads.mediation.line به دلیل نداشتن زمینه فعالیت، یک آگهی بینابینی یا پاداش بارگیری نشد.
105 com.google.ads.mediation.line Line SDK نتوانست یک تبلیغ بینابینی یا دارای پاداش را نشان دهد.
106 com.google.ads.mediation.line به دلیل کمبود دارایی، آگهی بومی بارگیری نشد.

iOS

کد خطا دامنه دلیل
1-10 ارسال شده توسط Line SDK خط SDK یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات لاین مراجعه کنید.
101 com.google.ads.mediation.line پارامترهای سرور نامعتبر (به عنوان مثال شناسه برنامه یا شناسه شکاف از دست رفته).
102 com.google.ads.mediation.line اندازه آگهی درخواستی با اندازه آگهی بنر پشتیبانی شده خط مطابقت ندارد.
103 com.google.ads.mediation.line دارایی تصویر نماد اطلاعات در آگهی بومی بارگیری نشد.

لاین وحدت میانجی پلاگین تغییر

نسخه 1.4.0

نسخه 1.3.1

نسخه 1.3.0

نسخه 1.2.0

نسخه 1.1.2

نسخه 1.1.1

نسخه 1.1.0

نسخه 1.0.0