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

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

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

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

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

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

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

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

  • הגרסה העדכנית של Google Mobile Ads Flutter Plugin.
  • ‫Flutter framework בגרסה 3.7.0 ואילך.
  • כדי לפרוס ב-Android
    • ‫Android API ברמה 24 ואילך.
  • כדי לפרוס ב-iOS
    • יעד פריסה 13.0 ומעלה ב-iOS.
  • פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads Flutter Plugin. פרטים נוספים מופיעים במאמר הגדרת Google Mobile Ads Flutter 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

    שילוב דרך pub.dev

    מוסיפים את התלות הבאה עם הגרסאות העדכניות של ה-SDK והמתאם של LY Ads Network בקובץ pubspec.yaml של החבילה:

    dependencies:
  gma_mediation_line: ^2.2.1

    שילוב ידני

    מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור LY Ads Network, מחלצים את הקובץ שירד ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט ה-Flutter. לאחר מכן, מוסיפים את התלות הבאה לקובץ pubspec.yaml כדי להפנות אל הפלאגין:

    dependencies:
  gma_mediation_line:
    path: path/to/local/package

    ‫שלב 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 לתהליך בחירת הרשת ב-Flutter תומך בפרמטר הבא של בקשה נוספת, שאפשר להעביר למתאם דרך המחלקה LineMediationExtras:

    • ‫enableAdSound : מציין את מצב ברירת המחדל של הפעלת הצליל במודעות באנר, במודעות מעברון ובמודעות מתגמלות.

    הנה דוגמה לקוד שיוצר בקשה להצגת מודעה שמגדירה את הפרמטרים האלה:

    LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [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 ל-Flutter

    גרסה 2.2.2 (בפיתוח)

    • עכשיו נדרשת גרסת iOS מינימלית של 15.0.

    גרסה 2.2.1

    גרסה 2.2.0

    גרסה 2.1.3

    גרסה 2.1.2

    גרסה 2.1.1

    ‫גרסה 2.1.0

    גרסה 2.0.0

    גרסה 1.0.6

    גרסה 1.0.5

    גרסה 1.0.4

    ‫גרסה 1.0.3

    ‫גרסה 1.0.2

    גרסה 1.0.1

    גרסה 1.0.0