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

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

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

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

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

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

דרישות

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

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

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

• צריך לקרוא את המדריך לתחילת העבודה עם תהליך בחירת הרשת (Mediation).

שלב 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 לאפליקציה.

כדי להטמיע את app-ads.txt ברשת המודעות של LINE, אפשר לעיין במאמר מידע על app-ads.txt.

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

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

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

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

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

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

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

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

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

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

בידינג

בכרטיס Bidding שבקטע Ad Sources, בוחרים באפשרות Add ad source. לאחר מכן בוחרים באפשרות LINE Ads Network .

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



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



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



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

מפל

בכרטיס Waterfall שבקטע Ad Sources, בוחרים באפשרות Add Ad Source.

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



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

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

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

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

קודי שגיאה

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

GADMediationAdapterLine

אלה הקודים וההודעות הנלוות שמוחזרים על ידי מתאם LINE Ads Network כשהטעינה של מודעה נכשלת:

יומן השינויים של מתאם הגישור של LINE ל-iOS

גרסה 2.9.20250825.0 (בביצוע)

גרסה 2.9.20250805.0 (בביצוע)

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

גרסה 2.9.20250512.0

• נדרשת עכשיו גרסת iOS מינימלית של 13.0.
• תאימות מאומתת לגרסה 2.9.20250512 של FiveAd SDK.

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

• גרסה 12.14.0 של Google Mobile Ads SDK.
• גרסת SDK של FiveAd‏: 2.9.20250512.

גרסה 2.9.20241106.3

• תוקנה בעיה שבה GADMediationAdapterLine.h לא הייתה כותרת ציבורית.
• הדגלים -fobjc-arc ו--fstack-protector-all מופעלים.
• הסרנו את האימות של גודל מודעת הבאנר להגשת הצעות מחיר אחרי טעינה מוצלחת.
  • מודעות באנר בשיטת Waterfall ימשיכו לבדוק את הגדלים של מודעות הבאנר אחרי שהן ייטענו בהצלחה.

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

• גרסה 12.2.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.9.20241106.

גרסה 2.9.20241106.2

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

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

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

גרסה 2.9.20241106.1

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

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

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

גרסה 2.9.20241106.0

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

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

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

גרסה 2.8.20240827.1

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

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

• גרסה 11.10.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.8.20240827.

גרסה 2.8.20240827.0

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

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

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

גרסה 2.8.20240612.0

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

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

• גרסה 11.5.0 של Google Mobile Ads SDK.
• גרסה 2.8.20240612 של FiveAd SDK

גרסה 2.7.20240411.0

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

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

• ‫Google Mobile Ads SDK גרסה 11.3.0.
• גרסת SDK‏ FiveAd‏ 2.7.20240411.

גרסה 2.7.20240318.0

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

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

• גרסה 11.2.0 של Google Mobile Ads SDK.
• גרסה 2.7.20240318 של FiveAd SDK.

גרסה 2.7.20240214.1

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

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

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

גרסה 2.7.20240214.0

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

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

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

גרסה 2.7.20240126.0

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

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

• גרסה 10.14.0 של Google Mobile Ads SDK.
• גרסה 2.7.20240126 של FiveAd SDK.

גרסה 2.7.20231115.0

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

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

• גרסה 10.14.0 של Google Mobile Ads SDK.
• גרסה 2.7.20231115 של FiveAd SDK.

גרסה 2.6.20230609.1

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

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

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

גרסה 2.6.20230609.0

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

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

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