שילוב שורה עם תהליך בחירת הרשת (Mediation) (בטא)

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

בממשק של לוח הבקרה של Line נעשה שימוש בטקסט יפני בתוויות, בלחצנים ובתיאורים. צילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות במדריך הזה, תוויות ולחצנים מתורגמים עם המקבילות שלהם באנגלית בסוגריים.

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

למתאם התהליך של Line יש את היכולות הבאות:

¹ Integration of Waterfall is in closed beta. You can contact your account manager to request access.

דרישות

• יעד הפריסה של iOS מגרסה 12.0 ואילך

• ה-SDK העדכני של Google Mobile Ads

• מדריך לתחילת העבודה בנושא בחירת הרשת

שלב 1: הגדרת ההגדרות בממשק המשתמש של Line

נכנסים לחשבון Line.

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

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

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

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

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

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

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

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

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

שלב 2: הגדרת ביקוש לקו ב- Ad Manager UI

שלב 3: מייבאים את ה-SDK ואת המתאם של Line

שימוש ב-CocoaPods (מומלץ)

מוסיפים את השורה הבאה ל-Podfile של הפרויקט:

pod 'GoogleMobileAdsMediationLine'

מריצים את הפקודה הבאה בשורת הפקודה:

pod install --repo-update

שילוב ידני

• מורידים את הגרסה האחרונה של Line SDK ומקשרים את FiveAd.framework בפרויקט.
• מורידים את הגרסה האחרונה של Line adapter מהקישור להורדה ביומן השינויים ומקשרים את LineAdapter.framework בפרויקט.

שלב 4: מוסיפים את הקוד הנדרש

שילוב עם SKAdNetwork

עליכם לפעול לפי מסמכי התיעוד של Line כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

שלב 5: בדיקה מעשית של ההטמעה

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

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

פועלים לפי ההוראות במסמכים של Line להפעלת מודעות לבדיקת קו.

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

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

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

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

מתאם הקו תומך בפרמטר בקשה נוסף שאפשר להעביר למתאם באמצעות הכיתה GADMediationAdapterLineExtras. הסיווג הזה כולל את המאפיינים (properties) הבאים:

adAudio

מציין את מצב ברירת המחדל של התחלת הצליל במודעות באנר, במודעות מעברון ובמודעות וידאו עם פרסים.

דוגמה לקוד ליצירת בקשה להצגת מודעה שמגדירה את הפרמטרים האלה:

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

#import <LineAdapter/LineAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

שימוש במודעות מותאמות

רינדור המודעות

מתאם השורות מאכלס את עבור GADNativeAd.

¹ במודעות מותאמות, Line SDK לא מספק נכס של סמל אפליקציה. במקום זאת, מתאם Line מאכלס את סמל האפליקציה בתמונה שקופה.

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-Line, אפשר לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות GADResponseInfo.adNetworkInfoArray במחלקות הבאות:

GADMediationAdapterLine

אלה הקודים וההודעות שמופיעים במתאם Line כשמודעה לא נטענת:

יומן השינויים של מתאם LINE לבחירת רשת (Mediation) ל-iOS

גרסה 2.8.20240827.1

• עדכנו את CFBundleShortVersionString כך שיכלול שלושה רכיבים במקום ארבעה.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.10.0.
• FiveAd SDK גרסה 2.8.20240827.

גרסה 2.8.20240827.0

• תאימות מאומתת עם FiveAd SDK בגרסה 2.8.20240827.
• הוספנו תמיכה בבידינג בפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.8.0.
• גרסת FiveAd SDK‏ 2.8.20240827.

גרסה 2.8.20240612.0

• הוספנו שליטה באודיו של מודעות מותאמות באמצעות GADVideoOptions.
• תאימות מאומתת ל-FiveAd SDK גרסה 2.8.20240612.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK גרסה 11.5.0.
• גרסת FiveAd SDK‏ 2.8.20240612.

גרסה 2.7.20240411.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240411.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.3.0.
• FiveAd SDK גרסה 2.7.20240411.

גרסה 2.7.20240318.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240318.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.2.0.
• גרסת ה-SDK של FiveAd היא 2.7.20240318.

גרסה 2.7.20240214.1

• עכשיו נדרשת גרסת iOS מגרסה 12.0 ואילך.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
• Info.plist נכלל במסגרות שב-LineAdapter.xcframework.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK בגרסה 11.0.1.
• גרסת ה-SDK של FiveAd היא 2.7.20240214.

גרסה 2.7.20240214.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240214.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK בגרסה 11.0.1.
• FiveAd SDK גרסה 2.7.20240214.

גרסה 2.7.20240126.0

• תאימות מאומתת ל-FiveAd SDK גרסה 2.7.20240126.
• עדכנו את הטמעת המתאם עם פרוטוקולים חדשים של FiveAd SDK.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.14.0.
• גרסת ה-SDK של FiveAd היא 2.7.20240126.

גרסה 2.7.20231115.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20231115.
• הכותרת GADMediationAdapterLineExtras כלולה ב-modulemap.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.14.0.
• גרסת FiveAd SDK‏ 2.7.20231115.

גרסה 2.6.20230609.1

• הוספת את GADMediationAdapterLineAudioState כדי לנהל את מצב האודיו הראשוני של הבאנר, המעברון והמודעות המתגמלות כשהם מוצגים בפעם הראשונה.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK בגרסה 10.14.0.
• גרסת FiveAd SDK‏ 2.6.20230609.

גרסה 2.6.20230609.0

• זו הגרסה הראשונה
• נוספה תמיכה ב-Waterfall בפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
• תאימות מאומתת ל-FiveAd SDK גרסה 2.6.20230609.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.9.0.
• גרסת FiveAd SDK‏ 2.6.20230609.