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

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

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

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

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

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

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

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

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

• הגדרת תהליך בחירת הרשת (Mediation) ב-AdMob.

שלב 1: קובעים את ההגדרות בממשק המשתמש של רשת המודעות של LY

נרשמים ונכנסים לחשבון ב-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 לאפליקציה.

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

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

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

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

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

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

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

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

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

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

הוספת LY Ads Network כרשת מודעות

בידינג

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

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



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



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



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

מפל

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

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




אם כבר יש לכם מיפוי ל-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: בודקים את ההטמעה

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

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

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

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

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

המתאם של LY Ads Network מאכלס את השדות הבאים של מודעות מותאמות מסוג Advanced ב-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

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

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

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

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

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

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