שילוב של 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
    • רמת API ב-Android‏ 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.

    הוספת משבצת

    ממלאים את הטופס עם פרטים על המשבצת. בקטע סוג הבידינג, בוחרים באפשרות רגיל כדי להגדיר את משבצת הפרסום הזו לגישור בשיטת Waterfall, או באפשרות בידינג מבוסס SDK חיצוני של Google כדי להגדיר את משבצת הפרסום הזו לבידינג. אחרי שממלאים את הטופס, לוחצים על יצירה.

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

    שימו לב לערך של מזהה המיקום.

    פרטי מיקום המודעה

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

    בקשת בדיקה

    יצירת מפתח Reporting API

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

    הכרטיסייה Reporting API Key

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

    טופס מפתח 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 (ההגדרות של מנהל החבילות ב-Unity).

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

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

    פרטי OpenUPM

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

    Unity Registries

    בוחרים בחבילה 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 ה-SDK של רשת המודעות LY החזיר שגיאה ספציפית ל-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 היה כשל ב-LY Ads Network SDK בהצגת מודעת מעברון או מודעה מתגמלת.
    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