במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Line באמצעות תהליך בחירת הרשת (Mediation), שילובים של Waterfall. במדריך מוסבר איך להוסיף את Line להגדרת בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של Line באפליקציה של Unity.
השילובים והפורמטים של המודעות הנתמכים
ל Ad Manager מתאם בחירת הרשת ל-Line יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | 1 |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה |
1 השילוב של Waterfall נמצא ב- בגרסת בטא סגורה, עליכם לפנות למנהל החשבון שלכם כדי לבקש גישה.
דרישות
- Unity 4 ומעלה
- ה-SDK העדכני של Google Mobile Ads
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- קוראים את המדריך לתחילת העבודה בנושא תהליך בחירת הרשת (Mediation)
שלב 1: קביעת ההגדרות בממשק המשתמש של Line
שלב 2: הגדרת ביקוש לשורה Ad Manager בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
שלב 3: מייבאים את Line SDK והמתאם
הורדת הגרסה האחרונה של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Line
מקישור ההורדה
יומן שינויים וחילוץ
GoogleMobileAdsLineMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > (נכסים >) ייבוא חבילה >
חבילה מותאמת אישית ומוצאים את GoogleMobileAdsLineMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על
ייבוא.
בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android >
סגירה ידנית. ספריית Unity Play Services מקודדת תפעל
של יחסי התלות מההתחלה ומעתיקים את יחסי התלות המוצהרים
הספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: מוסיפים את הקוד הנדרש
Android
אין צורך בקוד נוסף לשילוב שורה.
iOS
שילוב של SKAdNetwork
יש לפעול לפי מסמכי התיעוד של Line
כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- Ad Manager
פועלים לפי ההוראות במסמכי התיעוד של במסמכי התיעוד של Line Android וב-iOS כדי להבין איך להפעיל מודעות בדיקה של Line.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-Line, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Line (Waterfall) מקורות המודעות.
שלבים אופציונליים
פרמטרים ספציפיים לרשת
הפלאגין לבחירת רשת Line Unity תומך בבקשה הנוספת הבאה
פרמטר שאפשר להעביר למתאם דרך LineMediationExtras
class:
SetEnableAdSound(boolean)
: מציין את מצב ברירת המחדל של הפעלת הצליל מודעות באנר, מודעות מעברון ומודעות מתגמלות.
קוד לדוגמה ליצירת בקשה להצגת מודעה שמגדיר את הפרמטרים האלה:
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-Line, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות ResponseInfo
בקטגוריות הבאות:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
הנה הקודים וההודעות הנלוות שמוצגות על ידי מתאם הקו כאשר טעינת המודעה נכשלה:
Android
קוד שגיאה | דומיין | סיבה |
---|---|---|
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 | הטעינה של מודעה מותאמת נכשלה כי חסרים נכסים. |
iOS
קוד שגיאה | דומיין | סיבה |
---|---|---|
1-10 | נשלח על ידי Line SDK | ה-SDK של Line החזיר שגיאה ספציפית ל-SDK. צפייה מסמכי התיעוד של Line אפשר לקבל פרטים נוספים. |
101 | com.google.ads.mediation.line | פרמטרים לא חוקיים של השרת (למשל מזהה אפליקציה או מזהה מיקום חסר). |
102 | com.google.ads.mediation.line | גודל המודעה המבוקש לא תואם לגודל מודעת הבאנר שנתמך ב-Line. |
103 | com.google.ads.mediation.line | הטעינה של נכס התמונות סמל מידע במודעה המותאמת נכשלה. |
יומן שינויים בפלאגין של Line Unity Mediation
גרסה 1.3.1
- תומכת בגרסה 2.8.20240808.0 של קו ל-Android של קו.
- תומכת בגרסה 2.8.20240612.0 של מתאם ל-iOS של קו.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.
גרסה 1.3.0
- תמיכה במתאם Line ל-Android בגרסה 2.8.20240722.0.
- תומכת בגרסה 2.8.20240612.0 של מתאם ל-iOS של קו.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.2.0.
גרסה 1.2.0
- התמיכה מתבצעת במתאם Line ל-Android בגרסה 2.7.20240515.0.
- תמיכה במתאם Line ל-iOS בגרסה 2.8.20240612.0.
- נוצר ונבדק באמצעות גרסה 9.1.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.1.2
- התמיכה מתבצעת במתאם Line ל-Android בגרסה 2.7.20240515.0.
- תומכת בגרסה 2.7.20240411.0 של קו מתאם iOS.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.1.1
- תמיכה במתאם Line ל-Android בגרסה 2.7.20240214.1.
- תומכת בגרסה 2.7.20240411.0 של קו מתאם iOS.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.1.0
- נוספה הכיתה
LineMediationExtras
עם השיטות הבאות כדי לתמוך בהעברת נתונים נוספים של תהליך בחירת הרשת.SetEnabledAdSound(bool)
- תומכת בגרסה 2.7.20240214.1 של קו ל-Android של קו.
- תמיכה במתאם Line ל-iOS בגרסה 2.7.20240318.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 1.0.0
- גרסה ראשונית.
- תומכת בגרסה 2.6.20230607.0 של מתאם קו ל-Android.
- תומכת בגרסה 2.6.20230609.0 של קו מתאם iOS.
- נוצר ונבדק באמצעות גרסה 8.5.1 של פלאגין Unity של המודעות לנייד של Google.