שילוב LINE Ads Network עם תהליך בחירת הרשת

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-LINE Ads Network באמצעות גישור, כולל שילובים של שיטת ה-Waterfall. במאמר מוסבר איך להוסיף את LINE Ads Network להגדרת בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של LINE Ads Network באפליקציית Android.

בממשק של מרכז הבקרה של LINE Ads Network נעשה שימוש בטקסט ביפנית לתוויות, ללחצנים ולתיאורים. צילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות במדריך הזה, התוויות והלחצנים מתורגמים עם המקבילות שלהם באנגלית בסוגריים.

שילובים נתמכים ופורמטים נתמכים של מודעות

המתאם של תהליך בחירת הרשת עבור LINE Ads Network כולל את היכולות הבאות:

‫¹ מודעות מותאמות (לבידינג) נמצאות בגרסת בטא סגורה. כדי לבקש גישה, צריך לפנות למנהל החשבון.

דרישות

• רמת API ‏23 ואילך ב-Android

• הגרסה העדכנית של Google Mobile Ads SDK

• צריך לקרוא את המדריך לתחילת העבודה עם תהליך בחירת הרשת (Mediation).

שלב 1: הגדרת תצורות בממשק המשתמש של LINE Ads Network

נרשמים ומתחברים לחשבון LINE Ads Network.

הוספת אפליקציה חדשה

לוחצים על 広告枠管理 (ניהול מיקומי מודעות בדף) > メディア (מדיה). אחר כך לוחצים על 新規作成 (Create New).

ממלאים את הטופס ולוחצים על 登録 (הרשמה).

חשוב לשים לב למזהה האפליקציה.

יצירת מיקום מודעה

לוחצים על המזהה של האפליקציה שרוצים להוסיף לה מיקום מודעה. לאחר מכן, בוחרים באפשרות 詳細 (פירוט).

לוחצים על スロット 追加 (הוספת מיקום מודעה בדף).

ממלאים את הטופס כדי לקבל פרטים על משבצת הזמן. בקטע סוג הבידינג, בוחרים באפשרות רגיל כדי להגדיר את משבצת המודעה הזו לשרשור (Waterfall) או באפשרות בידינג מבוסס SDK חיצוני של Google כדי להגדיר את משבצת המודעה הזו לבידינג. אחרי שממלאים את הטופס, לוחצים על 登録 (הרשמה).

רושמים את מזהה מיקום המודעה.

עדכון של קובץ app-ads.txt

Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, צרו קובץ app-ads.txt ל-Ad Manager.

כדי להטמיע את app-ads.txt ברשת המודעות של LINE, אפשר לעיין במאמר מידע על app-ads.txt.

שלב 2: הגדרת הביקוש של LINE Ads Network בממשק המשתמש של Ad Manager

נכנסים לחשבון Ad Manager.

הוספת LINE Ads Network בקטע 'חברות'

הפעלת שיתוף אותות מאובטח

שיתוף אותות מאובטחים בבקשות להצעות מחיר

איך מאפשרים שיתוף אותות מאובטחים בבידינג מבוסס SDK

הגדרת בידינג ב-LINE Ads Network

הגדרת מיפוי של יחידות מודעות

שלב 3: מייבאים את ה-SDK ואת המתאם של LINE Ads Network

שילוב עם Android Studio (מומלץ)

בקובץ build.gradle.kts ברמת האפליקציה, מוסיפים את התלות וההגדרות הבאות של ההטמעה. משתמשים בגרסאות העדכניות ביותר של LINE Ads Network SDK והמתאם:

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

שילוב ידני

1. מורידים את הגרסה העדכנית של קובץ ה-.aar של LINE Ads Network SDK ומוסיפים אותו לפרויקט.

2. עוברים אל LINE Ads Network adapter artifacts במאגר Maven של Google. בוחרים את הגרסה האחרונה, מורידים את קובץ .aar של המתאם של LINE Ads Network ומוסיפים אותו לפרויקט.

שלב 4: מוסיפים את הקוד הנדרש

לא נדרש קוד נוסף לשילוב עם LINE Ads Network.

שלב 5: בדיקת ההטמעה

הפעלת מודעות בדיקה

חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager.

אימות מודעות בדיקה

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-LINE Ads Network, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות LINE Ads Network (Waterfall).

שלבים אופציונליים

פרמטרים ספציפיים לרשת

המתאם של LINE Ads Network תומך בפרמטר נוסף של בקשה שאפשר להעביר למתאם באמצעות המחלקה LineExtras. הפרמטרים של בנאי המחלקה הזו:

enableAdSound

‫

A 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 Ads Network מאכלס את השדות הבאים עבור NativeAd.

‫¹ במודעות מותאמות, LINE Ads Network SDK לא מספק נכס של סמל אפליקציה. במקום זאת, מתאם LINE Ads Network מאכלס את סמל האפליקציה בתמונה שקופה.

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-LINE Ads Network, אפשר לבדוק את השגיאה הבסיסית בתגובה למודעה באמצעות ResponseInfo.getAdapterResponses() בקטעים הבאים:

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

אלה הקודים וההודעות הנלוות שמוחזרים על ידי מתאם LINE Ads Network כשהטעינה של מודעה נכשלת:

יומן השינויים של מתאם הגישור של LINE ל-Android

גרסה 2.9.20250718.0

• תאימות מאומתת לגרסה 2.9.20250718 של FiveAd SDK.

נבנה ונבדק באמצעות:

• ‫Google Mobile Ads SDK גרסה 24.3.0.
• גרסת SDK‏ FiveAd‏ 2.9.20250718.0.

גרסה 2.9.20250519.0

• תאימות מאומתת לגרסה 2.9.20250519 של FiveAd SDK.

נבנה ונבדק באמצעות:

• ‫Google Mobile Ads SDK גרסה 24.3.0.
• גרסת SDK‏ FiveAd‏ 2.9.20250519.0.

גרסה 2.9.20250317.1

• תיקנו את המידות של טעינת באנרים למודעות בידינג באמצעות FiveAd API החדש

נבנה ונבדק באמצעות:

• גרסה 24.1.0 של Google Mobile Ads SDK.
• גרסה 2.9.20250317.0 של FiveAd SDK

גרסה 2.9.20250317.0

• תאימות מאומתת לגרסה 2.9.20250317 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 24.1.0 של Google Mobile Ads SDK.
• גרסה 2.9.20250317.0 של FiveAd SDK

גרסה 2.9.20250110.1

• עדכנו את רמת ה-API המינימלית הנדרשת ב-Android ל-23.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-24.0.0.

נבנה ונבדק באמצעות:

• גרסה 24.0.0 של Google Mobile Ads SDK.
• גרסה 2.9.20250110.0 של FiveAd SDK

גרסה 2.9.20250110.0

• הוסרה הכיתה UnifiedNativeAdMapper שיצאה משימוש לטובת NativeAdMapper
• תהליך איסוף האותות תוקן.
• תוקן תהליך האתחול של פורמטים של מודעות מעברון ומודעות מתגמלות ב-Waterfall.
• תאימות מאומתת לגרסה 2.9.20250110 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 23.6.0 של Google Mobile Ads SDK.
• גרסה 2.9.20250110.0 של FiveAd SDK

גרסה 2.9.20241129.0

• הוספנו תמיכה בבידינג בפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
• תאימות מאומתת לגרסה 2.9.20241129 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 23.5.0 של Google Mobile Ads SDK.
• גרסה 2.9.20241129.0 של FiveAd SDK

גרסה 2.8.20240827.0

• תאימות מאומתת לגרסה 2.8.20240827 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 23.3.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.8.20240827.0

גרסה 2.8.20240808.0

• תאימות מאומתת לגרסה FiveAd SDK version 2.8.20240808.

נבנה ונבדק באמצעות:

• גרסה 23.2.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.8.20240808.0

גרסה 2.8.20240722.0

• תאימות מאומתת לגרסה FiveAd SDK 2.8.20240722.

נבנה ונבדק באמצעות:

• גרסה 23.2.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.8.20240722.0

גרסה 2.7.20240515.0

• תאימות מאומתת לגרסה 2.7.20240515 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 23.1.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.7.20240515.0

גרסה 2.7.20240214.1

• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-23.0.0.
• תאימות מאומתת לגרסה 2.7.20240214 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 23.0.0 של Google Mobile Ads SDK.
• גרסה 2.7.20240214.0 של FiveAd SDK.

גרסה 2.7.20240214.0

• תאימות מאומתת לגרסה 2.7.20240214 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 22.6.0 של Google Mobile Ads SDK.
• גרסה 2.7.20240214.0 של FiveAd SDK.

גרסה 2.7.20240126.0

• תאימות מאומתת לגרסה 2.7.20240126 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 22.6.0 של Google Mobile Ads SDK.
• גרסה 2.7.20240126.0 של FiveAd SDK.

גרסה 2.7.20240112.0

• הוסר FiveAdViewEventListener שהוצא משימוש לטובת FiveAdCustomLayoutEventListener, ‏ FiveAdVideoRewardEventListener,‏ FiveAdInterstitialEventListener ו-FiveAdNativeEventListener.
• תאימות מאומתת לגרסה 2.7.20240112 של FiveAd SDK.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.6.0.

נבנה ונבדק באמצעות:

• גרסה 22.6.0 של Google Mobile Ads SDK.
• גרסה 2.7.20240112 של FiveAd SDK.

גרסה 2.6.20230607.1

• נוסף LineExtras class לבעלי תוכן דיגיטלי, שמאפשר להם להגדיר ברירות מחדל להגדרות הקול בפורמטים של מודעות באנר, מודעות מעברון ומודעות מתגמלות.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.4.0.

נבנה ונבדק באמצעות:

• גרסה 22.4.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.6.20230607.

גרסה 2.6.20230607.0

• זו הגרסה הראשונה.
• נוספה תמיכה בפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
• תאימות מאומתת לגרסה 2.6.20230607 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 22.1.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.6.20230607.