שילוב של LY עם תהליך בחירת הרשת (Mediation)

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

במדריך הזה מוסבר איך להשתמש ב-GMA Next-Gen SDK כדי לטעון ולהציג מודעות מ-LY Ads Network באמצעות AdMob Mediation. המדריך כולל הסברים על שילובים של שיטת ה-Waterfall. המאמר מסביר איך להוסיף את LY Ads Network להגדרה של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של LY Ads Network באפליקציית Android.

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

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

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

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

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

• רמת API‏ Android 24 ואילך.

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

• הגרסה העדכנית ביותר של GMA Next-Gen SDK.

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

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

הירשמו והתחברו לחשבון LY Ads Network שלכם.

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

עוברים לכרטיסייה App (אפליקציה) ולוחצים על הלחצן New registration (רישום חדש).

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

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

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

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

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

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

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

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

יצירת מפתח API לדיווח

נווטו לכרטיסייה ניהול מפתחות API לדיווח ולחצו על הלחצן יצירת מפתח API.

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

שימו לב ל-ID מפתח ה-API ול-סוד מפתח ה-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 בממשק המשתמש של AdMob

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

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

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

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

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

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

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

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

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

בידינג

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

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



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



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



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

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

מפל

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

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

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

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



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

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

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

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

הערה: אי שילוב של גרסאות תואמות של LY Ads Network ו-GMA Next-Gen SDK עלול להוביל לבעיות בבנייה.

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

בקובץ gradle ברמת האפליקציה, מוסיפים את תלות ההטמעה וההגדרות הבאות:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.4.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.4.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

שילוב ידני

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

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

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

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

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

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

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

המתאם של LY Ads Network מכיל שיטת עזר להפעלת מצב בדיקה עבור LY Ads Network. צריך להגדיר את האפשרות הזו לפני שמפעילים את GMA Next-Gen SDK כדי לוודא שהיא תועבר בצורה תקינה אל 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. הבנאי של המחלקה הזו כולל את הפרמטרים הבאים:

enableAdSound

‫

A 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 Ads Network
כותרת
תמונה
גוף
סמל האפליקציה	^1
קריאה לפעולה
דירוג כוכבים
חנות
מחיר

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

קודי שגיאה

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

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

גרסה 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 Maps to Line's ChildDirectedTreatment API.

נבנה ונבדק באמצעות:

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

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

נבנה ונבדק באמצעות:

• גרסה 25.2.0 של Google Mobile Ads SDK.
• גרסה 1.2.1 של Google Mobile Ads Next-Gen SDK.
• ערכת פיתוח תוכנה של FiveAd גרסה 3.1.1.0.

גרסה 3.1.0.0

• נוסף מאפיין ליצירת המתאם עם תלות ב-GMA Next-Gen SDK.
• תאימות מאומתת לגרסה 3.1.0.0 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 25.1.0 של Google Mobile Ads SDK.
• גרסה 0.25.0-beta01 של Google Mobile Ads Next-Gen SDK.
• ערכת פיתוח תוכנה של FiveAd גרסה 3.1.0.0.

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

נבנה ונבדק באמצעות:

• גרסה 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.
• ערכת פיתוח תוכנה של FiveAd גרסה 3.0.0.0.

גרסה 2.9.20251028.0

• תאימות מאומתת עם גרסה 2.9.20251028 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 24.7.0 של Google Mobile Ads SDK.
• ערכת פיתוח תוכנה של FiveAd גרסה 2.9.20251028.0

גרסה 2.9.20250924.1

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

נבנה ונבדק באמצעות:

• גרסה 24.7.0 של Google Mobile Ads SDK.
• גרסת 2.9.20250924.1 של ערכת פיתוח תוכנה של FiveAd.

גרסה 2.9.20250924.0

• תאימות מאומתת עם גרסה 2.9.20250924 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 24.6.0 של Google Mobile Ads SDK.
• ערכת פיתוח תוכנה של FiveAd גרסה 2.9.20250924.0

גרסה 2.9.20250718.0

• תאימות מאומתת עם גרסה 2.9.20250718 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 24.3.0 של Google Mobile Ads SDK.
• גרסת 2.9.20250718.0 של ערכת פיתוח תוכנה של FiveAd.

גרסה 2.9.20250519.0

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

נבנה ונבדק באמצעות:

• גרסה 24.3.0 של Google Mobile Ads SDK.
• גרסה 2.9.20250519.0 של FiveAd SDK.

גרסה 2.9.20250317.1

• תוקנו מידות הטעינה של מודעות באנר למודעות בידינג באמצעות FiveAd API החדש

נבנה ונבדק באמצעות:

• גרסה 24.1.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.9.20250317.0

גרסה 2.9.20250317.0

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

נבנה ונבדק באמצעות:

• גרסה 24.1.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 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.
• גרסה 2.9.20250110.0 של FiveAd SDK

גרסה 2.9.20250110.0

• הוסרה המחלקה UnifiedNativeAdMapper שהוצאה משימוש לטובת NativeAdMapper
• תהליך איסוף האותות תוקן.
• תוקן תהליך האתחול של פורמטים של מודעות מעברון מתגמלות ומודעות מעברון בשיטת Waterfall.
• תאימות מאומתת לגרסה 2.9.20250110 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 23.6.0 של Google Mobile Ads SDK.
• גרסה 2.9.20250110.0 של FiveAd SDK

גרסה 2.9.20241129.0

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

נבנה ונבדק באמצעות:

• גרסה 23.5.0 של Google Mobile Ads SDK.
• ערכת פיתוח תוכנה של FiveAd גרסה 2.9.20241129.0

גרסה 2.8.20240827.0

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

נבנה ונבדק באמצעות:

• גרסה 23.3.0 של Google Mobile Ads SDK.
• גרסה 2.8.20240827.0 של FiveAd SDK

גרסה 2.8.20240808.0

• תאימות מאומתת עם גרסה 2.8.20240808 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 23.2.0 של Google Mobile Ads SDK.
• גרסה 2.8.20240808.0 של FiveAd SDK

גרסה 2.8.20240722.0

• תאימות מאומתת לגרסה FiveAd SDK version 2.8.20240722.

נבנה ונבדק באמצעות:

• גרסה 23.2.0 של Google Mobile Ads SDK.
• גרסה 2.8.20240722.0 של FiveAd SDK

גרסה 2.7.20240515.0

• תאימות מאומתת עם גרסה 2.7.20240515 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 23.1.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.7.20240515.0

גרסה 2.7.20240214.1

• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-23.0.0.
• תאימות מאומתת לגרסה 2.7.20240214 של FiveAd SDK.

נבנה ונבדק באמצעות:

• גרסה 23.0.0 של Google Mobile Ads SDK.
• גרסה 2.7.20240214.0 של FiveAd SDK.

גרסה 2.7.20240214.0

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

נבנה ונבדק באמצעות:

• גרסה 22.6.0 של Google Mobile Ads SDK.
• גרסה 2.7.20240214.0 של FiveAd SDK.

גרסה 2.7.20240126.0

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

נבנה ונבדק באמצעות:

• גרסה 22.6.0 של Google Mobile Ads SDK.
• גרסה 2.7.20240126.0 של FiveAd SDK.

גרסה 2.7.20240112.0

• הוסר FiveAdViewEventListener שהוצא משימוש לטובת FiveAdCustomLayoutEventListener, ‏ FiveAdVideoRewardEventListener,‏ FiveAdInterstitialEventListener ו-FiveAdNativeEventListener.
• תאימות מאומתת לגרסה 2.7.20240112 של FiveAd SDK.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.6.0.

נבנה ונבדק באמצעות:

• גרסה 22.6.0 של Google Mobile Ads SDK.
• גרסת 2.7.20240112 של ערכת פיתוח תוכנה של FiveAd.

גרסה 2.6.20230607.1

• נוסף LineExtras class לבעלי אפליקציות שמאפשר להם להגדיר ברירות מחדל להגדרות הקול בפורמטים של מודעות באנר, מודעות מעברון ומודעות מתגמלות.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.4.0.

נבנה ונבדק באמצעות:

• גרסה 22.4.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.6.20230607.

גרסה 2.6.20230607.0

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

נבנה ונבדק באמצעות:

• גרסה 22.1.0 של Google Mobile Ads SDK.
• גרסת SDK‏ FiveAd‏ 2.6.20230607.