ادغام LINE Ads Network با واسطه

این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از شبکه تبلیغات لاین با استفاده از میانجیگری استفاده کنید و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن شبکه تبلیغات لاین به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور شبکه تبلیغات لاین در یک برنامه فلاتر را پوشش می‌دهد.

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

آداپتور میانجی‌گری مدیریت تبلیغات (Ad Manager) برای شبکه تبلیغات لاین (LINE Ads Network) قابلیت‌های زیر را دارد:

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

۱ تبلیغات بومی (برای پیشنهاد قیمت) در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

الزامات

  • جدیدترین SDK تبلیغات موبایلی گوگل
  • فلاتر ۳.۷.۰ یا بالاتر
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه فلاترِ در حال کار که با SDK تبلیغات موبایلی گوگل پیکربندی شده است. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
  • راهنمای شروع میانجیگری را تکمیل کنید

مرحله ۱: تنظیمات را در رابط کاربری شبکه تبلیغات لاین (LINE Ads Network UI) انجام دهید

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

افزودن یک برنامه جدید

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

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

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

ایجاد جایگاه تبلیغات

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

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

برای جزئیات بیشتر در مورد اسلات، فرم را پر کنید. برای نوع پیشنهاد ، گزینه استاندارد را برای پیکربندی این اسلات برای میانجیگری آبشاری یا گزینه Google SDK Bidding را برای پیکربندی این اسلات برای پیشنهاد انتخاب کنید. پس از پر کردن فرم، روی登録 (ثبت نام) کلیک کنید.

به شناسه اسلات (Slot ID) توجه کنید.

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

برای پیاده‌سازی app-ads.txt برای شبکه تبلیغات LINE، به بخش «درباره app-ads.txt» مراجعه کنید.

مرحله ۲: تنظیم تقاضای شبکه تبلیغات لاین در رابط کاربری مدیریت تبلیغات

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

اندروید

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

آی‌او‌اس

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

مرحله ۳: SDK و آداپتور شبکه تبلیغات لاین را وارد کنید

ادغام از طریق pub.dev

وابستگی زیر را به همراه آخرین نسخه‌های LINE Ads Network SDK و آداپتور آن در فایل pubspec.yaml پکیج خود اضافه کنید:

dependencies:
  gma_mediation_line: ^1.0.4

ادغام دستی

آخرین نسخه افزونه میانجیگری تبلیغات موبایل گوگل را برای شبکه تبلیغات لاین دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه فلاتر خود اضافه کنید. سپس با اضافه کردن وابستگی زیر، افزونه را در فایل pubspec.yaml خود ارجاع دهید:

dependencies:
  gma_mediation_line:
    path: path/to/local/package

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

اندروید

برای ادغام شبکه تبلیغات LINE هیچ کد اضافی لازم نیست.

آی‌او‌اس

ادغام شبکه SKAd

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

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

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

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

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

برای تأیید اینکه تبلیغات آزمایشی را از شبکه تبلیغات LINE دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی شبکه تبلیغات LINE (آبشاری ) فعال کنید.

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

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

افزونه میانجیگری LINE Ads Network Flutter از پارامتر درخواست اضافی زیر پشتیبانی می‌کند که می‌تواند از طریق کلاس LineMediationExtras به آداپتور منتقل شود:

  • enableAdSound : حالت پیش‌فرض شروع صدای تبلیغات بنری، بینابینی و جایزه‌دار را مشخص می‌کند.

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

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [lineExtras],
);

کدهای خطا

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

اندروید 

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

آی‌او‌اس 

GADMediationAdapterLine

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

اندروید

کد خطا دامنه دلیل
۱-۱۰ com.five_corp.ad کیت توسعه نرم‌افزار شبکه تبلیغات لاین (LINE Ads Network SDK) خطایی مربوط به SDK را نشان داد. برای جزئیات بیشتر به مستندات شبکه تبلیغات لاین مراجعه کنید.
۱۰۱ com.google.ads.mediation.line شناسه برنامه موجود نیست یا نامعتبر است.
۱۰۲ com.google.ads.mediation.line شناسه اسلات نامعتبر یا موجود نیست.
۱۰۳ com.google.ads.mediation.line اندازه تبلیغ درخواستی با اندازه بنر تبلیغاتی پشتیبانی شده توسط شبکه تبلیغات لاین مطابقت ندارد.
۱۰۴ com.google.ads.mediation.line به دلیل عدم نمایش زمینه فعالیت، بارگذاری تبلیغ بینابینی یا جایزه‌دار ناموفق بود.
۱۰۵ com.google.ads.mediation.line کیت توسعه نرم‌افزار شبکه تبلیغات لاین (LINE Ads Network SDK) نتوانست تبلیغ بینابینی یا تبلیغ پاداشی را نمایش دهد.
۱۰۶ com.google.ads.mediation.line به دلیل فقدان دارایی‌ها، بارگذاری تبلیغ بومی ناموفق بود.

آی‌او‌اس

کد خطا دامنه دلیل
۱-۱۰ ارسال شده توسط کیت توسعه نرم‌افزاری شبکه تبلیغات لاین کیت توسعه نرم‌افزار شبکه تبلیغات لاین (LINE Ads Network SDK) خطایی مربوط به SDK را نشان داد. برای جزئیات بیشتر به مستندات شبکه تبلیغات لاین مراجعه کنید.
۱۰۱ com.google.ads.mediation.line پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه اسلات وجود ندارد).
۱۰۲ com.google.ads.mediation.line اندازه تبلیغ درخواستی با اندازه بنر تبلیغاتی پشتیبانی شده توسط شبکه تبلیغات لاین مطابقت ندارد.
۱۰۳ com.google.ads.mediation.line بارگذاری یک تصویر آیکون اطلاعاتی در تبلیغ بومی ناموفق بود.

تغییرات آداپتور میانجیگری Line Flutter

نسخه ۱.۰.۵ (در حال انجام)

نسخه ۱.۰.۴

نسخه ۱.۰.۳

نسخه ۱.۰.۲

نسخه ۱.۰.۱

نسخه ۱.۰.۰