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

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

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

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

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

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

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

דרישות

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

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

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

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

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

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

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

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

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

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

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

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

ממלאים את הטופס כדי לקבל פרטים על משבצת הזמן. בקטע סוג הבידינג, בוחרים באפשרות רגיל כדי להגדיר את משבצת המודעה הזו לשרשור (Waterfall) או באפשרות בידינג מבוסס 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. לאחר מכן מזינים ערך של עלות בפועל לאלף חשיפות עבור LINE Ads Network ולוחצים על המשך.

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

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

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

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

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

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

הערה: אם לא משלבים את הגרסאות התואמות של LINE Ads Network ו-Google Mobile Ads SDK, יכולות להיווצר בעיות ב-build.

שילוב עם 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: בדיקת ההטמעה

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

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

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

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

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

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

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

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

enableAdSound

‫

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

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

Java

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

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

Kotlin

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

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

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

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

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

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

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

קודי שגיאה

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

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.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.