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

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

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

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

למתאם תהליך בחירת הרשת (Mediation) של קו יש את היכולות הבאות:

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

¹ שילוב Waterfall נמצא בגרסת בטא סגורה. תוכלו לפנות למנהל החשבון שלכם ולבקש גישה.

דרישות

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

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

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

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

מתחברים לחשבון Line.

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

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

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

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

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

מבצעים את אותם השלבים כדי ליצור מיקומי מודעות לשילוב של בידינג וגם של Waterfall. אפשר להשתמש בכל מיקום מודעה בשני היעדים האלה.

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

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

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

הערה: כדי לקבל גישה ליצירת מיקומי מודעות מותאמות בממשק המשתמש של Line, עליכם לפנות למנהל החשבון שלכם ברשת Line Ads.

חשוב לזכור את מזהה המיקום.

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

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

הערה: אם לא משלבים בין הגרסאות התואמות של Line ו-Google Mobile Ads SDK, יכול להיות שיהיו בעיות ב-build.

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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

שילוב ידני

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

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

שילוב עם SKAdNetwork

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

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

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

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

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

adAudio

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

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

Swift

import LineAdapter
// ...

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

Objective-C

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

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

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

עיבוד מודעות

מתאם השורה מאכלס את השדות הבאים: השדות של GADNativeAd

שדה	הנכסים תמיד נכללים במתאם הקו
כותרת
תמונה
גוף
סמל האפליקציה	^1
קריאה לפעולה
Star rating
חנות
מחיר

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

קודי שגיאה

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

GADMediationAdapterLine

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

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

גרסה 2.7.20240214.0

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

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

• Google Mobile Ads SDK בגרסה 11.0.1.
• גרסת ה-SDK של FiveAd היא 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.