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

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

رابط داشبورد برای Line از متن ژاپنی برای برچسب‌ها، دکمه‌ها و توضیحات خود استفاده می‌کند. اسکرین شات های این راهنما ترجمه نشده اند. با این حال، در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی خود در پرانتز ترجمه شده‌اند.

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

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

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

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

الزامات

  • Android API سطح 21 یا بالاتر

  • جدیدترین SDK تبلیغات موبایل گوگل

  • راهنمای شروع میانجیگری را کامل کنید

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

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

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

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

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

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

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

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

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

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

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

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

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

به حساب Ad Manager خود وارد شوید.

به مسیر Delivery > Yield Groups بروید و روی دکمه گروه بازده جدید کلیک کنید.

یک نام منحصر به فرد برای گروه بازدهی خود وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب تبلیغات خود را انتخاب کنید و نوع موجودی را روی برنامه موبایل تنظیم کنید. در بخش Targeting > Inventory ، واحد تبلیغاتی را در برنامه Inventory and Mobile که می‌خواهید میانجیگری را به آن اضافه کنید، انتخاب کنید.

بعد، روی دکمه افزودن شریک عملکرد کلیک کنید.

اگر در حال حاضر یک شریک بازده برایLine، می توانید آن را انتخاب کنید. در غیر این صورت، Create a new yield partner را انتخاب کنید.

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

پس از انتخاب شریک Yield ، Mobile SDK Mediation را به عنوان نوع ادغام انتخاب کنید.Android به عنوان پلتفرم و فعال به عنوان وضعیت . را وارد کنیدApplication ID and Slot ID در بخش قبل به دست آمد. سپس، یک مقدار پیش فرض CPM را وارد کنید.

پس از اتمام روی ذخیره در پایین صفحه کلیک کنید.

مرحله 3: Line SDK و Adapter را وارد کنید

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:line:2.8.20240827.0")
}

ادغام دستی

  1. آخرین نسخه فایل .aar Line SDK را دانلود کنید و آن را به پروژه خود اضافه کنید.

  2. به آرتیفکت‌های آداپتور خط در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور Line را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

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

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

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

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

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

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

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

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

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

آداپتور Line از یک پارامتر درخواست اضافی پشتیبانی می کند که می تواند با استفاده از کلاس LineExtras به آداپتور ارسال شود. این سازنده کلاس شامل پارامترهای زیر است:

enableAdSound
یک boolean برای مشخص کردن وضعیت شروع صدای پیش‌فرض آگهی‌های تبلیغاتی، بینابینی و پاداش.

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

جاوا 

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

کاتلین 

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

استفاده از تبلیغات بومی

رندر آگهی

آداپتور Line موارد زیر را پر می کندزمینه هابرای یکNativeAd .

میدان دارایی ها همیشه توسط آداپتور خط گنجانده شده است
تیتر
تصویر
بدن
نماد برنامه 1
فراخوان به اقدام
امتیاز ستاره
فروشگاه
قیمت

1 برای تبلیغات بومی، Line SDK دارایی نماد برنامه را ارائه نمی دهد. در عوض، آداپتور Line نماد برنامه را با یک تصویر شفاف پر می کند.

کدهای خطا

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

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

در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور 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 به دلیل کمبود دارایی، آگهی بومی بارگیری نشد.

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

نسخه بعدی

  • AdLoader را برای فعال کردن RTB برای تبلیغات بنری پیاده سازی کرد.
  • AdLoader را برای فعال کردن RTB برای تبلیغات بینابینی پیاده سازی کرد.
  • AdLoader را برای فعال کردن RTB برای تبلیغات با پاداش پیاده‌سازی کرد.
  • AdLoader را برای فعال کردن RTB برای تبلیغات بومی پیاده‌سازی کرد.

نسخه 2.8.20240827.0

  • سازگاری تایید شده با FiveAd SDK نسخه 2.8.20240827.0

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.3.0.
  • FiveAd SDK نسخه 2.8.20240827.0

نسخه 2.8.20240808.0

  • سازگاری تایید شده با FiveAd SDK نسخه 2.8.20240808.0

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.2.0.
  • FiveAd SDK نسخه 2.8.20240808.0

نسخه 2.8.20240722.0

  • سازگاری تایید شده با FiveAd SDK نسخه 2.8.20240722.0

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.2.0.
  • FiveAd SDK نسخه 2.8.20240722.0

نسخه 2.7.20240515.0

  • سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240515.0

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.1.0.
  • FiveAd SDK نسخه 2.7.20240515.0

نسخه 2.7.20240214.1

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
  • سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240214.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.0.0.
  • FiveAd SDK نسخه 2.7.20240214.0.

نسخه 2.7.20240214.0

  • سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240214.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.6.0.
  • FiveAd SDK نسخه 2.7.20240214.0.

نسخه 2.7.20240126.0

  • سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240126.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.6.0.
  • FiveAd SDK نسخه 2.7.20240126.0.

نسخه 2.7.20240112.0

  • FiveAdViewEventListener منسوخ شده به نفع FiveAdCustomLayoutEventListener ، FiveAdVideoRewardEventListener ، FiveAdInterstitialEventListener و FiveAdNativeEventListener حذف شد.
  • سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240112.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.6.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.6.0.
  • FiveAd SDK نسخه 2.7.20240112.

نسخه 2.6.20230607.1

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.4.0.
  • FiveAd SDK نسخه 2.6.20230607.

نسخه 2.6.20230607.0

  • انتشار اولیه
  • پشتیبانی از قالب‌های تبلیغاتی بنر، بینابینی، پاداش و بومی را اضافه می‌کند.
  • سازگاری تأیید شده با FiveAd SDK نسخه 2.6.20230607.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.1.0.
  • FiveAd SDK نسخه 2.6.20230607.
،

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

رابط داشبورد برای Line از متن ژاپنی برای برچسب‌ها، دکمه‌ها و توضیحات خود استفاده می‌کند. اسکرین شات های این راهنما ترجمه نشده اند. با این حال، در توضیحات و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی خود در پرانتز ترجمه شده‌اند.

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

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

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

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

الزامات

  • Android API سطح 21 یا بالاتر

  • جدیدترین SDK تبلیغات موبایل گوگل

  • راهنمای شروع میانجیگری را کامل کنید

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

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

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

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

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

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

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

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

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

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

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

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

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

به حساب Ad Manager خود وارد شوید.

به مسیر Delivery > Yield Groups بروید و روی دکمه گروه بازده جدید کلیک کنید.

یک نام منحصر به فرد برای گروه بازدهی خود وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب تبلیغات خود را انتخاب کنید و نوع موجودی را روی برنامه موبایل تنظیم کنید. در بخش Targeting > Inventory ، واحد تبلیغاتی را در برنامه Inventory and Mobile که می‌خواهید میانجیگری را به آن اضافه کنید، انتخاب کنید.

بعد، روی دکمه افزودن شریک عملکرد کلیک کنید.

اگر در حال حاضر یک شریک بازده برایLine، می توانید آن را انتخاب کنید. در غیر این صورت، Create a new yield partner را انتخاب کنید.

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

پس از انتخاب شریک Yield ، Mobile SDK Mediation را به عنوان نوع ادغام انتخاب کنید.Android به عنوان پلتفرم و فعال به عنوان وضعیت . را وارد کنیدApplication ID and Slot ID در بخش قبل به دست آمد. سپس، یک مقدار پیش فرض CPM را وارد کنید.

پس از اتمام روی ذخیره در پایین صفحه کلیک کنید.

مرحله 3: Line SDK و Adapter را وارد کنید

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:line:2.8.20240827.0")
}

ادغام دستی

  1. آخرین نسخه فایل .aar Line SDK را دانلود کنید و آن را به پروژه خود اضافه کنید.

  2. به آرتیفکت‌های آداپتور خط در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور Line را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

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

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

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

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

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

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

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

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

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

آداپتور Line از یک پارامتر درخواست اضافی پشتیبانی می کند که می تواند با استفاده از کلاس LineExtras به آداپتور ارسال شود. این سازنده کلاس شامل پارامترهای زیر است:

enableAdSound
یک boolean برای مشخص کردن وضعیت شروع صدای پیش‌فرض آگهی‌های تبلیغاتی، بینابینی و پاداش.

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

جاوا 

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

کاتلین 

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

استفاده از تبلیغات بومی

رندر آگهی

آداپتور Line موارد زیر را پر می کندزمینه هابرای یکNativeAd .

میدان دارایی ها همیشه توسط آداپتور خط گنجانده شده است
تیتر
تصویر
بدن
نماد برنامه 1
فراخوان به اقدام
امتیاز ستاره
فروشگاه
قیمت

1 برای تبلیغات بومی، Line SDK دارایی نماد برنامه را ارائه نمی دهد. در عوض، آداپتور Line نماد برنامه را با یک تصویر شفاف پر می کند.

کدهای خطا

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

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

در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور 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 به دلیل کمبود دارایی، آگهی بومی بارگیری نشد.

LINE تغییرات آداپتور میانجی اندروید

نسخه بعدی

  • AdLoader را برای فعال کردن RTB برای تبلیغات بنری پیاده سازی کرد.
  • AdLoader را برای فعال کردن RTB برای تبلیغات بینابینی پیاده سازی کرد.
  • AdLoader را برای فعال کردن RTB برای تبلیغات با پاداش پیاده‌سازی کرد.
  • AdLoader را برای فعال کردن RTB برای تبلیغات بومی پیاده‌سازی کرد.

نسخه 2.8.20240827.0

  • سازگاری تایید شده با FiveAd SDK نسخه 2.8.20240827.0

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.3.0.
  • FiveAd SDK نسخه 2.8.20240827.0

نسخه 2.8.20240808.0

  • سازگاری تایید شده با FiveAd SDK نسخه 2.8.20240808.0

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.2.0.
  • FiveAd SDK نسخه 2.8.20240808.0

نسخه 2.8.20240722.0

  • سازگاری تایید شده با FiveAd SDK نسخه 2.8.20240722.0

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.2.0.
  • FiveAd SDK نسخه 2.8.20240722.0

نسخه 2.7.20240515.0

  • سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240515.0

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.1.0.
  • FiveAd SDK نسخه 2.7.20240515.0

نسخه 2.7.20240214.1

  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
  • سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240214.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 23.0.0.
  • FiveAd SDK نسخه 2.7.20240214.0.

نسخه 2.7.20240214.0

  • سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240214.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.6.0.
  • FiveAd SDK نسخه 2.7.20240214.0.

نسخه 2.7.20240126.0

  • سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240126.0.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.6.0.
  • FiveAd SDK نسخه 2.7.20240126.0.

نسخه 2.7.20240112.0

  • FiveAdViewEventListener منسوخ شده به نفع FiveAdCustomLayoutEventListener ، FiveAdVideoRewardEventListener ، FiveAdInterstitialEventListener و FiveAdNativeEventListener حذف شد.
  • سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240112.
  • حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.6.0 به روز شد.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.6.0.
  • FiveAd SDK نسخه 2.7.20240112.

نسخه 2.6.20230607.1

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

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.4.0.
  • FiveAd SDK نسخه 2.6.20230607.

نسخه 2.6.20230607.0

  • انتشار اولیه
  • پشتیبانی از قالب‌های تبلیغاتی بنر، بینابینی، پاداش و بومی را اضافه می‌کند.
  • سازگاری تأیید شده با FiveAd SDK نسخه 2.6.20230607.

ساخته و تست شده با:

  • Google Mobile Ads SDK نسخه 22.1.0.
  • FiveAd SDK نسخه 2.6.20230607.