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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

נכנסים לחשבון ניהול Ad Manager.

הוספת LY Ads Network לחברות

הפעלת שיתוף אותות מאובטחים

שיתוף אותות מאובטחים בבקשות להצעות מחיר

איך מאפשרים שיתוף של אותות מאובטחים בבידינג מבוסס SDK חיצוני

הגדרת בידינג ב-LY Ads Network

הגדרת מיפוי של יחידות מודעות

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.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")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.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 רשת מודעות SDK ומוסיפים אותו לפרויקט.

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

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

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

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

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

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

המתאם של רשת המודעות LY Ads כולל שיטת עזר להפעלת מצב בדיקה ברשת המודעות LY Ads. צריך להגדיר את האפשרות הזו לפני שמפעילים את GMA Next-Gen SDK כדי לוודא שהיא תועבר בצורה תקינה אל LY Ads Network SDK.

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

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

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

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

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

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

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

enableAdSound

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

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

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

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

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.

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

קודי שגיאה

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

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של LY Ads Network כשהטעינה של מודעה נכשלת:

יומן השינויים של מתאם תהליך בחירת הרשת של 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.