במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK (Legacy) כדי לטעון ולהציג מודעות מ-LY Ads Network באמצעות תהליך בחירת הרשת (Mediation), כולל שילובים של שיטת ה-Waterfall. המאמר מסביר איך להוסיף את LY Ads Network להגדרה של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של LY Ads Network באפליקציה ל-Android.
שילובים ופורמטים נתמכים של מודעות
מתאם תהליך הבחירה של רשת מודעות של LY Ads Network כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| Waterfall | |
| פורמטים | |
| מודעת באנר | |
| מעברון | |
| ההטבה הופעלה | |
| מותאם | |
דרישות מוקדמות
לפני שממשיכים, צריך לוודא את הפרטים הבאים:
- Android API ברמת API 24 ומעלה.
הגרסה העדכנית של Google Mobile Ads SDK (Legacy).
שלב 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 keys ולוחצים על הכפתור Create API key.
ממלאים את הטופס ולוחצים על שמירה.
שימו לב למזהה מפתח ה-API ולסוד מפתח ה-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 לחברות
בידינג
השלב הזה לא נדרש בשילובים של בידינג.
Waterfall
עוברים אל Admin > Companies ולוחצים על הכפתור New company בכרטיסייה All companies. בוחרים באפשרות רשת מודעות.

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

הפעלת שיתוף אותות מאובטחים
בידינג
עוברים אל Admin > Global settings. עוברים לכרטיסייה הגדרות החשבון ב-Ad Exchange, בודקים את ההגדרה שיתוף אותות מאובטח ומפעילים אותה. לוחצים על שמירה.

Waterfall
השלב הזה לא נדרש בשילובים של Waterfall.
שיתוף אותות מאובטחים בבקשות להצעות מחיר
בידינג
עוברים אל Inventory > Secure Signals. בקטע אותות מאובטחים, מחפשים את LY Ads Network ומפעילים את המתג הפעלת שילוב אפליקציות.

לוחצים על שמירה.
Waterfall
השלב הזה לא נדרש בשילובים של Waterfall.
אישור שיתוף אותות מאובטחים לבידינג מבוסס SDK חיצוני
בידינג
עוברים אל Delivery (הצגת מודעות) > Demand channel settings (הגדרות ערוץ הביקוש). בכרטיסייה הגדרות ברירת מחדל, מפעילים את האפשרות אישור שיתוף של אותות מאובטחים לבידינג מבוסס SDK חיצוני.

לוחצים על שמירה.
Waterfall
השלב הזה לא נדרש בשילובים של Waterfall.
הגדרת בידינג ב-LY Ads Network
בידינג
עוברים אל הצגת מודעות > מגישי הצעות מחיר ולוחצים על מעבר לבידינג מבוסס SDK חיצוני.

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

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

לוחצים על המשך כדי להפעיל בידינג מבוסס SDK חיצוני למגיש הצעות המחיר הזה.

לוחצים על סיום.
Waterfall
השלב הזה לא נדרש בשילובים של Waterfall.
הגדרת מיפוי של יחידות מודעות
בידינג
עוברים אל הצגת מודעות > מגישי הצעות מחיר ולוחצים על מעבר לבידינג מבוסס SDK חיצוני.

בוחרים את החברה של רשת המודעות LY.

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

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

מפל
עוברים אל Delivery > Yield groups ולוחצים על הכפתור New yield group. בוחרים את המלאי ואת האפליקציה.

גוללים אל שותפי תפוקה ולוחצים על הוספת שותף בתהליך בחירת הרשת.

בחרו את החברה שיצרתם עבור LY Ads Network בקטע הקודם. בוחרים באפשרות Mobile SDK mediation בתור סוג השילוב, באפשרות Android בתור פלטפורמה ובאפשרות פעיל בתור סטטוס.
מזינים את מזהה האפליקציה ואת מזהה מיקום המודעה שקיבלתם בקטע הקודם, ואת הערך של עלות ברירת המחדל לאלף חשיפות. לוחצים על Save.

שלב 3: מייבאים את ה-SDK והמתאם של LY Ads Network
שילוב עם Android Studio (מומלץ)
בקובץ Gradle ברמת האפליקציה, מוסיפים את יחסי התלות הבאים להטמעה:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:25.5.0") implementation("com.google.ads.mediation:line:3.2.0.0") }
Groovy
dependencies { implementation 'com.google.android.gms:play-services-ads:25.5.0' implementation 'com.google.ads.mediation:line:3.2.0.0' }
שילוב ידני
מורידים את הגרסה העדכנית של קובץ
.aarשל LY Ads Network SDK ומוסיפים אותו לפרויקט.עוברים אל פריטי המידע שנוצרו בתהליך הפיתוח (Artifacts) של המתאם של רשת המודעות LY Ads במאגר Maven של Google. בוחרים את הגרסה העדכנית, מורידים את קובץ ה-
.aarשל המתאם של LY Ads Network ומוסיפים אותו לפרויקט.
שלב 4: מוסיפים את הקוד הנדרש
לא נדרש קוד נוסף כדי לשלב את LY Ads Network.
שלב 5: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager.
המתאם של רשת המודעות LY Ads כולל שיטת עזר להפעלת מצב בדיקה ברשת המודעות LY Ads. צריך להגדיר את האפשרות הזו לפני שמפעילים את Google Mobile Ads SDK (Legacy) כדי לוודא שהיא תועבר בצורה תקינה אל LY Ads Network SDK.
Java
Kotlin
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות לבדיקה מ-LY Ads Network, הפעילו בדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות של LY Ads Network.
שלבים אופציונליים
פרמטרים ספציפיים לרשת
המתאם של LY Ads Network תומך בפרמטר נוסף של בקשה שאפשר להעביר למתאם באמצעות המחלקה LineExtras. ה-constructor של המחלקה הזו כולל את הפרמטרים הבאים:
enableAdSoundbooleanכדי לציין את מצב ברירת המחדל של הצליל בתחילת ההפעלה של מודעות באנר, מודעות מעברון ומודעות מתגמלות.
הנה דוגמה לקוד שמראה איך ליצור בקשה להצגת מודעה שמגדירה את הפרמטרים האלה:
Java
Kotlin
שימוש במודעות מותאמות
רינדור מודעות
המתאם של LY Ads Network מאכלס את השדות הבאים של NativeAd.
| שדה | נכסים שתמיד נכללים במתאם של LY Ads Network |
|---|---|
| כותרת | |
| תמונה | |
| גוף | |
| סמל האפליקציה | 1 |
| קריאה לפעולה | |
| דירוג כוכבים | |
| חנות | |
| מחיר |
1 במודעות מותאמות, ערכת ה-SDK של LY Ads Network לא מספקת נכס של סמל אפליקציה. במקום זאת, המתאם של רשת המודעות LY מאכלס את סמל האפליקציה בתמונה שקופה.
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-LY Ads Network, אפשר לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות ResponseInfo.getAdapterResponses() במחלקות הבאות:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של LY Ads Network כשהטעינה של מודעה נכשלת:
| קוד שגיאה | דומיין | סיבה |
|---|---|---|
| 1-10 | com.five_corp.ad | LY Ads Network SDK החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של LY Ads Network. |
| 101 | com.google.ads.mediation.line | מזהה האפליקציה חסר או לא תקין. |
| 102 | com.google.ads.mediation.line | מזהה המיקום חסר או לא תקין. |
| 103 | com.google.ads.mediation.line | גודל המודעה המבוקש לא תואם לגודל של מודעת באנר שנתמך ב-LY Ads Network. |
| 104 | com.google.ads.mediation.line | הטעינה של מודעת מעברון או מודעה מתגמלת נכשלה כי חסר הקשר לפעילות. |
| 105 | com.google.ads.mediation.line | LY Ads Network SDK לא הצליח להציג מודעת מעברון או מודעה מתגמלת. |
| 106 | com.google.ads.mediation.line | המודעה המותאמת לא נטענה כי חסרים נכסים. |
| 107 | com.google.ads.mediation.line | FiveAd SDK החזיר טוען מודעות מסוג null. |
יומן השינויים של מתאם תהליך בחירת הרשת של LINE ל-Android
הגרסה הבאה
- המתאם עודכן כך שישתמש ב-API של
InitializationCompleteCallback.onInitializationFailed(AdError).
גרסה 3.2.0.0
- תאימות מאומתת עם FiveAd SDK בגרסה 3.2.0.0.
נבנה ונבדק עם:
- גרסה 25.5.0 של Google Mobile Ads SDK.
- גרסה 1.6.0 של Google Mobile Ads Next-Gen SDK.
- גרסה 3.2.0.0 של FiveAd SDK.
גרסה 3.1.1.2
- מצמידים את התלות של המתאם ב-Kotlin לגרסה 1.9.0 (גרסת Kotlin המינימלית שנתמכת על ידי GMA NextGen SDK).
נבנה ונבדק עם:
- גרסה 25.4.0 של Google Mobile Ads SDK.
- גרסה 1.4.0 של Google Mobile Ads Next-Gen SDK.
- גרסה 3.1.1.1 של FiveAd SDK.
גרסה 3.1.1.1
- ממפה את
AgeRestrictedTreatmentל-ChildDirectedTreatment API של Line.
נבנה ונבדק עם:
- גרסה 25.4.0 של Google Mobile Ads SDK.
- גרסה 1.2.1 של Google Mobile Ads Next-Gen SDK.
- גרסה 3.1.1.1 של FiveAd SDK.
גרסה 3.1.1.0
- תאימות מאומתת עם FiveAd SDK בגרסה 3.1.1.0.
נבנה ונבדק עם:
- גרסה 25.2.0 של Google Mobile Ads SDK.
- גרסה 1.2.1 של Google Mobile Ads Next-Gen SDK.
- גרסה 3.1.1.0 של FiveAd SDK.
גרסה 3.1.0.0
- נוסף מאפיין ליצירת המתאם עם תלות ב-GMA Next-Gen SDK.
- תאימות מאומתת עם FiveAd SDK בגרסה 3.1.0.0.
נבנה ונבדק עם:
- גרסה 25.1.0 של Google Mobile Ads SDK.
- גרסה 0.25.0-beta01 של Google Mobile Ads Next-Gen SDK.
- גרסה 3.1.0.0 של FiveAd SDK.
גרסה 3.0.1.2
נבנה ונבדק עם:
- גרסה 25.1.0 של Google Mobile Ads SDK.
- גרסה 3.0.1.2 של FiveAd SDK.
גרסה 3.0.1.1
- בגרסה 24.4.0 ומעלה של Google Mobile Ads SDK, החשיפות של המודעות מותאמות מוחלפות על ידי FiveAd SDK.
נבנה ונבדק עם:
- גרסה 24.9.0 של Google Mobile Ads SDK.
- גרסה 3.0.1.1 של FiveAd SDK.
גרסה 3.0.1.0
- נוספה תמיכה בהעברת הפרמטר tagForUnderAgeOfConsent של Google Mobile Ads SDK אל FiveAd SDK.
- תאימות מאומתת עם FiveAd SDK בגרסה 3.0.1.0.
נבנה ונבדק עם:
- גרסה 24.9.0 של Google Mobile Ads SDK.
- גרסה 3.0.1.0 של FiveAd SDK.
גרסה 3.0.0.0
- תאימות מאומתת לגרסה 3.0.0.0 של FiveAd SDK.
נבנה ונבדק עם:
- גרסה 24.9.0 של Google Mobile Ads SDK.
- גרסה 3.0.0.0 של FiveAd SDK.
גרסה 2.9.20251028.0
- תאימות מאומתת עם FiveAd SDK בגרסה 2.9.20251028.
נבנה ונבדק עם:
- גרסה 24.7.0 של Google Mobile Ads SDK.
- גרסה 2.9.20251028.0 של FiveAd SDK
גרסה 2.9.20250924.1
- הוסרו הפניות ברמת הכיתה ל-Context. יכול לעזור לצמצם בעיות של דליפת זיכרון.
נבנה ונבדק עם:
- גרסה 24.7.0 של Google Mobile Ads SDK.
- גרסת FiveAd SDK 2.9.20250924.1.
גרסה 2.9.20250924.0
- תאימות מאומתת עם FiveAd SDK בגרסה 2.9.20250924.
נבנה ונבדק עם:
- גרסה 24.6.0 של Google Mobile Ads SDK.
- גרסה 2.9.20250924.0 של FiveAd SDK
גרסה 2.9.20250718.0
- תאימות מאומתת עם FiveAd SDK בגרסה 2.9.20250718.
נבנה ונבדק עם:
- גרסה 24.3.0 של Google Mobile Ads SDK.
- גרסת FiveAd SDK 2.9.20250718.0.
גרסה 2.9.20250519.0
- תאימות מאומתת לגרסה 2.9.20250519 של FiveAd SDK.
נבנה ונבדק עם:
- גרסה 24.3.0 של Google Mobile Ads SDK.
- גרסת FiveAd SDK 2.9.20250519.0.
גרסה 2.9.20250317.1
- תיקון של מידות הטעינה של מודעות באנר לבידינג באמצעות FiveAd API החדש
נבנה ונבדק עם:
- גרסה 24.1.0 של Google Mobile Ads SDK.
- FiveAd SDK בגרסה 2.9.20250317.0
גרסה 2.9.20250317.0
- תאימות מאומתת ל-FiveAd SDK בגרסה 2.9.20250317.
נבנה ונבדק עם:
- גרסה 24.1.0 של Google Mobile Ads SDK.
- FiveAd SDK בגרסה 2.9.20250317.0
גרסה 2.9.20250110.1
- רמת ה-API המינימלית הנדרשת ב-Android עודכנה ל-23.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-24.0.0.
נבנה ונבדק עם:
- גרסה 24.0.0 של Google Mobile Ads SDK.
- FiveAd SDK בגרסה 2.9.20250110.0
גרסה 2.9.20250110.0
- הוסרה המחלקה
UnifiedNativeAdMapperשהוצאה משימוש, והוחלפה ב-NativeAdMapper - תהליך איסוף האותות תוקן.
- תוקן תהליך האיניציאליזציה של פורמטים של מודעות מעברון ומודעות מתגמלות ב-Waterfall.
- תאימות מאומתת עם FiveAd SDK בגרסה 2.9.20250110.
נבנה ונבדק עם:
- גרסה 23.6.0 של Google Mobile Ads SDK.
- FiveAd SDK בגרסה 2.9.20250110.0
גרסה 2.9.20241129.0
- נוספה תמיכה בבידינג לפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
- תאימות מאומתת עם FiveAd SDK בגרסה 2.9.20241129.
נבנה ונבדק עם:
- גרסה 23.5.0 של Google Mobile Ads SDK.
- גרסה 2.9.20241129.0 של FiveAd SDK
גרסה 2.8.20240827.0
- תאימות מאומתת עם FiveAd SDK בגרסה 2.8.20240827.
נבנה ונבדק עם:
- גרסה 23.3.0 של Google Mobile Ads SDK.
- FiveAd SDK בגרסה 2.8.20240827.0
גרסה 2.8.20240808.0
- תאימות מאומתת עם FiveAd SDK בגרסה 2.8.20240808.
נבנה ונבדק עם:
- גרסה 23.2.0 של Google Mobile Ads SDK.
- FiveAd SDK בגרסה 2.8.20240808.0
גרסה 2.8.20240722.0
- תאימות מאומתת עם FiveAd SDK בגרסה 2.8.20240722.
נבנה ונבדק עם:
- גרסה 23.2.0 של Google Mobile Ads SDK.
- FiveAd SDK בגרסה 2.8.20240722.0
גרסה 2.7.20240515.0
- תאימות מאומתת עם FiveAd SDK בגרסה 2.7.20240515.
נבנה ונבדק עם:
- גרסה 23.1.0 של Google Mobile Ads SDK.
- גרסת FiveAd SDK 2.7.20240515.0
גרסה 2.7.20240214.1
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-23.0.0.
- תאימות מאומתת עם FiveAd SDK בגרסה 2.7.20240214.
נבנה ונבדק עם:
- גרסה 23.0.0 של Google Mobile Ads SDK.
- גרסת FiveAd SDK 2.7.20240214.0.
גרסה 2.7.20240214.0
- תאימות מאומתת עם FiveAd SDK בגרסה 2.7.20240214.
נבנה ונבדק עם:
- גרסה 22.6.0 של Google Mobile Ads SDK.
- גרסת FiveAd SDK 2.7.20240214.0.
גרסה 2.7.20240126.0
- אימות התאימות לגרסה 2.7.20240126 של FiveAd SDK.
נבנה ונבדק עם:
- גרסה 22.6.0 של Google Mobile Ads SDK.
- גרסת FiveAd SDK 2.7.20240126.0.
גרסה 2.7.20240112.0
- הוסר המאפיין
FiveAdViewEventListenerשהוצא משימוש, ובמקומו נוספו המאפייניםFiveAdCustomLayoutEventListener,FiveAdVideoRewardEventListener,FiveAdInterstitialEventListenerו-FiveAdNativeEventListener. - תאימות מאומתת עם FiveAd SDK בגרסה 2.7.20240112.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.6.0.
נבנה ונבדק עם:
- גרסה 22.6.0 של Google Mobile Ads SDK.
- גרסת FiveAd SDK 2.7.20240112.
גרסה 2.6.20230607.1
- נוספה המחלקה
LineExtrasשמאפשרת לבעלי אפליקציות להגדיר את הגדרות ברירת המחדל של הצליל בפורמטים של מודעות באנר, מודעות מעברון ומודעות מתגמלות. - הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.4.0.
נבנה ונבדק עם:
- גרסה 22.4.0 של Google Mobile Ads SDK.
- גרסת FiveAd SDK 2.6.20230607.
גרסה 2.6.20230607.0
- הגרסה הראשונה.
- נוספה תמיכה בפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
- תאימות מאומתת עם FiveAd SDK בגרסה 2.6.20230607.
נבנה ונבדק עם:
- גרסה 22.1.0 של Google Mobile Ads SDK.
- גרסת FiveAd SDK 2.6.20230607.