במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Line באמצעות תהליך בחירת הרשת (Mediation), שכולל שילובים ב-Waterfall. נסביר איך להוסיף את Line להגדרת הגישור של יחידת מודעות, ואיך לשלב את Line SDK והמתאם באפליקציית Unity.
השילובים והפורמטים של המודעות שנתמכים
AdMob למתאם הגישור של Line יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | 1 |
פורמטים | |
כרזה | |
פרסומת מרווח ביניים | |
ההטבה הופעלה |
1 שילוב Waterfall נמצא בגרסת בטא פתוחה.
דרישות
- Unity 4 ומעלה
- ה-SDK העדכני של Google Mobile Ads
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- מבצעים את ההוראות שבמדריך לתחילת העבודה.
שלב 1: קביעת ההגדרות בממשק המשתמש של Line
מתחברים לחשבון Line.
הוספת אפליקציה חדשה
לוחצים על 広告枠管理 (ניהול מיקומי מודעות) > 🧠デーア (Media). לאחר מכן, לוחצים על 「規作成 (Create New).
ממלאים את הטופס ולוחצים על 登録 (Register) (הרשמה).
חשוב לשים לב למזהה האפליקציה.
יצירת מיקום מודעה
לוחצים על מזהה האפליקציה שבה רוצים להוסיף מיקום מודעה. לאחר מכן בוחרים באפשרות 詳細 (פרטים).
לוחצים על スロッורג 追加 (הוספת מיקום מודעה).
ממלאים את הטופס, ובסיום לוחצים על (登録) Register (הרשמה).
חשוב לשים לב למזהה של מיקום המודעה.
שלב 2: הגדרת ביקוש לשורה AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
שלב 3: מייבאים את Line SDK והמתאם
מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads לבחירת רשת עבור Line מהקישור להורדה ב-Changelog ומחלצים את GoogleMobileAdsLineMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > Import Package >
Custom Package (חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsLineMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על Import.
לאחר מכן, בוחרים באפשרות Assets > Play Services Resolutionr > Android resolver >
אילוץ סגירה. ספריית Unity Play Services resolver תבצע רזולוציית תלות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android
באפליקציית Unity.
שלב 4: מוסיפים את הקוד הנדרש
Android
אין צורך בקוד נוסף לשילוב שורה.
iOS
שילוב של SKAdNetwork
פועלים לפי מסמכי התיעוד של Line כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob
פועלים לפי ההוראות במסמכי התיעוד של במסמכי התיעוד של Line Android וב-iOS כדי להבין איך להפעיל מודעות בדיקה של Line.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-Line, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Line (Waterfall) מקורות המודעות.
שלבים אופציונליים
פרמטרים ספציפיים לרשת
הפלאגין לבחירת רשת Line Unity תומך בפרמטר הבקשה הנוסף הבא, שאותו אפשר להעביר למתאם דרך המחלקה LineMediationExtras
:
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 | Line SDK החזירה שגיאה ספציפית ל-SDK. למידע נוסף, אפשר לעיין במסמכי התיעוד של Line. |
101 | com.google.ads.mediation.line | פרמטרים לא חוקיים של השרת (למשל מזהה אפליקציה או מזהה מיקום חסר). |
102 | com.google.ads.mediation.line | גודל המודעה המבוקש אינו תואם לגודל של מודעת באנר שנתמכת על ידי קו. |
103 | com.google.ads.mediation.line | הטעינה של נכס התמונות סמל מידע במודעה המותאמת נכשלה. |
יומן שינויים בפלאגין של Line Unity Mediation
גרסה 1.1.2
- תומכת בגרסה 2.7.20240515.0 של מתאם קו ל-Android.
- תומכת בגרסה 2.7.20240411.0 של קו מתאם iOS.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.1.1
- תומכת בגרסה 2.7.20240214.1 של קו ל-Android של קו.
- תומכת בגרסה 2.7.20240411.0 של קו מתאם iOS.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 1.1.0
- נוספה הכיתה
LineMediationExtras
בשיטות הבאות כדי לתמוך בהעברת תוספות לתהליך בחירת הרשת (Mediation).SetEnabledAdSound(bool)
- תומכת בגרסה 2.7.20240214.1 של קו ל-Android של קו.
- תומכת בגרסה 2.7.20240318.0 של מתאם ל-iOS של קו.
- נוצר ונבדק באמצעות גרסה 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.