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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

רושמים את מזהה מיקום המודעה.

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

יצירת מפתח Reporting API

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

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

חשוב לשים לב למזהה מפתח ה-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.

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

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

בסיום, לוחצים על שמירה.

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

מפל

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

גוללים אל Yield partners (שותפים להגדלת נפח התנועה) ולוחצים על Add mediation partner (הוספת שותף בתהליך בחירת הרשת).

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

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

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

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

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

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

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

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

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

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

חשוב: לפני שמפרסמים את האפליקציה, צריך להשבית את מצב הבדיקה ב-Ad Manager וב-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 מאכלס את השדות הבאים של 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	ה-SDK של רשת המודעות LY החזיר שגיאה ספציפית ל-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.
• תאימות מאומתת לגרסה 3.1.0.0 של FiveAd SDK.

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

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

• תאימות מאומתת לגרסה 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

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

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

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

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

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

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

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

גרסה 2.7.20240214.0

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

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

• גרסה 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.
• תאימות מאומתת לגרסה 2.7.20240112 של FiveAd SDK.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.6.0.

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

• גרסה 22.6.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.7.20240112.

גרסה 2.6.20230607.1

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