שילוב של 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
    • רמת API ב-Android‏ 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 חיצוני) כדי להגדיר את המיקום הזה לבידינג. אחרי שממלאים את הטופס, לוחצים על יצירה.

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

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

    פרטי המיקום

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

    בקשת בדיקה

    יצירת מפתח Reporting API

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

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

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

    טופס מפתח Reporting API

    חשוב לשים לב למזהה מפתח ה-API ולסוד מפתח ה-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 בממשק המשתמש של 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 ה-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 ה-SDK של רשת המודעות LY לא הצליח להציג מודעת מעברון או מודעה מתגמלת.
    106 com.google.ads.mediation.line המודעה המותאמת לא נטענה כי חסרים נכסים.
    107 com.google.ads.mediation.line ‫FiveAd SDK החזיר טוען מודעות ריק.

    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