במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Line באמצעות תהליך בחירת הרשת (Mediation), שילובים של Waterfall. המאמר מסביר איך להוסיף את השורה של יחידת מודעות הגדרת הגישור ואיך לשלב את Line SDK והמתאם לאפליקציה של Unity.
השילובים והפורמטים של המודעות שנתמכים
AdMob מתאם הגישור של קו כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | 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 לתהליך בחירת הרשת (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: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob
פועלים לפי ההוראות במסמכי התיעוד של במסמכי התיעוד של 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 | 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.2.0
- תומכת בגרסה 2.7.20240515.0 של מתאם קו ל-Android.
- תומכת בגרסה 2.8.20240612.0 של מתאם ל-iOS של קו.
- נוצר ונבדק באמצעות גרסה 9.1.1 של פלאגין Google Mobile Ads Unity.
גרסה 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.