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

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

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

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

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

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

דרישות

• יעד פריסה 12.0 ומעלה ב-iOS

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

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

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

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

נרשמים ומתחברים לחשבון LINE Ads Network.

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

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

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

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

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

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

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

ממלאים את הטופס כדי לקבל פרטים על משבצת הזמן. בקטע Bidding Type (סוג הבידינג), בוחרים באפשרות Standard (רגיל) כדי להגדיר את משבצת המודעה הזו לגישור בשיטת Waterfall, או באפשרות Google SDK Bidding (בידינג מבוסס 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 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. צריך להגדיר את האפשרות הזו לפני שמבצעים הפעלה של Google Mobile Ads SDK, כדי לוודא שהיא תועבר בצורה תקינה אל LINE Ads Network SDK.

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

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

GADMediationAdapterLine.testMode = YES;

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

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-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.20250930.0

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

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

• גרסה 12.12.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.9.20250930.

גרסה 2.9.20250912.0

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

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

• גרסה 12.11.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.9.20250912.

גרסה 2.9.20250512.0

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

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

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

גרסה 2.9.20241106.3

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

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

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

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

גרסה 2.9.20241106.1

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

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

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

גרסה 2.9.20241106.0

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

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

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

גרסה 2.8.20240827.1

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

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

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

גרסה 2.8.20240827.0

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

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

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

גרסה 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.

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

• גרסה 11.3.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 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.
• גרסת FiveAd SDK‏ 2.7.20240214.

גרסה 2.7.20240214.0

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

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

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

גרסה 2.7.20240126.0

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

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

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

גרסה 2.7.20231115.0

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

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

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

גרסה 2.6.20230609.1

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

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

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

גרסה 2.6.20230609.0

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

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

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