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

בחירת פלטפורמה: Android New-selected Android iOS Unity Flutter

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

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

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

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

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

דרישות

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

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

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

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

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

עוברים לכרטיסייה アプリ (אפליקציה) ולוחצים על הלחצן 新規登録 (רישום חדש).

הרשמה חדשה

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

טופס הרשמה חדש

רושמים את מזהה האפליקציה.

פרטי רישום

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

בכרטיסייה アプリ (אפליקציה), בוחרים את האפליקציה כדי לראות את הפרטים שלה. בקטע スロット (Slot), לוחצים על 追加 (Add).

הוספת משבצת

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

הוספת טופס משבצת

שימו לב לスロットID (מזהה מיקום המודעה בדף).

פרטי מיקום מודעה

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

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

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

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

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

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

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

בידינג


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

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



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



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



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



מפל


בכרטיס Waterfall שבקטע מקורות מודעות, בוחרים באפשרות הוספת מקור מודעות.

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

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



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

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


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

בקובץ gradle ברמת האפליקציה, מוסיפים את התלות וההגדרות הבאות של implementation:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1")
    implementation("com.google.ads.mediation:line:3.1.0.0")
}

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

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'
    implementation 'com.google.ads.mediation:line:3.1.0.0'
}

configurations.configureEach {
    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 Ads Network adapter artifacts במאגר ה-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);

Kotlin 

LineMediationAdapter.setTestMode(true)

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

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-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();

Kotlin 

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

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

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

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

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

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

‫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 ה-SDK של LINE Ads Network החזיר שגיאה ספציפית ל-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

הגרסה הבאה

  • ‫Maps AgeRestrictedTreatment אל ChildDirectedTreatment API של Line.

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

גרסה 3.1.0.0

  • נוסף מאפיין ליצירת המתאם עם תלות ב-GMA Next-Gen SDK.
  • תאימות מאומתת לגרסה 3.1.0.0 של FiveAd SDK.

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

  • גרסה 25.1.0 של Google Mobile Ads SDK.
  • גרסה 0.25.0-beta01 של Google Mobile Ads Next-Gen SDK.
  • גרסה 3.1.0.0 של FiveAd SDK.

גרסה 3.0.1.2

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

  • גרסה 25.1.0 של Google Mobile Ads SDK.
  • גרסה 3.0.1.2 של FiveAd SDK.

גרסה 3.0.1.1

  • החל מגרסה 24.4.0 של Google Mobile Ads SDK, מערכת FiveAd SDK מחליפה את החשיפות של מודעות מותאמות.

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

  • גרסה 24.9.0 של Google Mobile Ads SDK.
  • גרסה 3.0.1.1 של FiveAd SDK.

גרסה 3.0.1.0

  • נוספה תמיכה בהעברה של הפרמטר tagForUnderAgeOfConsent של Google Mobile Ads SDK אל FiveAd SDK.
  • תאימות מאומתת לגרסה 3.0.1.0 של FiveAd SDK.

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

  • גרסה 24.9.0 של Google Mobile Ads SDK.
  • גרסה 3.0.1.0 של FiveAd SDK.

גרסה 3.0.0.0

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

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

  • גרסה 24.9.0 של Google Mobile Ads SDK.
  • גרסה 3.0.0.0 של FiveAd SDK.

גרסה 2.9.20251028.0

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

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

  • גרסה 24.7.0 של Google Mobile Ads SDK.
  • גרסה 2.9.20251028.0 של FiveAd SDK

גרסה 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 2.8.20240808.

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

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

גרסה 2.8.20240722.0

  • תאימות מאומתת לגרסה FiveAd SDK version 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.
  • גרסת FiveAd SDK‏ 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.