שילוב nend עם הגישור

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

בממשק מרכז הבקרה של nend נעשה שימוש בטקסט ביפנית עבור התוויות, הלחצנים והתיאורים שלו, וצילומי המסך שמופיעים בהמשך לא תורגמו. במדריך הזה, יש התייחסויות לתוויות וללחצנים המקבילים להם באנגלית. לדוגמה,"כתובת URL スーム", הוא "סכמת כתובת URL", וכן הלאה.

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

המתאם של Ad Manager תהליך בחירת הרשת ב-nend כולל את היכולות הבאות:

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

דרישות

  • Android API ברמת 19 ואילך

שלב 1: הגדרת הגדרות בממשק המשתמש של nend

נרשמים או נכנסים לחשבון 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

בקובץ 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")
}

שילוב ידני

  1. מורידים את הגרסה האחרונה של nend Android SDK ומוסיפים אותה לפרויקט.

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