שילוב של 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.

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

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

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

דרישות

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

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

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

עוברים לכרטיסייה App (אפליקציה) ולוחצים על הלחצן New registration (רישום חדש).

הרשמה חדשה

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

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

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

Android

פרטי רישום

iOS

פרטי רישום

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

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

הוספת משבצת

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

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

שלב 2: הגדרת הביקוש של רשת LY Ads בממשק המשתמש של AdMob

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

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: בדיקת ההטמעה

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

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

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

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-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