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

בחירת פלטפורמה: Android iOS Unity Flutter Android (גרסה קודמת)

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

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

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

שילוב
בידינג
Waterfall
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה
מותאמת

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

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

• ‫Android API ברמה 24 ואילך.

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

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

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

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

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

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

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

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

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

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

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

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

שימו לב לערך של מזהה המיקום.

אחרי שיוצרים את מיקום המודעה הראשון, לוחצים על בדיקה בדף הפרטים של האפליקציה כדי לקבל אישור מ-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 להגדרות של תהליך בחירת הרשת ביחידת המודעות.

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

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

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

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

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

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

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

בידינג

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

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



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



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



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

חשוב: מזהה האפליקציה צריך להיות משויך לאפליקציה המטורגטת כמו בממשק המשתמש של רשת מודעות LY.

מפל

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

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

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

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



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

חשוב: מזהה האפליקציה צריך להיות משויך לאפליקציה המטורגטת כמו בממשק המשתמש של רשת המודעות LY.

הערה: תהליך האופטימיזציה של מקורות המודעות נמשך כמה ימים, שבמהלכם נאספים מספיק נתונים כדי לחשב במדויק את העלות בפועל לאלף חשיפות (eCPM) של רשת מודעות בתהליך בחירת הרשת (Mediation). בינתיים, סטטוס האופטימיזציה של מקור המודעות הוא PENDING, לכן צריך להגדיר ידנית ערך של עלות בפועל לאלף חשיפות לרשת. אחרי שאפשר לחשב את העלות בפועל לאלף חשיפות, מקור המודעות מתחיל לעדכן אותה באופן אוטומטי בשבילכם.

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

הערה: אם לא תשלבו את הגרסאות התואמות של LY Ads Network ו-Google Mobile Ads SDK (Legacy), יכול להיות שיהיו בעיות ב-build.

שילוב עם Android Studio (מומלץ)

בקובץ Gradle ברמת האפליקציה, מוסיפים את יחסי התלות הבאים להטמעה:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

שילוב ידני

1. מורידים את הגרסה העדכנית של קובץ ה-.aar של LY רשת מודעות SDK ומוסיפים אותו לפרויקט.

2. עוברים אל פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) של המתאם של רשת המודעות LY Ads במאגר Maven של Google. בוחרים את הגרסה העדכנית, מורידים את קובץ ה-.aar של המתאם של רשת המודעות LY Ads ומוסיפים אותו לפרויקט.

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

לא נדרש קוד נוסף כדי לשלב את LY Ads Network.

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

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

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

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

Java

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

Kotlin

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

חשוב: לפני שמפרסמים את האפליקציה, צריך להשבית את מצב הבדיקה ב-AdMob וב-LY Ads Network.

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

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

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

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

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

enableAdSound

boolean כדי לציין את מצב ברירת המחדל של הצליל בתחילת ההפעלה של מודעות באנר, מודעות מעברון ומודעות מתגמלות.

הנה דוגמה לקוד שיוצר בקשה להצגת מודעה שמגדירה את הפרמטרים האלה:

Java

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

Kotlin

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

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

עיבוד מודעות

המתאם של LY Ads Network מאכלס את השדות הבאים של מודעות מותאמות מסוג Advanced ב-NativeAd.

שדה	נכסים שתמיד נכללים במתאם של רשת המודעות LY
כותרת
תמונה
גוף
סמל האפליקציה	^1
קריאה לפעולה
דירוג כוכבים
חנות
מחיר

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

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-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	ה-SDK של רשת המודעות LY לא הצליח להציג מודעת מעברון או מודעה מתגמלת.
106	com.google.ads.mediation.line	המודעה המותאמת לא נטענה כי חסרים נכסים.
107	com.google.ads.mediation.line	‫FiveAd SDK החזיר טוען מודעות ריק.

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

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

• כשמשתמשים ב-Google Mobile Ads SDK בגרסה 24.4.0 ואילך, החשיפות של המודעות המותאמות מוחלפות עכשיו על ידי 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

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

פותח ונבדק עם:

• גרסה 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.
• ‫FiveAd SDK בגרסה 2.9.20250924.0

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

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

פותח ונבדק עם:

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

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

פותח ונבדק עם:

• גרסה 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.
• תאימות מאומתת לגרסה 2.9.20250110 של FiveAd SDK.

פותח ונבדק עם:

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

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

פותח ונבדק עם:

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

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

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

פותח ונבדק עם:

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