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

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

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

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

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

דרישות

• יעד פריסה 13.3 ומעלה ב-iOS

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

• חדש מערוץ Google Mobile Ads SDK

• ביצוע של תהליך בחירת הרשת מדריך לתחילת העבודה

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

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

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

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

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

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

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

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

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

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

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

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

עוברים לכרטיסייה Managing reporting API keys (ניהול מפתחות Reporting API) ולוחצים על הלחצן Create API key (יצירת מפתח 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 בממשק המשתמש של Ad Manager

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

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

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

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

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

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

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

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

שימוש ב-Swift Package Manager

לפני שממשיכים, צריך לוודא שיש לכם את הגרסה המינימלית הנתמכת של המתאם: 2.9.20251119.

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

1. ב-Xcode, עוברים אל File > Add Package Dependencies...‎ (קובץ > הוספת תלות בחבילה…).

2. בהנחיה שמופיעה, מחפשים את כתובת ה-URL של החבילה הבאה:

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. בקטע Dependency Rule, בוחרים באפשרות Branch.

4. בשדה הטקסט, מזינים main.

שימוש ב-CocoaPods

מוסיפים את השורה הבאה לקובץ Podfile של הפרויקט:

pod 'GoogleMobileAdsMediationLine'

מריצים את הפקודה הבאה משורת הפקודה:

pod install --repo-update

שילוב ידני

• מורידים את הגרסה העדכנית של LY Ads Network SDK ומקשרים את FiveAd.framework לפרויקט.
• מורידים את הגרסה העדכנית של המתאם של LY Ads Network מהקישור להורדה ביומן השינויים ומקשרים את LineAdapter.framework לפרויקט.

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

הטמעה של SKAdNetwork

פועלים לפי מאמרי העזרה של LY Ads Network כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

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

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

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

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

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

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

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

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

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

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

adAudio

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

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

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

#import <LineAdapter/LineAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

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

רינדור מודעות

המתאם של LY Ads Network מאכלס את השדות הבאים של GADNativeAd.

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

קודי שגיאה

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

GADMediationAdapterLine

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

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

גרסה 3.0.1.2

• מעדכנים את הגרסה המינימלית של iOS כדי להקל על התלות ב-Google Mobile Ads SDK ולאפשר גרסאות משניות.
• תוקנה בעיה שבה הסמל AdChoices במודעות מותאמות היה גדול מדי.

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

• גרסה 13.4.0 של Google Mobile Ads SDK.
• גרסה 3.0.1 של FiveAd SDK.

גרסה 3.0.1.1

• המתאם מעביר עכשיו את הדגל ageRestrictedTreatment של Google Mobile Ads SDK אל COPPA API של FiveAd SDK.

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

• גרסה 13.3.0 של Google Mobile Ads SDK.
• גרסה 3.0.1 של FiveAd SDK.

גרסה 3.0.1.0

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

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

• גרסה 13.1.0 של Google Mobile Ads SDK.
• גרסה 3.0.1 של FiveAd SDK.

גרסה 3.0.0.1

• עדכנו את התלות ב-Google Mobile Ads SDK לגרסה 13.0.0.

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

• גרסה 13.0.0 של Google Mobile Ads SDK.
• גרסה 3.0.0 של FiveAd SDK.

גרסה 3.0.0.0

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

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

• גרסה 12.14.0 של Google Mobile Ads SDK.
• גרסה 3.0.0 של FiveAd SDK.

גרסה 2.9.20251119.1

• נוספה תמיכה בהעברה של פרמטרים של Google Mobile Ads SDK עם התג tagForUnderAgeOfConsent אל FiveAd SDK.

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

• גרסה 12.14.0 של Google Mobile Ads SDK.
• גרסה 2.9.20251119 של FiveAd SDK.

גרסה 2.9.20251119.0

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

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

• גרסה 12.14.0 של Google Mobile Ads SDK.
• גרסה 2.9.20251119 של FiveAd SDK.

גרסה 2.9.20250930.0

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

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

• גרסה 12.12.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.9.20250930.

גרסה 2.9.20250912.0

• המתאם מאתחל עכשיו את FiveAd SDK לפני כל בקשה להצגת מודעה.
• תאימות מאומתת לגרסה 2.9.20250912 של FiveAd SDK.

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

• גרסה 12.11.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.9.20250912.

גרסה 2.9.20250512.0

• נדרשת עכשיו גרסת iOS מינימלית של 13.0.
• תאימות מאומתת לגרסה 2.9.20250512 של FiveAd SDK.

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

• גרסה 12.4.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.9.20250512.

גרסה 2.9.20241106.3

• תוקנה בעיה שבה GADMediationAdapterLine.h לא הייתה כותרת שגלוי לכולם.
• הפעלתם את התכונות הניסיוניות -fobjc-arc ו--fstack-protector-all.
• הסרנו את האימות של גודל מודעת הבאנר להגשת הצעות מחיר אחרי טעינה מוצלחת.
  • מודעות באנר בשיטת Waterfall ימשיכו לבדוק את הגדלים של מודעות הבאנר אחרי שהטעינה תושלם.

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

• גרסה 12.2.0 של Google Mobile Ads SDK.
• גרסה 2.9.20241106 של FiveAd SDK.

גרסה 2.9.20241106.2

• נוסף המאפיין GADMediationAdapterLine.testMode כדי לציין אם צריך לאתחל את FiveAd SDK במצב בדיקה. צריך להגדיר את הדגל הזה לפני שמפעילים את Google Mobile Ads SDK.
• הוסר הבדיקה של מצב האתחול של FiveAd SDK לפני האתחול של FiveAd SDK.
• הסרנו את בדיקת הסטטוס של המודעות המותאמות שהוצאו משימוש לפני הורדת נכסי מודעות מותאמות.
• מעכשיו נדרשת גרסה 12.0.0 ואילך של Google Mobile Ads SDK.

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

• גרסה 12.0.0 של Google Mobile Ads SDK.
• גרסה 2.9.20241106 של FiveAd SDK.

גרסה 2.9.20241106.1

• המתאם עודכן כך שישתמש ב-API העדכני ביותר לטעינת מודעות לצורך הגשת הצעות מחיר על מודעות באנר.
• תוקנה בעיה שגרמה לכך שאירועים שקשורים למודעות לא הועברו בצורה תקינה למודעות מעברון שמוצגות בזמן הגשת הצעות מחיר.

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

• גרסה 11.12.0 של Google Mobile Ads SDK.
• גרסה 2.9.20241106 של FiveAd SDK.

גרסה 2.9.20241106.0

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

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

• גרסה 11.12.0 של Google Mobile Ads SDK.
• גרסה 2.9.20241106 של FiveAd SDK.

גרסה 2.8.20240827.1

• התפקיד של CFBundleShortVersionString עודכן כך שיש בו שלושה רכיבים במקום ארבעה.

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

• גרסה 11.10.0 של Google Mobile Ads SDK.
• גרסה 2.8.20240827 של FiveAd SDK.

גרסה 2.8.20240827.0

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

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

• גרסה 11.8.0 של Google Mobile Ads SDK.
• גרסה 2.8.20240827 של FiveAd SDK.

גרסה 2.8.20240612.0

• הוספנו אמצעי בקרה לאודיו במודעות מותאמות באמצעות GADVideoOptions.
• תאימות מאומתת לגרסה FiveAd SDK version 2.8.20240612.

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

• גרסה 11.5.0 של Google Mobile Ads SDK.
• גרסה 2.8.20240612 של FiveAd SDK.

גרסה 2.7.20240411.0

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

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

• גרסה 11.3.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.7.20240411.

גרסה 2.7.20240318.0

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

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

• גרסה 11.2.0 של Google Mobile Ads SDK.
• גרסה 2.7.20240318 של FiveAd SDK.

גרסה 2.7.20240214.1

• נדרשת עכשיו גרסת iOS מינימלית 12.0.
• מעכשיו נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
• הכללה של Info.plist במסגרות בתוך LineAdapter.xcframework.

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

• גרסה 11.0.1 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.7.20240214.

גרסה 2.7.20240214.0

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

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

• גרסה 11.0.1 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.7.20240214.

גרסה 2.7.20240126.0

• תאימות מאומתת לגרסה 2.7.20240126 של FiveAd SDK.
• העדכון של הטמעת המתאם כולל פרוטוקולי נציגים חדשים של FiveAd SDK.

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

• גרסה 10.14.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.7.20240126.

גרסה 2.7.20231115.0

• תאימות מאומתת לגרסה 2.7.20231115 של FiveAd SDK.
• הכותרת GADMediationAdapterLineExtras כלולה ב-modulemap.

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

• גרסה 10.14.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.7.20231115.

גרסה 2.6.20230609.1

• נוסף GADMediationAdapterLineAudioState כדי לנהל את מצב האודיו הראשוני של הבאנר, המודעה הביניים והמודעה המתגמלת כשהם מוצגים בפעם הראשונה.

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

• גרסה 10.14.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.6.20230609.

גרסה 2.6.20230609.0

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

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

• גרסה 10.9.0 של Google Mobile Ads SDK.
• גרסת FiveAd SDK‏ 2.6.20230609.