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

בחירת פלטפורמה: Android חדש Android iOS Unity Flutter

במדריך הזה מוסבר איך להשתמש ב-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 3.7.0 ואילך
  • כדי לפרוס ב-Android
    • רמת API‏ 23 ומעלה ב-Android
  • כדי לפרוס ב-iOS
    • יעד פריסה 13.3 ומעלה ב-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.

הוספת משבצת

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

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

רושמים את מזהה מיקום המודעה.

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

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

בקשת בדיקה

יצירת מפתח API לדיווח

עוברים לכרטיסייה Managing reporting API keys (ניהול מפתחות Reporting API) ולוחצים על הלחצן Create API key (יצירת מפתח 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.1.0

שילוב ידני

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

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 טעינת נכס התמונה של סמל המידע במודעה המקורית נכשלה.

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

גרסה 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