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

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

Log in to your Line account.

Add a new application

Click 広告枠管理 (Ad Slot Management) > メディア (Media). Then, click 新規作成 (Create New).

Fill out the form and click 登録 (Register).

Take note of the Application ID.

Create an ad placement

Click the ID of the application you want to add an ad placement. Then, select 詳細 (Detail).

Click スロット 追加 (Add Slot).

Fill out the form and once done, click (登録) Register.

Take note of the Slot ID.

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

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

Android

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

iOS

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

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

גרסה 1.1.2

גרסה 1.1.1

גרסה 1.1.0

גרסה 1.0.0