שילוב של LY Ads Network עם תהליך בחירת הרשת

בחירת פלטפורמה: Android iOS Unity Flutter Android (גרסה קודמת)

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads Unity Plugin כדי לטעון ולהציג מודעות מ-LY Ads Network באמצעות תהליך בחירת הרשת (Mediation), כולל שילובים של שיטת ה-Waterfall. המאמר מסביר איך להוסיף את LY Ads Network להגדרה של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של LY Ads Network באפליקציית Unity.

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

המתאם של תהליך בחירת הרשת ב-Ad Manager ל-LY Ads Network כולל את היכולות הבאות:

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

דרישות מוקדמות

לפני שממשיכים, צריך לוודא את הפרטים הבאים:

  • הגרסה העדכנית של Google Mobile Ads Unity Plugin.
  • ‫Unity Editor בגרסה 4 ואילך.
  • ‫[לבידינג]: כדי לשלב את כל הפורמטים הנתמכים של המודעות בבידינג, צריך להשתמש בפלאגין של Google Mobile Ads לתהליך בחירת הרשת ב-LY Ads Network בגרסה 1.5.0 ואילך (מומלץ להשתמש בגרסה העדכנית).
  • כדי לפרוס ב-Android
    • ‫Android API ברמה 24 ואילך.
  • כדי לפרוס ב-iOS
    • יעד פריסה 13.0 ומעלה ב-iOS.
  • פרויקט Unity פעיל שמוגדר עם Google Mobile Ads Unity Plugin. פרטים נוספים מופיעים במאמר הגדרת Google Mobile Ads Unity Plugin.
  • הגדרת תהליך בחירת הרשת.

    • שלב 1: הגדרת התצורה בממשק המשתמש של רשת המודעות LY Ads Network

    נרשמים ונכנסים לחשבון ב-LY Ads Network.

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

    עוברים לכרטיסייה App ולוחצים על הכפתור New registration.

    רישום חדש

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

    טופס הרשמה חדש

    שימו לב למזהה האפליקציה.

    Android

    פרטי רישום

    iOS

    פרטי רישום

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

    בכרטיסייה אפליקציה, בוחרים את האפליקציה כדי לראות את הפרטים שלה. בקטע Slot, לוחצים על Add.

    הוספת משבצת

    ממלאים את הטופס עם פרטים על המשבצת. בקטע Bidding Type (סוג הבידינג), בוחרים באפשרות Standard (רגיל) כדי להגדיר את המיקום הזה לרשימת רשתות בתהליך בחירת רשת, או באפשרות Google SDK Bidding (בידינג מבוסס SDK חיצוני של Google) כדי להגדיר את המיקום הזה לבידינג. אחרי שממלאים את הטופס, לוחצים על יצירה.

    טופס להוספת משבצת

    שימו לב למזהה המשבצת.

    פרטי המיקום

    אחרי שיוצרים את מיקום המודעה הראשון, לוחצים על בדיקה בדף הפרטים של האפליקציה כדי לקבל אישור מרשת המודעות של LY. יכול להיות שזה ייקח קצת זמן. אם יש לכם שאלות, אתם יכולים לפנות לנציג של LY Ads Network.

    בקשת בדיקה

    יצירת מפתח Reporting API

    עוברים לכרטיסייה Managing reporting מפתחות API ולוחצים על הכפתור Create מפתח API.

    הכרטיסייה "מפתח Reporting API"

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

    טופס מפתח Reporting API

    שימו לב ל-API Key ID (מזהה מפתח ה-API) ול-API Key Secret (סוד מפתח ה-API).

    טופס מפתח Reporting API

    עדכון של הקובץ app-ads.txt

    ‫ Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, צרו קובץ app-ads.txt ל-Ad Manager.

    כדי להטמיע את app-ads.txt ב-LY Ads Network, עיינו במאמר מידע על app-ads.txt.

    שלב 2: מגדירים את הביקוש של LY Ads Network בממשק המשתמש של Ad Manager

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

    Android

    הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.

    iOS

    הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

    שלב 3: מייבאים את ה-SDK והמתאם של LY Ads Network

    OpenUPM-CLI

    אם התקנתם את OpenUPM-CLI, אתם יכולים להתקין בפרויקט את הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-LY Ads Network ל-Unity. כדי לעשות את זה, מריצים את הפקודה הבאה מספריית השורש של הפרויקט:

    openupm add com.google.ads.mobile.mediation.line

    OpenUPM

    בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit > Project Settings > Package Manager כדי לפתוח את Unity Package Manager Settings.

    בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמרשם מוגדר עם הפרטים הבאים:

    • שם: OpenUPM
    • כתובת אתר: https://package.openupm.com
    • היקף ההרשאות: com.google

    פרטי OpenUPM

    אחר כך עוברים אל Window (חלון) > Package Manager (מנהל החבילות) כדי לפתוח את Unity Package Manager (מנהל החבילות של Unity) ובוחרים באפשרות My Registries (המרשמים שלי) בתפריט הנפתח.

    מאגרי Unity

    בוחרים את החבילה Google Mobile Ads Line Mediation ולוחצים על Install.

    התקנה מ-OpenUPM

    חבילת Unity

    מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור LY Ads Network מרשת מודעות מהקישור להורדה ביומן השינויים, ומחלצים את הקובץ GoogleMobileAdsLineMediation.unitypackage מקובץ ה-ZIP.

    בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets (נכסים) > Import Package (ייבוא חבילה) > Custom Package (חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsLineMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על Import.

    ייבוא מ-Unity

    אחר כך בוחרים באפשרות Assets (נכסים) > External Dependency Manager (מנהל יחסי תלות חיצוניים) > Android Resolver (מזהה Android) > Force Resolve (זיהוי מאולץ). ספריית External Dependency Manager תפתור את יחסי התלות מאפס ותעתיק את יחסי התלות שהוצהרו לספרייה Assets/Plugins/Android של אפליקציית Unity.

    אילוץ פתרון

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

    Android

    לא נדרש קוד נוסף כדי לשלב את LY Ads Network.

    iOS

    שילוב של SKAdNetwork

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

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

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

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

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

    כדי לוודא שאתם מקבלים מודעות לבדיקה מ-LY Ads Network, הפעילו בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות של LY Ads Network.

    שלבים אופציונליים

    פרמטרים ספציפיים לרשת

    הפלאגין של LY Ads Network לתהליך בחירת הרשת ב-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);

    קודי שגיאה

    אם המתאם לא מצליח לקבל מודעה מ-LY Ads Network, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות ResponseInfo במחלקות הבאות:

    Android

    com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

    iOS

    GADMediationAdapterLine

    אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של LY Ads Network כשהטעינה של מודעה נכשלת:

    Android

    קוד שגיאה דומיין סיבה
    1-10 com.five_corp.ad ‫LY Ads Network SDK החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של LY Ads Network.
    101 com.google.ads.mediation.line מזהה האפליקציה חסר או לא תקין.
    102 com.google.ads.mediation.line מזהה המיקום חסר או לא תקין.
    103 com.google.ads.mediation.line גודל המודעה המבוקש לא תואם לגודל של מודעת באנר שנתמך ב-LY Ads Network.
    104 com.google.ads.mediation.line המודעה לא נטענה כי חסר הקשר לפעילות.
    105 com.google.ads.mediation.line ה-SDK של רשת המודעות LY לא הצליח להציג מודעת מעברון או מודעה מתגמלת.
    106 com.google.ads.mediation.line המודעה המותאמת לא נטענה כי חסרים נכסים.
    107 com.google.ads.mediation.line ‫FiveAd SDK החזיר טוען מודעות מסוג null.

    iOS

    קוד שגיאה דומיין סיבה
    1-10 נשלח על ידי LY Ads Network SDK ‫LY Ads Network SDK החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של LY Ads Network.
    101 com.google.ads.mediation.line פרמטרים לא תקינים של השרת (למשל, מזהה אפליקציה או מזהה מיקום מודעה חסרים).
    102 com.google.ads.mediation.line גודל המודעה המבוקש לא תואם לגודל של מודעת באנר שנתמך ב-LY Ads Network.
    103 com.google.ads.mediation.line נכס התמונה של סמל המידע לא נטען במודעה מותאמת.
    104 com.google.ads.mediation.line איסוף האותות לבידינג נכשל.
    105 com.google.ads.mediation.line האתחול של טוען המודעות ב-LINE Ads SDK נכשל.

    יומן השינויים של הפלאגין של Line לתהליך בחירת הרשת ב-Unity

    גרסה 2.2.1

    גרסה 2.2.0

    גרסה 2.1.1

    גרסה 2.1.0

    גרסה 2.0.2

    גרסה 2.0.1

    גרסה 2.0.0

    גרסה 1.5.10

    גרסה 1.5.9

    גרסה 1.5.8

    גרסה 1.5.7

    גרסה 1.5.6

    גרסה 1.5.5

    • תוקנה בעיה שבה התקנה דרך OpenUPM גרמה לכך שהפלאגין לא ייבא את החבילות כמו שצריך.

    גרסה 1.5.4

    גרסה 1.5.3

    גרסה 1.5.2

    גרסה 1.5.1

    גרסה 1.5.0

    גרסה 1.4.0

    גרסה 1.3.1

    גרסה 1.3.0

    גרסה 1.2.0

    גרסה 1.1.2

    גרסה 1.1.1

    גרסה 1.1.0

    גרסה 1.0.0