במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-LINE Ads Network באמצעות גישור, כולל שילובים של waterfall. המאמר כולל הסבר על הוספת LINE Ads Network להגדרת הגישור של יחידת מודעות, ועל שילוב של LINE Ads Network SDK ומתאם באפליקציית Flutter.
שילובים נתמכים ופורמטים נתמכים של מודעות
מתאם תהליך בחירת הרשת של Ad Manager עבור LINE Ads Network כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
מודעת באנר | |
מעברון | |
ההטבה הופעלה | |
מותאם | 1 |
1 מודעות מותאמות (לבידינג) נמצאות בגרסת בטא סגורה. כדי לבקש גישה, צריך לפנות למנהל החשבון.
דרישות
- הגרסה העדכנית של Google Mobile Ads SDK
- Flutter 3.7.0 ומעלה
- כדי לפרוס ב-Android
- רמת API 23 ואילך ב-Android
- כדי לפרוס ב-iOS
- יעד הפריסה של iOS הוא 12.0 ומעלה
- פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה עם Service Management API.
- צריך לקרוא את המדריך לתחילת העבודה עם תהליך בחירת הרשת (Mediation).
שלב 1: הגדרת תצורות בממשק המשתמש של LINE Ads Network
נרשמים ומתחברים לחשבון LINE Ads Network.
הוספת אפליקציה חדשה
לוחצים על 広告枠管理 (ניהול מיקומי מודעות בדף) > メディア (מדיה). אחר כך לוחצים על 新規作成 (Create New).
ממלאים את הטופס ולוחצים על 登録 (הרשמה).
חשוב לשים לב למזהה האפליקציה.
יצירת מיקום מודעה
לוחצים על המזהה של האפליקציה שרוצים להוסיף לה מיקום מודעה. לאחר מכן, בוחרים באפשרות 詳細 (פירוט).
לוחצים על スロット 追加 (הוספת מיקום מודעה בדף).
ממלאים את הטופס כדי לקבל פרטים על משבצת הזמן. בקטע סוג הבידינג, בוחרים באפשרות רגיל כדי להגדיר את משבצת המודעה הזו לשרשור (Waterfall) או באפשרות בידינג מבוסס SDK חיצוני של Google כדי להגדיר את משבצת המודעה הזו לבידינג. אחרי שממלאים את הטופס, לוחצים על 登録 (הרשמה).
רושמים את מזהה מיקום המודעה.
עדכון של קובץ app-ads.txt
Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt
.
אם עדיין לא עשיתם זאת, צרו קובץ app-ads.txt ל-Ad Manager.
כדי להטמיע את app-ads.txt
ברשת המודעות של LINE, אפשר לעיין במאמר מידע על app-ads.txt.
שלב 2: הגדרת הביקוש של LINE Ads Network בממשק המשתמש של Ad Manager
הגדרת הגדרות הגישור ליחידת המודעות
Android
הוראות מפורטות מופיעות בשלב 2 במדריך ל-Android.
iOS
הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.
שלב 3: מייבאים את ה-SDK ואת המתאם של LINE Ads Network
שילוב דרך pub.dev
מוסיפים את התלות הבאה עם הגרסאות האחרונות של LINE Ads Network SDK ומתאם בקובץ pubspec.yaml
של החבילה:
dependencies:
gma_mediation_line: ^
שילוב ידני
מורידים את הגרסה העדכנית של הפלאגין לבחירת רשת של Google Mobile Ads עבור LINE Ads Network, מחלצים את הקובץ שהורד ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את התלות הבאה לקובץ pubspec.yaml
כדי להפנות אל הפלאגין:
dependencies:
gma_mediation_line:
path: path/to/local/package
שלב 4: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב עם LINE Ads Network.
iOS
שילוב של SKAdNetwork
פועלים לפי התיעוד של LINE Ads Network כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 5: בדיקת ההטמעה
הפעלת מודעות בדיקה
חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות לבדיקה מ-LINE Ads Network, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות LINE Ads Network (Waterfall).
שלבים אופציונליים
פרמטרים ספציפיים לרשת
התוסף לבחירת רשת (Mediation) של LINE 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],
);
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-LINE Ads Network, בעלי האתרים יכולים לבדוק את השגיאה הבסיסית בתגובה למודעה באמצעות ResponseInfo
במחלקות הבאות:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
אלה הקודים וההודעות הנלוות שמוחזרים על ידי מתאם LINE Ads Network כשהטעינה של מודעה נכשלת:
Android
קוד שגיאה | דומיין | סיבה |
---|---|---|
1-10 | com.five_corp.ad | LINE Ads Network SDK החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של LINE Ads Network. |
101 | com.google.ads.mediation.line | מזהה האפליקציה חסר או לא תקין. |
102 | com.google.ads.mediation.line | מזהה מיקום המודעה חסר או לא תקין. |
103 | com.google.ads.mediation.line | גודל המודעה המבוקש לא תואם לגודל מודעת באנר נתמך ב-LINE Ads Network. |
104 | com.google.ads.mediation.line | טעינת מודעה מתגמלת או מודעת ביניים נכשלה בגלל שחסר הקשר של הפעילות. |
105 | com.google.ads.mediation.line | LINE Ads Network SDK נכשל בהצגת מודעת מעברון או מודעה מתגמלת. |
106 | com.google.ads.mediation.line | טעינת מודעה מותאמת נכשלה בגלל נכסים חסרים. |
iOS
קוד שגיאה | דומיין | סיבה |
---|---|---|
1-10 | נשלח על ידי LINE Ads Network SDK | LINE Ads Network SDK החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של LINE Ads Network. |
101 | com.google.ads.mediation.line | פרמטרים לא תקינים של השרת (למשל, מזהה אפליקציה או מזהה מיקום חסרים). |
102 | com.google.ads.mediation.line | גודל המודעה המבוקש לא תואם לגודל מודעת באנר נתמך ב-LINE Ads Network. |
103 | com.google.ads.mediation.line | טעינת נכס התמונה של סמל המידע במודעה המקורית נכשלה. |
יומן השינויים של המתאם לתהליך בחירת הרשת Line Flutter
גרסה 1.0.4 (בתהליך)
גרסה 1.0.3
- תמיכה בגרסה 2.9.20250519.0 של מתאם Line ל-Android.
- תמיכה בגרסה 2.9.20250512.0 של מתאם Line ל-iOS.
- נוצר ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0
גרסה 1.0.2
- תמיכה בגרסה 2.9.20250317.1 של מתאם Line ל-Android.
- תמיכה בגרסה 2.9.20241106.3 של מתאם Line ל-iOS.
- נוצר ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0
גרסה 1.0.1
- תמיכה בגרסה 2.9.20250110.1 של מתאם Line ל-Android.
- תמיכה בגרסה 2.9.20241106.2 של מתאם Line ל-iOS.
- התוסף נוצר ונבדק באמצעות גרסה 5.3.1 של Google Mobile Ads Flutter Plugin.
גרסה 1.0.0
- זו הגרסה הראשונה.
- תמיכה בגרסה 2.9.20250110.0 של מתאם Line ל-Android.
- תמיכה בגרסה 2.9.20241106.1 של מתאם Line ל-iOS.
- התוסף נוצר ונבדק באמצעות גרסה 5.3.1 של Google Mobile Ads Flutter Plugin.