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

הפלטפורמה: Android iOS Unity Flutter

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

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

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

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

‫1 מודעות מותאמות (לבידינג) נמצאות בגרסת בטא סגורה. כדי לבקש גישה, צריך לפנות למנהל החשבון.

דרישות

  • הגרסה העדכנית של Google Mobile Ads SDK
  • ‫Flutter 3.7.0 ומעלה
  • כדי לפרוס ב-Android
    • רמת API ‏23 ומעלה ב-Android
  • כדי לפרוס ב-iOS
    • יעד פריסה 12.0 ומעלה ב-iOS
  • פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads SDK. פרטים נוספים מופיעים במאמר בנושא תחילת העבודה.
  • ביצוע של תהליך בחירת הרשת מדריך לתחילת העבודה

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

נרשמים ומתחברים לחשבון LINE Ads Network.

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

לוחצים על 広告枠管理 (ניהול מיקומי מודעות בדף) > メディア (מדיה). אחר כך לוחצים על 新規作成 (Create New).

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

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

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

לוחצים על המזהה של האפליקציה שרוצים להוסיף לה מיקום מודעה. לאחר מכן בוחרים באפשרות 詳細 (פירוט).

לוחצים על スロット 追加 (הוספת מיקום מודעה בדף).

ממלאים את הטופס כדי לקבל פרטים על משבצת הזמן. בקטע Bidding Type (סוג הבידינג), בוחרים באפשרות Standard (רגיל) כדי להגדיר את משבצת המודעה הזו לגישור בשיטת Waterfall, או באפשרות Google SDK Bidding (בידינג מבוסס SDK חיצוני של Google) כדי להגדיר את משבצת המודעה הזו לבידינג. אחרי שממלאים את הטופס, לוחצים על 登録 (הרשמה).

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

עדכון של הקובץ app-ads.txt

‫ Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.

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

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

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

Android

הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.

iOS

הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

שלב 3: מייבאים את ה-SDK ואת המתאם של LINE Ads Network

שילוב דרך pub.dev

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

dependencies:
  gma_mediation_line: ^1.0.4

שילוב ידני

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

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

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

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

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-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.5 (בפיתוח)

גרסה 1.0.4

גרסה 1.0.3

גרסה 1.0.2

גרסה 1.0.1

גרסה 1.0.0