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

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

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

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

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

דרישות

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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

קודי שגיאה

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

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

אלה הקודים וההודעות שמופיעים במתאם של LINE Ads Network כשלא ניתן לטעון מודעה:

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

הגרסה הבאה

• תהליך איסוף אותות קבוע.

גרסה 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.
• גרסת ה-SDK של FiveAd היא 2.6.20230607.