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

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

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

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

למתאם תהליך בחירת הרשת (Mediation) של קו יש את היכולות הבאות:

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

¹ השילוב של Waterfall נמצא בגרסת בטא פתוחה.

דרישות

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

• ה-SDK העדכני של Google Mobile Ads

• השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

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

שלב 2: הגדרת ביקוש לשורה AdMob בממשק המשתמש

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

עליך להוסיף Line לתצורה של תהליך בחירת הרשת של יחידת המודעות.

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

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

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

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

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

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

הוספה של Line כמקור מודעות

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

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

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

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

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

חשוב: Application ID חייב להיות משויך לאפליקציה המטורגטת, כמוLine בממשק המשתמש.

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

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

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

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

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

שילוב ידני

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

2. עוברים אל פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) של מתאם הקו. במאגר Maven של Google. יש לבחור בגרסה העדכנית ביותר, ולהוריד את השורה את הקובץ .aar של המתאם, ומוסיפים אותו לפרויקט.

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

אין צורך בקוד נוסף לשילוב שורה.

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

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

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

פועלים לפי ההוראות במסמכי התיעוד של התיעוד של Line כדי להבין איך להפעיל מודעות בדיקה של Line.

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

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

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

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

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

מתאם השורה תומך בפרמטר בקשה נוסף שניתן להעביר למתאם באמצעות המחלקה 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()

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

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

מתאם השורה מאכלס את הפריטים הבאים תיאורי שדות של מודעות מותאמות מתקדמות עבור NativeAd.

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

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

קודי שגיאה

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

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

אלו הקודים וההודעות הנלוות שמוצגות על ידי מתאם הקו בזמן מודעה לא נטענת:

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

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

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

פותח ונבדק בעזרת:

• גרסה 23.1.0 של Google Mobile Ads SDK
• 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.
• FiveAd SDK גרסה 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.