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

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

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

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

דרישות מוקדמות

לפני שממשיכים, צריך לוודא את הפרטים הבאים:

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

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

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

• הגדרת תהליך בחירת הרשת.

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

נרשמים ונכנסים לחשבון ב-LY Ads Network.

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

עוברים לכרטיסייה App ולוחצים על הכפתור New registration.

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

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

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

בכרטיסייה אפליקציה, בוחרים את האפליקציה כדי לראות את הפרטים שלה. בקטע Slot, לוחצים על Add.

ממלאים את הטופס עם פרטים על המשבצת. בקטע Bidding Type (סוג הבידינג), בוחרים באפשרות Standard (רגיל) כדי להגדיר את המיקום הזה לרשימת רשתות בתהליך בחירת רשת, או באפשרות Google SDK Bidding (בידינג מבוסס SDK חיצוני של Google) כדי להגדיר את המיקום הזה לבידינג. אחרי שממלאים את הטופס, לוחצים על יצירה.

שימו לב למזהה המשבצת.

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

יצירת מפתח Reporting API

עוברים לכרטיסייה Managing reporting מפתחות API ולוחצים על הכפתור Create מפתח API.

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

שימו לב ל-API Key ID (מזהה מפתח ה-API) ול-API Key Secret (סוד מפתח ה-API).

עדכון של הקובץ app-ads.txt

‫ Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, צרו קובץ app-ads.txt ל-Ad Manager.

כדי להטמיע את app-ads.txt ב-LY Ads Network, עיינו במאמר מידע על app-ads.txt.

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

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

הוספת LY Ads Network לחברות

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

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

איך מאפשרים שיתוף של אותות מאובטחים בבידינג מבוסס SDK חיצוני

הגדרת בידינג ב-LY Ads Network

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

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

שימוש ב-Swift Package Manager

לפני שממשיכים, צריך לוודא שגרסת המתאם היא לפחות 2.9.20251119.

כדי להוסיף תלות בחבילה לפרויקט:

1. ב-Xcode, עוברים אל File (קובץ) > Add Package Dependencies...‎ (הוספת יחסי תלות בין חבילות...).

2. בהודעה שמופיעה, מחפשים את כתובת ה-URL הבאה של החבילה:

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. בקטע Dependency Rule, בוחרים באפשרות Branch.

4. בשדה הטקסט, מזינים main.

שימוש ב-CocoaPods

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

שילוב ידני

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

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

הטמעה של SKAdNetwork

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

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

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

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

המתאם של רשת המודעות LY Ads כולל שיטת עזר להפעלת מצב בדיקה ברשת המודעות LY Ads. צריך להגדיר את האפשרות הזו לפני שמפעילים את Google Mobile Ads SDK כדי לוודא שהיא תועבר בצורה תקינה אל LY Ads Network SDK.

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

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

GADMediationAdapterLine.testMode = YES;

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

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-LY Ads Network, הפעילו בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות של LY Ads Network.

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

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

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

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

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

המתאם של LY Ads Network מאכלס את השדות הבאים של GADNativeAd.

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

קודי שגיאה

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

GADMediationAdapterLine

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

יומן השינויים של מתאם תהליך בחירת הרשת של LINE ל-iOS

גרסה 3.1.1.0

• תאימות מאומתת עם FiveAd SDK בגרסה 3.1.1.

נבנה ונבדק עם:

• גרסה 13.9.0 של Google Mobile Ads SDK.
• גרסה 3.1.1 של FiveAd SDK.

גרסה 3.1.0.0

• עכשיו נדרשת גרסת iOS מינימלית 15.0.
• תאימות מאומתת עם FiveAd SDK בגרסה 3.1.0.

נבנה ונבדק עם:

• גרסה 13.8.0 של Google Mobile Ads SDK.
• גרסה 3.1.0 של FiveAd SDK.

גרסה 3.0.1.2

• מעדכנים את גרסת iOS המינימלית כדי להקל על התלות ב-Google Mobile Ads SDK ולאפשר גרסאות משניות.
• תוקנה בעיה שבה הסמל של AdChoices במודעות מותאמות היה גדול מדי.

נבנה ונבדק עם:

• גרסה 13.4.0 של Google Mobile Ads SDK.
• גרסה 3.0.1 של FiveAd SDK.

גרסה 3.0.1.1

• המתאם מעביר עכשיו את הדגל ageRestrictedTreatment של Google Mobile Ads SDK אל ה-API של FiveAd SDK בנושא COPPA.

נבנה ונבדק עם:

• גרסה 13.3.0 של Google Mobile Ads SDK.
• גרסה 3.0.1 של FiveAd SDK.

גרסה 3.0.1.0

• תאימות מאומתת עם FiveAd SDK בגרסה 3.0.1.

נבנה ונבדק עם:

• גרסה 13.1.0 של Google Mobile Ads SDK.
• גרסה 3.0.1 של FiveAd SDK.

גרסה 3.0.0.1

• עודכנה התלות ב-Google Mobile Ads SDK לגרסה 13.0.0.

נבנה ונבדק עם:

• גרסה 13.0.0 של Google Mobile Ads SDK.
• גרסה 3.0.0 של FiveAd SDK.

גרסה 3.0.0.0

• תאימות מאומתת עם FiveAd SDK בגרסה 3.0.0.0.

נבנה ונבדק עם:

• גרסה 12.14.0 של Google Mobile Ads SDK.
• גרסה 3.0.0 של FiveAd SDK.

גרסה 2.9.20251119.1

• נוספה תמיכה בהעברת הפרמטרים של tagForUnderAgeOfConsent ב-Google Mobile Ads SDK אל FiveAd SDK.

נבנה ונבדק עם:

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

גרסה 2.9.20251119.0

• תאימות מאומתת עם FiveAd SDK בגרסה 2.9.20251119.

נבנה ונבדק עם:

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

גרסה 2.9.20250930.0

• תאימות מאומתת עם FiveAd SDK בגרסה 2.9.20250930.

נבנה ונבדק עם:

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

גרסה 2.9.20250912.0

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

נבנה ונבדק עם:

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

גרסה 2.9.20250512.0

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

נבנה ונבדק עם:

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

גרסה 2.9.20241106.1

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

נבנה ונבדק עם:

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

גרסה 2.9.20241106.0

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

נבנה ונבדק עם:

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

גרסה 2.8.20240827.1

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

נבנה ונבדק עם:

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

גרסה 2.8.20240827.0

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

נבנה ונבדק עם:

• גרסה 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.
• גרסת FiveAd SDK‏ 2.8.20240612.

גרסה 2.7.20240411.0

• תאימות מאומתת עם FiveAd SDK בגרסה 2.7.20240411.

נבנה ונבדק עם:

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

גרסה 2.7.20240318.0

• תאימות מאומתת עם FiveAd SDK בגרסה 2.7.20240318.

נבנה ונבדק עם:

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

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

• תאימות מאומתת עם FiveAd SDK בגרסה 2.7.20240214.

נבנה ונבדק עם:

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

גרסה 2.7.20240126.0

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

נבנה ונבדק עם:

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

גרסה 2.7.20231115.0

• תאימות מאומתת עם FiveAd SDK בגרסה 2.7.20231115.
• הכותרת 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 לפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
• תאימות מאומתת עם FiveAd SDK בגרסה 2.6.20230609.

נבנה ונבדק עם:

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