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

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

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

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

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

1 Integration of bidding is in closed beta, reach out to your account manager to request access.

דרישות

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

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

נכנסים לחשבון LINE Ads Network.

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

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

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

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

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

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

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

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

שימו לב למזהה המיקום.

עדכון קובץ 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 Ads Network, אפשר לעיין במאמר מידע על קובץ app-ads.txt.

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

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

Android

להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.

iOS

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

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

שילוב דרך pub.dev

מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK והמתאם של LINE Ads Network בקובץ 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: בדיקה מעשית של ההטמעה

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

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

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

כדי לוודא שאתם מקבלים מודעות לבדיקה מרשת LINE Ads Network, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות LINE Ads Network (Waterfall).

שלבים אופציונליים

פרמטרים ספציפיים לרשת

הפלאגין של LINE Ads Network לבחירת רשת (Mediation) ב-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 ה-SDK של LINE Ads Network החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של LINE Ads Network.
101 com.google.ads.mediation.line מזהה האפליקציה חסר או לא תקין.
102 com.google.ads.mediation.line מזהה מקום מודעה חסר או לא תקין.
103 com.google.ads.mediation.line גודל המודעה המבוקש לא תואם לגודל מודעת הבאנר שנתמך ברשת LINE Ads.
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 ה-SDK של LINE Ads Network החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של LINE Ads Network.
101 com.google.ads.mediation.line פרמטרים לא חוקיים של שרת (למשל, חסר מזהה אפליקציה או מזהה משבצת).
102 com.google.ads.mediation.line גודל המודעה המבוקש לא תואם לגודל מודעת הבאנר שנתמך ברשת LINE Ads.
103 com.google.ads.mediation.line לא ניתן לטעון נכס תמונה של סמל מידע במודעה רגילה.

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

גרסה 1.0.2

גרסה 1.0.1

גרסה 1.0.0