במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-nend באמצעות תהליך בחירת הרשת (Mediation), שכולל שילובים של Waterfall. נסביר איך להוסיף את nend להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של nend באפליקציהAndroid .
בממשק מרכז הבקרה של nend נעשה שימוש בטקסט ביפנית עבור התוויות, הלחצנים והתיאורים שלו, וצילומי המסך שמופיעים בהמשך לא תורגמו. במדריך הזה, יש התייחסויות לתוויות וללחצנים המקבילים להם באנגלית. לדוגמה,"כתובת URL スーム", הוא "סכמת כתובת URL", וכן הלאה.
שילובים נתמכים ופורמטים נתמכים של מודעות
המתאם של Ad Manager תהליך בחירת הרשת ב-nend כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
פרסומת מרווח ביניים | |
ההטבה הופעלה | |
מותאם |
דרישות
- Android API ברמת 19 ואילך
ה-SDK העדכני של מודעות Google לנייד
השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה
שלב 1: הגדרת הגדרות בממשק המשתמש של nend
כדי להוסיף את האפליקציה שלך למרכז השליטה של nend, ראשית לחץ על הכרטיסייה ניהול מיקומים ולאחר מכן בחר באפשרות אתר/אפליקציה. לחץ על הלחצן הוספת אפליקציה על מנת להוסיף את האפליקציה ל-nend.
יצירת אפליקציה
מזינים את שם האפליקציה ובוחרים את פלטפורמת האפליקציה בתור סוג האפליקציה. מזינים את כתובת ה-URL ובודקים אם האפליקציה מופיעה בחנות האפליקציות המתאימה
(אם האפליקציה שלכם עדיין לא פורסמה, תוכלו לעיין בשאלות הנפוצות בנושא אפליקציות שלא פורסמו). בחר קטגוריה לאפליקציה, ובסיום לחץ על יצירה.
לאחר יצירת האפליקציה, היא תוצג במרכז הבקרה.
יצירת מיקום מודעה
לאחר רישום האפליקציה, תוכלו לעבור ליצירת מיקום מודעה. כדי ליצור מיקום למודעות באנר, עוברים לכרטיסייה ניהול מיקומים ולוחצים על מיקום. לאחר מכן לוחצים על הלחצן יצירת מיקום חדש.
בוחרים את האפליקציה בתפריט הנפתח. לאחר מכן, בצעו את ההוראות הבאות התואמות לפורמט המודעה המועדף עליכם.
כרזה
בוחרים באפשרות Still image בשדה Ad type וב-Banner בשדה Inventory type. אחר כך מזינים שם מיקום, ממלאים את מבוא למלאי, בוחרים פורמט מלאי ובסוף בוחרים גודל מלאי. בסיום, לוחצים על הלחצן יצירה כדי ליצור את מיקום המודעה.
פרסומת מרווח ביניים
בחר באפשרות תמונת סטילס בשדה סוג מודעה, ובאפשרות מעברון בשדה סוג מלאי שטחי הפרסום. לאחר מכן מזינים שם מיקום, ממלאים את מבוא למלאי ובוחרים תדירות הצגת מודעות מהרשימה הנפתחת. בסיום, לוחצים על הלחצן יצירה כדי ליצור את מיקום המודעה.
עבור מודעות וידאו מסוג מעברון, בחר באפשרות וידאו בתור סוג המודעה, ובאפשרות מודעת מעברון עבור סוג מלאי שטחי הפרסום. אחרי שעושים את זה, מזינים שם מיקום, ממלאים את מבוא למלאי ובוחרים קטגוריה מתאימה מהרשימה הנפתחת. בסיום, לוחצים על הלחצן יצירה כדי ליצור את מיקום המודעה.
ההטבה הופעלה
בחר באפשרות Video בשדה Ad type וב-Reward עבור סוג המלאי. אחר כך מזינים שם מיקום, ממלאים את מבוא למלאי ובוחרים קטגוריה מתאימה מהרשימה הנפתחת.
בהגדרות התגמולים, בוחרים תוכן של תוכנית התגמולים מהרשימה הנפתחת ומזינים את שם המטבע הווירטואלי המועדף. בסיום, לוחצים על הלחצן יצירה כדי ליצור את מיקום המודעה.
מותאם
בחר באפשרות Still image בשדה Ad type וב-Native בקטע Inventory type. אחרי זה מזינים שם מיקום, ממלאים את מבוא למלאי ובוחרים בחירת תמונה במודעה. בסיום, לוחצים על הלחצן יצירה כדי ליצור את מיקום המודעה.
עבור מודעות וידאו מותאמות, בחר באפשרות וידאו בשדה סוג מודעה, ובאפשרות מותאמת (מותאם אישית) בשדה סוג מלאי. אחרי שעושים את זה, מזינים שם מיקום, ממלאים את מבוא למלאי ובוחרים קטגוריה מתאימה מהרשימה הנפתחת.
בקטע הגדרות מותאמות, בוחרים מהרשימה את האפשרות כיוון מודעת וידאו וסוג מודעה מותאמת. בסיום, לוחצים על הלחצן יצירה כדי ליצור את מיקום המודעה.
כדי להגדיר את Ad Manager יחידת המודעות בקטע הבא, צריך את apiKey ו-spotID לכל מיקום. כדי לאתר אותם, נכנסים לכרטיסייה ניהול מיקומים ולוחצים על הלחצן SDK מתחת לשם האפליקציה.
יש לשים לב ל-apiKey ול-spotID.
תצטרכו גם את מפתח ה-API שלכם בשביל ה-Reporting API של nend, שהוא נקרא מפתח API לגירוד נתונים. אפשר למצוא אותו בכרטיסייה כלים.
שלב 2: הגדרת 'ביקוש ברשת' Ad Manager בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
נכנסים לחשבון Ad Manager.
עבור אל הצגה > קבוצות תפוקה ולחץ על הלחצן קבוצת תפוקה חדשה.
מזינים שם ייחודי לקבוצת התפוקה, מגדירים את הסטטוס ל-Active, בוחרים את פורמט המודעה ומגדירים את סוג המלאי לאפליקציה לנייד. בקטע Targeting > Inventory (טירגוט > מלאי) בוחרים את יחידת המודעות בקטע Inventory (מלאי) וMobile application שרוצים להוסיף להם את תהליך בחירת הרשת.
לאחר מכן לוחצים על הלחצן הוספת שותף תפוקה.
אם כבר יש לכם שותף תפוקה עבורnend, אתם יכולים לבחור אותו. אם לא, בוחרים באפשרות יצירת שותף תפוקה חדש.
בוחרים באפשרות nend בתור רשת המודעות, מזינים שם ייחודי ומפעילים את תהליך בחירת הרשת.
מפעילים את האפשרות Automatic data collection (איסוף נתונים אוטומטי) ומזינים את הערךReporting API Key from the API Key for Scraping שקיבלתם בסעיף הקודם.
אחרי שבוחרים באפשרות Yield partner, בוחרים ב-Mobile SDK Mediation בתור סוג השילוב, ב-Android בתור הפלטפורמה וב-Active בתור Status. מזינים את Slot ID and API Key התקבל בקטע הקודם. לאחר מכן, מזינים ערך של עלות ברירת מחדל לאלף חשיפות.
לסיום, לוחצים על שמירה בחלק התחתון של הדף.
שלב 3: מייבאים את ה-SDK ואת המתאם של nend
שילוב עם Android Studio (מומלץ)
בקובץ settings.gradle.kts
ברמת הפרויקט, מוסיפים את המאגרים הבאים:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://fan-adn.github.io/nendSDK-Android-lib/library")
}
}
}
לאחר מכן, בקובץ build.gradle.kts
ברמת האפליקציה, מוסיפים את יחסי התלות וההגדרות הבאים של ההטמעה. השתמשו בגרסאות האחרונות של ה-SDK והמתאם של nend:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:nend:10.0.0.0")
}
שילוב ידני
מורידים את הגרסה האחרונה של nend Android SDK ומוסיפים אותה לפרויקט.
עוברים אל ארטיפקטים של מתאמי nend במאגר Maven ב-Google. בוחרים את הגרסה העדכנית ביותר, מורידים את הקובץ
.aar
של המתאם ל-nend ומוסיפים אותו לפרויקט.
שלב 5: מוסיפים את קוד החובה
לא נדרש קוד נוסף לשילוב עם nend.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- Ad Manager כדי לקבל מודעות בדיקה למודעות באנר, מודעות מעברון ומודעות מתגמלות, nend ממליץ להשתמש במפתחות ה-API ובמזהי Spot שמופיעים בדף יחידות מודעות לבדיקה . במהלך הבדיקה אפשר להזין את המפתחות האלה כמפתחות API ומזהי Spot של יחידות המודעות ב-AdMob, ואז להחליף אותם במפתח API ובמזהה Spot כשהאפליקציה מוכנה לייצור.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-nend, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות nend (Waterfall) מקורות המודעות.
שלבים אופציונליים
פרמטרים ספציפיים לרשת
המתאם של nend תומך בפרמטרים נוספים של בקשה, שאפשר להעביר למתאם באמצעות המחלקה NendExtrasBundleBuilder
.
הכיתה הזו כוללת את השיטות הבאות:
setInterstitialType(InterstitialType)
: ב-Nend אפשר לבחור באחת מהאפשרויות הבאות:TYPE_NORMAL
למודעות מעברון רגילות, אוTYPE_VIDEO
למודעות וידאו מסוג מעברון. כברירת מחדל, ב-Nend נעשה שימוש ב-TYPE_NORMAL
כסוג מודעת המעברון אם לא מוסיפים את הפרמטר הנוסף.setNativeAdsType(nativeAdsType)
: ב-Nend אפשר לבחור באחת מהאפשרויות הבאות:TYPE_NORMAL
למודעות מותאמות רגילות, אוTYPE_VIDEO
למודעות וידאו מותאמות. כברירת מחדל, ב-Nend נעשה שימוש ב-TYPE_NORMAL
כסוג המודעה המותאמת, אם לא מוסיפים את הפרמטר הנוסף.
Java
Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
.setInterstitialType(InterstitialType.TYPE_NORMAL)
.setNativeAdsType(FormatType.TYPE_NORMAL)
.build();
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(NendAdapter.class, bundle)
.build();
adLoader.loadAd(adRequest);
Kotlin
val bundle = NendAdapter.NendExtrasBundleBuilder()
.setInterstitialType(InterstitialType.TYPE_NORMAL)
.setNativeAdsType(FormatType.TYPE_NORMAL)
.build()
val adRequest = AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(NendAdapter.class, bundle)
.build()
adLoader.loadAd(adRequest)
שימוש במודעות מותאמות
הצגת מודעות
המתאם של Nend מחזיר את המודעות המותאמות שלו בתור
NativeAd
אובייקטים. השדה הזה מאכלס את
השדות
NativeAd
.
שדה | שדה זה מאוכלס על ידי מתאם Nend |
---|---|
כותרת | |
תמונה | 1 |
גוף | |
סמל האפליקציה | 2 |
קריאה לפעולה (CTA) | |
שם המפרסם | |
Star rating | |
חנות | |
מחיר |
1 Nend בלבד מספקת נכס תמונות למיקומי מודעות מותאמים, שהוגדרו עם בחירת תמונה של מודעה שמוגדרת כתמונת פרסום גדולה (5: 3) אופקית.
2 ב-Nend אין נכס מסוג סמל למיקומי מודעות מותאמים, שהוגדרו כאשר האפשרות בחירת תמונה של מודעה מוגדרת כ-No image (text בלבד).
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-nend, בעלי אפליקציות יכולים לבדוק את השגיאה הבסיסית מהתגובה למודעה באמצעות
ResponseInfo.getAdapterResponse()
מחלקות הבאות:
מבנה הקורס | שם הכיתה |
---|---|
כרזה | com.google.ads.mediation.nend.NendAdapter |
פרסומת מרווח ביניים | com.google.ads.mediation.nend.NendAdapter |
ההטבה הופעלה | com.google.ads.mediation.nend.NendRewardedAdapter |
מותאם | com.google.ads.mediation.nend.NendMediationAdapter |
ריכזנו כאן את הקודים וההודעות הנלוות שהתקבלו ממתאם nend כשטעינת מודעה נכשלת:
קוד שגיאה | דומיין | סיבה |
---|---|---|
101 | com.google.ads.mediation.nend | nend זקוק להקשר של פעילות כדי לטעון ולהציג מודעות. |
102 | com.google.ads.mediation.nend | הפרמטרים של שרת nend שהוגדרו Ad Manager בממשק המשתמש חסרים/לא חוקיים. |
103 | com.google.ads.mediation.nend | מודעת nend עדיין לא מוכנה להצגה. |
104 | com.google.ads.mediation.nend | nend לא הצליח להפעיל את המודעה. |
105 | com.google.ads.mediation.nend | גודל המודעה המבוקש אינו תואם את גודל הבאנר הנתמך של nend. |
106 | com.google.ads.mediation.nend | ההפניה לאובייקט ההקשר היא null ו/או שהיא שוחררה לאחרונה מהזיכרון. |
200-299 | net.nend.android | nend SDK החזיר שגיאה בטעינת מודעת המעברון. לפרטים נוספים, ראו קוד. |
300-399 | net.nend.android | nend SDK החזיר שגיאה בהצגת מודעת מעברון. לפרטים נוספים, ראו קוד. |
400-499 | net.nend.android | nend SDK החזיר שגיאת מודעה. לפרטים נוספים, ראו קוד. |
101 | com.google.mediation.nend | nend SDK החזיר קריאה חוזרת (callback) לכשל בטעינה, ללא מידע נוסף על השגיאה. |
102 | com.google.mediation.nend | nend SDK החזיר קריאה חוזרת (callback) של הצגת הבעיה ללא מידע נוסף על השגיאה. |
103 | com.google.mediation.nend | הפרמטרים של שרת nend שהוגדרו Ad Manager בממשק המשתמש חסרים/לא חוקיים. |
104 | com.google.mediation.nend | הטעינה של נכסי התמונות של המודעות המותאמות נכשלה. |
105 | com.google.mediation.nend | הצגת המודעות ב-nend נכשלה כי המודעה לא מוכנה. |
106 | com.google.mediation.nend | הגודל המבוקש של מודעת הבאנר אינו תואם לגודל נתמך של מודעת הבאנר. |
200-699 | ההודעה נשלחה על ידי nend SDK. | nend SDK החזיר שגיאה. אפשר לקרוא פרטים נוספים במסמך של nend. |
יומן שינויים של מתאם תהליך בחירת הרשת של nend
גרסה 10.0.0.0
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.3.0.
- התאימות מאומתת ל-nend SDK 10.0.0.
נוצר ונבדק עם
- גרסה 22.3.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 10.0.0.
גרסה 9.0.1.0
- המתאם עודכן לשימוש במחלקה חדשה של
VersionInfo
. - הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.0.0.
- התאימות מאומתת ל-nend SDK 9.0.1.
נוצר ונבדק עם
- גרסה 22.0.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 9.0.1.
גרסה 9.0.0.0
- התאימות מאומתת ל-nend SDK 9.0.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.2.0.
נוצר ונבדק עם
- גרסה 21.2.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 9.0.0.
גרסה 8.2.0.0
- התאימות מאומתת ל-nend SDK 8.2.0.
נוצר ונבדק עם
- גרסה 21.0.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 8.2.0.
גרסה 8.1.0.1
compileSdkVersion
ו-targetSdkVersion
עודכנו ל-API 31.- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.0.0.
נוצר ונבדק עם
- גרסה 21.0.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 8.1.0.
גרסה 8.1.0.0
- התאימות מאומתת ל-nend SDK 8.1.0.
- תוקנה קריסה של
NullPointerException
כש-nend החזיר כתובת URL של לוגו או של תמונה במודעהnull
. - הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.5.0.
נוצר ונבדק עם
- גרסה 20.5.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 8.1.0.
גרסה 8.0.1.0
- התאימות מאומתת ל-nend SDK 8.0.1.
- תוקן באג שגרם להחזרת
AdError
אובייקטים באמצעות דומיין שגוי. - הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.4.0.
נוצר ונבדק עם
- גרסה 20.4.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 8.0.1.
גרסה 7.1.0.0
- התאימות מאומתת ל-nend SDK 7.1.0.
- קודי השגיאה עודכנו כדי לתעד את השגיאה
UNSUPPORTED_DEVICE
מסוג nend. - הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.2.0.
נוצר ונבדק עם
- גרסה 20.2.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 7.1.0.
גרסה 7.0.3.0
- התאימות מאומתת ל-nend SDK 7.0.3.
- נוספו קודי שגיאה תיאוריים וסיבות לכשלים בטעינת המתאם/הצגה.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.0.0.
נוצר ונבדק עם
- גרסה 20.0.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 7.0.3.
גרסה 7.0.0.0
- התאימות מאומתת ל-nend SDK 7.0.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.4.0.
נוצר ונבדק עם
- גרסה 19.4.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 7.0.0.
גרסה 6.0.1.0
- התאימות מאומתת ל-nend SDK 6.0.1.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.3.0.
נוצר ונבדק עם
- גרסה 19.3.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 6.0.1.
גרסה 6.0.0.0
- התאימות מאומתת ל-nend SDK 6.0.0.
- הגרסה המינימלית של Android SDK עודכנה ל-API 19.
נוצר ונבדק עם
- גרסה 19.2.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 6.0.0.
גרסה 5.4.2.1
- המתאם עודכן כך שיתמוך בבקשות מוטבעות של מודעות באנר מותאמות.
- תוקנה קריסה של תנאי מרוץ נדיר שייתכן שהתרחשה כשמודעות באנר חכמות מושמדות.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.2.0.
נוצר ונבדק עם
- גרסה 19.2.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 5.4.2.
גרסה 5.4.2.0
- הוספנו תמיכה במודעות מותאמות.
- התאימות מאומתת ל-nend SDK 5.4.2.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.0.0.
נוצר ונבדק עם
- גרסה 19.0.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 5.4.2.
גרסה 5.3.0.0
- התאימות מאומתת ל-nend SDK 5.3.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-18.2.0.
נוצר ונבדק עם
- גרסה 18.2.0 של Google Mobile Ads SDK.
- Nend SDK גרסה 5.3.0.
גרסה 5.2.0.0
- התאימות מאומתת ל-nend SDK 5.2.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-18.1.1.
גרסה 5.1.0.4
- תוקנה בעיה שבה מודעות באנר ומודעות מעברון לא העבירו את האירוע
onAdClicked()
. - תוקנה בעיה שבה
NullPointerException
נורה כאשר מודעת באנר של nend נהרסה. - המתאם הועבר ל-AndroidX.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-18.0.0.
גרסה 5.1.0.3
- נוספה הטמעה להצגת חלק ממודעת הבאנר ב-SmartBanner. גודל מתאים למודעות באנר חכמות
- לאורך ולרוחב
- טלפונים: 320×50
- טאבלטים: 728×90 או 320×50
- לאורך ולרוחב
גרסה 5.1.0.2
- נוספה תמיכה בגדלים גמישים של מודעות באנר.
גרסה 5.1.0.1
- המתאם עודכן ועכשיו הוא תומך ב-API חדש של מודעות מתגמלות בגרסת בטא פתוחה.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-17.2.0.
גרסה 5.1.0.0
- התאימות מאומתת ל-nend SDK 5.1.0.
גרסה 5.0.2.1
- הוסרה פונקציה שמעבירה תכונות משתמש כי השיטות הבאות הוצאו משימוש בתאריך
AdRequest.Builder
.setGender()
setBirthday()
setIsDesignedForFamiles()
גרסה 5.0.2.0
- התאימות מאומתת ל-nend SDK 5.0.2.
גרסה 5.0.1.0
- התאימות מאומתת ל-nend SDK 5.0.1.
גרסה 5.0.0.0
- התאימות מאומתת ל-nend SDK 5.0.0.
גרסה 4.0.5.0
- התאימות מאומתת ל-nend SDK 4.0.5.
גרסה 4.0.4.1
- נתמכת בשיטת RewardedVideoAdListener.
גרסה 4.0.4.0
- התאימות מאומתת ל-nend SDK 4.0.4.
גרסה 4.0.2.1
- נוספה האפשרות ליצור
Bundle
תוספות לתהליך בחירת הרשת באמצעות המחלקהNendExtrasBundleBuilder
.
גרסה 4.0.2.0
- גרסה ראשונה בפרויקט קוד פתוח של תהליך בחירת הרשת (Mediation) ב-Google לנייד.
- הוספנו תמיכה במודעות באנר, במודעות מעברון ובמודעות וידאו מתגמלות.