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

במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Line באמצעות תהליך בחירת הרשת, כולל שילובים של רשתות מודעות לפי סדר עדיפות. במדריך מוסבר איך להוסיף את Line להגדרת בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של Line באפליקציה של Unity.

השילובים והפורמטים של המודעות הנתמכים

ל Ad Manager מתאם בחירת הרשת ל-Line יש את היכולות הבאות:

שילוב
בידינג
מפל  1
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה

1 Integration of Waterfall is in closed beta, reach out to your account manager to request access.

דרישות

  • Unity 4 ומעלה
  • הגרסה העדכנית ביותר של Google Mobile Ads SDK
  • כדי לפרוס ב-Android
    • Android API ברמה 21 ואילך
  • לפריסה ב-iOS
    • יעד הפריסה של iOS מגרסה 12.0 ואילך
  • פרויקט Unity פעיל שהוגדרה בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
  • קוראים את המדריך לתחילת העבודה בנושא תהליך בחירת הרשת (Mediation)

שלב 1: הגדרת ההגדרות בממשק המשתמש של Line

מתחברים לחשבון Line.

הוספת אפליקציה חדשה

לוחצים על 広告枠管理 (ניהול משבצת מודעה) > でア (מדיה). לאחר מכן לוחצים על 新規作成 (יצירת חדש).

ממלאים את הטופס ולוחצים על 登録 (רישום).

חשוב לשים לב למזהה הבקשה.

יצירת מיקום מודעה

לוחצים על המזהה של האפליקציה שבה רוצים להוסיף מיקום מודעה. לאחר מכן, בוחרים באפשרות 詳細 (פרטים).

לוחצים על スロット 追加 (הוספת מיקום מודעה).

ממלאים את הטופס ולוחצים על (登録) הרשמה.

חשוב לזכור את מזהה המיקום.

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

קביעת הגדרות של תהליך בחירת הרשת (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.

לאחר מכן, בוחרים באפשרות נכסים > פותר של Play Services > פותר של Android > פתרון בכוח. ספריית Unity Play Services resolver תבצע רזולוציית תלות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android באפליקציית Unity.

שלב 4: מוסיפים את הקוד הנדרש

Android

לא נדרש קוד נוסף לשילוב עם Line.

iOS

שילוב עם SKAdNetwork

פועלים לפי המסמכים של Line כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.

שלב 5: בדיקה מעשית של ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ב-AdMob.

צריך לפעול לפי ההוראות במסמכי התיעוד של Android וב-iOS לגבי הפעלה של מודעות לבדיקת שורה.

אימות מודעות לבדיקה

כדי לוודא שאתם מקבלים מודעות בדיקה משורה, עליכם להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות השורה (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

אלה הקודים וההודעות שמתקבלים מהמתאם של Line כשלא ניתן לטעון מודעה:

Android

קוד שגיאה דומיין סיבה
1-10 com.five_corp.ad ה-SDK של Line החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של Line.
101 com.google.ads.mediation.line מזהה האפליקציה חסר או לא תקין.
102 com.google.ads.mediation.line המזהה של מיקום המודעה חסר או לא תקין.
103 com.google.ads.mediation.line גודל המודעה המבוקש לא תואם לגודל מודעת הבאנר שנתמך ב-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

גרסה 1.3.0

גרסה 1.2.0

גרסה 1.1.2

גרסה 1.1.1

גרסה 1.1.0

גרסה 1.0.0