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

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

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

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

למתאם התהליך של Line יש את היכולות הבאות:

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

¹ Integration of Waterfall is in closed beta. You can contact your account manager to request access.

דרישות

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

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

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

שלב 1: הגדרת ההגדרות בממשק המשתמש של Line

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

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

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

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

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

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

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

לוחצים על スロな 追加 (הוספת משבצת).

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

הערה: כדי ליצור מיקומי מודעות מותאמים אישית בממשק המשתמש של Line, צריך לפנות למנהל החשבון שלכם ברשת Line Ads.

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

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

שלב 3: מייבאים את ה-SDK ואת המתאם של Line

הערה: אי-שילוב של הגרסאות התואמות של Line ו-Google Mobile Ads SDK עלול לגרום לבעיות ב-build.

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

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

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

שילוב ידני

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

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

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

לא נדרש קוד נוסף לשילוב עם Line.

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

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

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

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

enableAdSound

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

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

Java

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

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

Kotlin

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

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

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

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

מתאם השורות מאכלס את עבור NativeAd.

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

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

קודי שגיאה

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

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

אלה הקודים וההודעות שמופיעים במתאם Line כשמודעה לא נטענת:

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

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

הגרסה הבאה

• הטמענו את AdLoader כדי לאפשר RTB למודעות באנר.
• הטמענו את AdLoader כדי לאפשר RTB למודעות מעברון.
• הטמענו את AdLoader כדי לאפשר RTB למודעות מתגמלות.

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

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

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

גרסה 2.6.20230607.0

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

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

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