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

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

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

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

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

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

דרישות

שלב 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

גרסה 1.0.2

גרסה 1.0.1

גרסה 1.0.0