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

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

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

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

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

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

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

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

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

שלב 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 ולוחצים על הכפתור 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, אתם יכולים לבחור אותו. אחרת, לוחצים על הוספת מיפוי.



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

מפל

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

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




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



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

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

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

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

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

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. עוברים אל פריטי המידע של מתאם LY Ads Network במאגר Maven של Google. בוחרים את הגרסה העדכנית, מורידים את קובץ ה-.aar של המתאם של רשת המודעות LY Ads ומוסיפים אותו לפרויקט.

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

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

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

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

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

המתאם של רשת המודעות LY Ads כולל שיטת עזר להפעלת מצב בדיקה ברשת המודעות LY Ads. צריך להגדיר את האפשרות הזו לפני שמפעילים את Google Mobile Ads SDK (Legacy) כדי לוודא שהיא תועבר בצורה תקינה אל 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 מאכלס את השדות הבאים של מודעות מותאמות מסוג Advanced ב-NativeAd.

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

קודי שגיאה

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

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

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

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

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

• תאימות מאומתת עם 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.