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

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

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

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

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

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

דרישות

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

• [לצורכי בידינג]: כדי לשלב את כל הפורמטים הנתמכים של המודעות בבידינג, צריך להשתמש במתאם של LINE Ads Network מגרסה 2.8.20240827.0 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)

• הגרסה העדכנית ביותר של Google Mobile Ads SDK

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

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

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

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

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

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

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

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

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

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

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

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

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

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

צריך להוסיף את LINE Ads Network להגדרות בחירת הרשת של יחידת המודעות.

קודם כול, נכנסים לחשבון AdMob. לאחר מכן, עוברים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש לכם קבוצה קיימת לבחירת רשת (Mediation) שאתם רוצים לשנות, לוחצים על השם שלה כדי לערוך אותה ודלגים לקטע הוספת LINE Ads Network כמקור מודעות.

כדי ליצור קבוצה חדשה לבחירת רשת, בוחרים באפשרות יצירת קבוצה לבחירת רשת.

מזינים את פורמט המודעה ואת הפלטפורמה ולוחצים על המשך.

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

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

כרטיס יחידות המודעות אמור להיות מאוכלס עכשיו ביחידות המודעות שבחרתם:

הוספה של LINE Ads Network כמקור מודעות

בידינג

בכרטיס בידינג בקטע מקורות מודעות, בוחרים באפשרות הוספת מקור מודעות. לאחר מכן בוחרים באפשרות LINE Ads Network.

לוחצים על איך חותמים על הסכם שותפות ומגדירים שותפות לבידינג עם LINE Ads Network.



לוחצים על אישור והסכמה ואז על המשך.



אם כבר יש לכם מיפוי של LINE Ads Network, תוכלו לבחור בו. אחרת, לוחצים על הוספת מיפוי.



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

מפל

בקטע מקורות מודעות, בכרטיס Waterfall, בוחרים באפשרות הוספת מקור מודעות. לאחר מכן בוחרים באפשרות LINE Ads Network.

בוחרים באפשרות LINE Ads Network. לאחר מכן, מזינים ערך של עלות בפועל לאלף חשיפות עבור LINE Ads Network ולוחצים על המשך.



אם כבר יש לכם מיפוי של LINE Ads Network, תוכלו לבחור בו. אחרת, לוחצים על הוספת מיפוי.

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

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

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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

שילוב ידני

• מורידים את הגרסה העדכנית ביותר של LINE Ads Network SDK ומקשרים את FiveAd.framework בפרויקט.
• מורידים את הגרסה האחרונה של המתאם של LINE Ads Network מהקישור להורדה ביומן השינויים ומקשרים את LineAdapter.framework בפרויקט.

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

שילוב עם SKAdNetwork

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

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

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

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

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

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

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

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

מתאם LINE Ads Network תומך בפרמטר בקשה נוסף שאפשר להעביר למתאם באמצעות הכיתה GADMediationAdapterLineExtras. הכיתה הזו כוללת את המאפיינים הבאים:

adAudio

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

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

import LineAdapter
// ...

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

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

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

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

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

מתאם LINE Ads Network מאכלס את תיאורי השדות המתקדמים של מודעות מותאמות הבאים עבור GADNativeAd.

¹ במודעות מותאמות, ערכת ה-SDK של LINE Ads Network לא מספקת נכס של סמל אפליקציה. במקום זאת, מתאם LINE Ads Network מאכלס תמונה שקופה בסמל האפליקציה.

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מרשת LINE Ads Network, תוכלו לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות GADResponseInfo.adNetworkInfoArray בקטגוריות הבאות:

GADMediationAdapterLine

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

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

הגרסה הבאה

• תוקנה בעיה שבה GADMediationAdapterLine.h לא הייתה כותרת ציבורית.

גרסה 2.9.20241106.2

• הוספנו את המאפיין GADMediationAdapterLine.testMode כדי לציין אם צריך לאתחל את FiveAd SDK במצב בדיקה. צריך להגדיר את הדגל הזה לפני שמפעילים את Google Mobile Ads SDK.
• הסרת הבדיקה של מצב האינטראקציה הראשונית של FiveAd SDK לפני שמפעילים את FiveAd SDK.
• הסרת הבדיקה של סטטוס המודעה המותאמת שהוצאה משימוש לפני הורדת נכסי מודעות מותאמות.
• מעכשיו נדרשת גרסה 12.0.0 ואילך של Google Mobile Ads SDK.

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

• Google Mobile Ads SDK בגרסה 12.0.0.
• גרסת FiveAd SDK‏ 2.9.20241106.

גרסה 2.9.20241106.1

• עדכנו את המתאם כך שישתמש ב-API העדכני ביותר לטעינה של מודעות לבידינג במודעות באנר.
• תוקנה בעיה שמונעת העברה נכונה של אירועי מודעות לבידינג של מודעות מעברון.

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

• Google Mobile Ads SDK בגרסה 11.12.0.
• גרסת FiveAd SDK‏ 2.9.20241106.

גרסה 2.9.20241106.0

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

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

• Google Mobile Ads SDK בגרסה 11.12.0.
• גרסת FiveAd SDK‏ 2.9.20241106.

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