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

במדריך הזה מוסבר איך להשתמש ב-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) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

שלב 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

גרסה 1.1.1

גרסה 1.1.0

גרסה 1.0.0