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

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-LINE Ads Network באמצעות תהליך בחירה של רשת מודעות (Mediation). המדריך כולל הסברים על שילובים של שיטת ה-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 ל-Ad Manager.

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

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

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

הוספת LINE Ads Network בקטע 'חברות'

הפעלת שיתוף אותות מאובטח

שיתוף אותות מאובטחים בבקשות להצעות מחיר

הפעלת שיתוף אותות מאובטח לבידינג מבוסס SDK

הגדרת בידינג ב-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: בדיקת ההטמעה

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

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

המתאם של 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 = 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];

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

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

המתאם של 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.