דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

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

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

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

דרישות

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

ה-SDK העדכני של Google Mobile Ads
מבצעים את ההוראות שבמדריך לתחילת העבודה.

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

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

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

לוחצים על 広告枠管理 (ניהול משבצת מודעה) > でア (מדיה). אחר כך לוחצים על הדרושות規成 (יצירת חדש).

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

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

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

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

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

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

חשוב לזכור את מזהה המיקום.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שילוב עם 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")
}

שילוב ידני

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

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

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

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

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

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

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

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

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

קודי שגיאה

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

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

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

קוד שגיאה	דומיין	סיבה
1-10	com.five_corp.ad	ה-SDK של Line החזיר שגיאה ספציפית ל-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	נכשלה הטעינה של מודעה רגילה בגלל נכסים חסרים.

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

הגרסה הבאה

הטמעת את 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

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

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

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

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

גרסה 2.6.20230607.0

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

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

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