שילוב של Line עם תהליך בחירת הרשת (Mediation)

במדריך הזה מוסבר איך להשתמש ב-GMA Next Gen SDK כדי לטעון ולהציג מודעות מ-LINE Ads Network באמצעות תהליך בחירת הרשת (Mediation) ב-AdMob. המדריך כולל הסברים על שילובים של שיטת ה-Waterfall. המאמר מסביר איך להוסיף את LINE Ads Network להגדרה של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של LINE Ads Network באפליקציית Android.

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

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

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

שילוב
בידינג
Waterfall
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה
מותאם	^1

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

דרישות

• ‫Android API ברמה 24 ומעלה

• ‫[לבידינג]: כדי לשלב את כל פורמטי המודעות הנתמכים בבידינג, צריך להשתמש בגרסה 2.9.20241129.0 של LINE Ads Network adapter ואילך (מומלץ להשתמש בגרסה העדכנית)

• הגרסה האחרונה של GMA Next Gen SDK

• ביצוע של תהליך בחירת הרשת מדריך לתחילת העבודה

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

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

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

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

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

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

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

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

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

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

הערה: אי אפשר לשנות את הערכים של フォーマット (פורמט) ושל Bidding Type (סוג הבידינג) אחרי שמבצעים רישום של משבצת. כדי לקבל גישה ליצירת מיקומי מודעות מותאמות בממשק המשתמש של LINE Ads Network, צריך לפנות למנהל החשבון שלכם ב-LINE Ads Network.

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

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

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

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

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

קביעת ההגדרות של תהליך בחירת הרשת ליחידת המודעות

צריך להוסיף את LINE Ads Network להגדרת הגישור של יחידת המודעות.

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

כדי ליצור קבוצה חדשה לבחירת רשת, לוחצים על יצירת קבוצה לבחירת רשת.

מזינים את פורמט המודעה והפלטפורמה ולוחצים על המשך.

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

משייכים את הקבוצה הזו לבחירת רשת (Mediation) לאחת או יותר מיחידות המודעות הקיימות ב-AdMob. לאחר מכן לוחצים על סיום.

עכשיו אמור להופיע כרטיס של יחידות מודעות עם יחידות המודעות שבחרתם:

הוספה של LINE Ads Network כמקור מודעות

בידינג

בכרטיס Bidding שבקטע Ad Sources, לוחצים על Add ad source. לאחר מכן בוחרים באפשרות LINE Ads Network .

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



לוחצים על אישור והסכמה ואז על המשך.



אם כבר יש לכם מיפוי לרשת המודעות של LINE, אתם יכולים לבחור אותו. אחרת, לוחצים על הוספת מיפוי.



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

חשוב: מזהה האפליקציה צריך להיות משויך לאפליקציה המטורגטת כמו בממשק המשתמש של LINE Ads Network.

מפל

בכרטיס Waterfall שבקטע Ad Sources, בוחרים באפשרות Add Ad Source.

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

הערה: צריך להגדיר את האופטימיזציה של מקורות תנועה רק פעם אחת לכל רשת.

אם כבר יש לכם מיפוי ל-LINE Ads Network, אתם יכולים לבחור אותו. אחרת, לוחצים על הוספת מיפוי.

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

חשוב: מזהה האפליקציה צריך להיות משויך לאפליקציה המטורגטת כמו בממשק המשתמש של LINE Ads Network.

הערה: כדי שמערכת אופטימיזציית מקורות התנועה תוכל לחשב במדויק את העלות בפועל לאלף חשיפות ברשת גישור, היא צריכה לאסוף מספיק נתונים במשך כמה ימים. בינתיים, סטטוס האופטימיזציה של מקור המודעות הוא PENDING, לכן צריך להגדיר ידנית ערך של עלות בפועל לאלף חשיפות לרשת. אחרי שמערכת AdMob יכולה לחשב את העלות בפועל לאלף חשיפות, מקור המודעות מתחיל לעדכן אוטומטית את העלות בפועל לאלף חשיפות בשמכם.

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

הערה: אם לא תשולבנה גרסאות תואמות של LINE Ads Network ו-GMA Next Gen SDK, עלולות להתרחש בעיות בבנייה.

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
    implementation("com.google.ads.mediation:line:2.9.20250924.1")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

שילוב ידני

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

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

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

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

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

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

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

המתאם של LINE Ads Network מכיל שיטת עזר להפעלת מצב בדיקה ב-LINE Ads Network. צריך להגדיר את האפשרויות האלה לפני שמפעילים את GMA Next Gen SDK כדי לוודא שהן יועברו בצורה תקינה אל LINE Ads Network SDK.

Java

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

Kotlin

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

חשוב: לפני שמפרסמים את האפליקציה, צריך להשבית את מצב הבדיקה ב-AdMob וב-LINE Ads Network.

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

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

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

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

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

enableAdSound

‫

A boolean כדי לציין את מצב ההתחלה של הצליל שמוגדר כברירת מחדל במודעות באנר, במודעות מעברון ובמודעות מתגמלות.

בדוגמה הבאה מוצג קוד ליצירת בקשה להצגת מודעה שבה מוגדרים הפרמטרים האלה:

Java

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

Kotlin

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

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

שימוש במודעות מותאמות

רינדור מודעות

המתאם של LINE Ads Network מאכלס את תיאורי השדות המתקדמים של מודעות מותאמות הבאים של NativeAd.

שדה	נכסים שתמיד נכללים על ידי המתאם של LINE Ads Network
כותרת
תמונה
גוף
סמל האפליקציה	^1
קריאה לפעולה
דירוג כוכבים
חנות
מחיר

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

קודי שגיאה

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

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

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

קוד שגיאה	דומיין	סיבה
1-10	com.five_corp.ad	‫LINE Ads Network SDK החזיר שגיאה ספציפית ל-SDK. פרטים נוספים מופיעים במאמרי העזרה של LINE Ads Network.
101	com.google.ads.mediation.line	מזהה האפליקציה חסר או לא תקין.
102	com.google.ads.mediation.line	מזהה מיקום המודעה חסר או לא תקין.
103	com.google.ads.mediation.line	גודל המודעה המבוקש לא תואם לגודל מודעת באנר נתמך ב-LINE Ads Network.
104	com.google.ads.mediation.line	טעינת מודעה מתגמלת או מודעת מעברון נכשלה בגלל שחסר הקשר של הפעילות.
105	com.google.ads.mediation.line	‫LINE Ads Network SDK נכשל בהצגת מודעת מעברון או מודעה מתגמלת.
106	com.google.ads.mediation.line	טעינת המודעה המותאמת נכשלה בגלל נכסים חסרים.

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

גרסה 2.9.20251028.0 (בפיתוח)

גרסה 2.9.20250924.1

• הסרנו הפניות להקשר ברמת הכיתה. יכול לעזור לצמצם בעיות של דליפת זיכרון.

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

• גרסה 24.7.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.9.20250924.1.

גרסה 2.9.20250924.0

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

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

• גרסה 24.6.0 של Google Mobile Ads SDK.
• גרסה 2.9.20250924.0 של FiveAd SDK

גרסה 2.9.20250718.0

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

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

• גרסה 24.3.0 של Google Mobile Ads SDK.
• גרסה 2.9.20250718.0 של FiveAd SDK.

גרסה 2.9.20250519.0

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

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

• גרסה 24.3.0 של Google Mobile Ads SDK.
• גרסה 2.9.20250519.0 של FiveAd SDK.

גרסה 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.
• גרסה 2.8.20240827.0 של FiveAd SDK

גרסה 2.8.20240808.0

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

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

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

גרסה 2.8.20240722.0

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

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

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

גרסה 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.
• גרסת FiveAd SDK‏ 2.7.20240112.

גרסה 2.6.20230607.1

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

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

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

גרסה 2.6.20230607.0

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

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

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