שילוב של LINE Ads Network עם תהליך בחירת הרשת (Mediation) (בטא)

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

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

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

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

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

דרישות

  • Android API ברמה 21 ואילך

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

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

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

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

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

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

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

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

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

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

שימו לב למזהה המיקום.

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

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

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

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

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

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

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

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

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

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

בידינג


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

מפל


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

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



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

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


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

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

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

שילוב ידני

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

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

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

אין צורך בקוד נוסף כדי לשלב את LINE Ads Network.

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

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

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

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

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

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

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

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

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
חנות
מחיר

1 במודעות מותאמות, ערכת ה-SDK של רשת LINE Ads לא מספקת נכס של סמל אפליקציה. במקום זאת, מתאם 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 ה-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.
104 com.google.ads.mediation.line נכשלה טעינת מודעה מעברון או מודעה עם תגמול כי הקשר הפעילות חסר.
105 com.google.ads.mediation.line ל-LINE Ads Network SDK לא הצליח להציג מודעת מעברון או מודעת פרסום עם פרס.
106 com.google.ads.mediation.line נכשלה הטעינה של מודעה רגילה בגלל נכסים חסרים.

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

הגרסה הבאה

  • תהליך איסוף אותות קבוע.
  • תוקן תהליך האיפוס של פורמטים של מודעות מעברון ומודעות מתגמלות ב-Waterfall.

גרסה 2.9.20241129.0

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

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

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

גרסה 2.8.20240827.0

  • תאימות מאומתת עם FiveAd SDK בגרסה 2.8.20240827.0

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

  • Google Mobile Ads SDK בגרסה 23.3.0.
  • FiveAd SDK גרסה 2.8.20240827.0

גרסה 2.8.20240808.0

  • תאימות מאומתת עם FiveAd SDK בגרסה 2.8.20240808.0

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

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

גרסה 2.8.20240722.0

  • תאימות מאומתת עם FiveAd SDK בגרסה 2.8.20240722.0

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

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

גרסה 2.7.20240515.0

  • תאימות מאומתת עם FiveAd SDK בגרסה 2.7.20240515.0

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

  • Google Mobile Ads SDK בגרסה 23.1.0.
  • FiveAd SDK גרסה 2.7.20240515.0

גרסה 2.7.20240214.1

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

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

  • Google Mobile Ads SDK בגרסה 23.0.0.
  • גרסת ה-SDK של FiveAd היא 2.7.20240214.0.

גרסה 2.7.20240214.0

  • תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240214.0.

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

  • Google Mobile Ads SDK בגרסה 22.6.0.
  • גרסת ה-SDK של FiveAd היא 2.7.20240214.0.

גרסה 2.7.20240126.0

  • תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240126.0.

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

  • Google Mobile Ads SDK בגרסה 22.6.0.
  • גרסת FiveAd SDK‏ 2.7.20240126.0.

גרסה 2.7.20240112.0

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

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

  • Google Mobile Ads SDK בגרסה 22.6.0.
  • גרסת FiveAd SDK‏ 2.7.20240112.

גרסה 2.6.20230607.1

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

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

  • Google Mobile Ads SDK בגרסה 22.4.0.
  • גרסת ה-SDK של FiveAd היא 2.6.20230607.

גרסה 2.6.20230607.0

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

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

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