שילוב nend עם תהליך בחירת הרשת (Mediation)

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

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

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

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

דרישות

  • Unity 4 ואילך
  • ה-SDK העדכני של מודעות Google לנייד
  • כדי לפרוס ב-Android
    • Android API ברמת 19 ואילך
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Unity פועל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
  • משלימים את ההוראות של תהליך בחירת הרשת (Mediation) המדריך לתחילת העבודה

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

נרשמים או נכנסים לחשבון nend.

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

יצירת אפליקציה

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

(אם האפליקציה שלכם עדיין לא פורסמה, תוכלו לעיין בשאלות הנפוצות בנושא אפליקציות שלא פורסמו). בחר קטגוריה לאפליקציה, ובסיום לחץ על יצירה.

Android

iOS

לאחר יצירת האפליקציה, היא תוצג במרכז הבקרה.

Android

iOS

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

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

בוחרים את האפליקציה בתפריט הנפתח. לאחר מכן, בצעו את ההוראות הבאות התואמות לפורמט המודעה המועדף עליכם.

בוחרים באפשרות Still image בשדה Ad type וב-Banner בשדה Inventory type. אחר כך מזינים שם מיקום, ממלאים את מבוא למלאי, בוחרים פורמט מלאי ובסוף בוחרים גודל מלאי. בסיום, לוחצים על הלחצן יצירה כדי ליצור את מיקום המודעה.

פרסומת מרווח ביניים

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

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

ההטבה הופעלה

בחר באפשרות Video בשדה Ad type וב-Reward עבור סוג המלאי. אחר כך מזינים שם מיקום, ממלאים את מבוא למלאי ובוחרים קטגוריה מתאימה מהרשימה הנפתחת.

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

מותאם

בחר באפשרות Still image בשדה Ad type וב-Native בקטע Inventory type. אחרי זה מזינים שם מיקום, ממלאים את מבוא למלאי ובוחרים בחירת תמונה במודעה. בסיום, לוחצים על הלחצן יצירה כדי ליצור את מיקום המודעה.

עבור מודעות וידאו מותאמות, בחר באפשרות וידאו בשדה סוג מודעה, ובאפשרות מותאמת (מותאם אישית) בשדה סוג מלאי. אחרי שעושים את זה, מזינים שם מיקום, ממלאים את מבוא למלאי ובוחרים קטגוריה מתאימה מהרשימה הנפתחת.

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

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

יש לשים לב ל-apiKey ול-spotID.

תצטרכו גם את מפתח ה-API שלכם בשביל ה-Reporting API של nend, שהוא נקרא מפתח API לגירוד נתונים. אפשר למצוא אותו בכרטיסייה כלים.

שלב 2: הגדרת 'ביקוש ברשת' AdMob בממשק המשתמש

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

שלב 3: מייבאים את ה-SDK ואת המתאם של nend

צריך להוריד את הגרסה האחרונה של הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads עבור nend בקישור להורדה ב-Changelog ולחלץ את החבילה GoogleMobileAdsNendMediation.unitypackage מהקובץ zip.

בעורך הפרויקטים ב-Unity, לוחצים על Assets > Import Package > Custom Package (נכסים > ייבוא חבילה > חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsNendMediation.unitypackage שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על ייבוא.

לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force Solution. ספריית Unity Play Services Solutionr תבצע פתרון תלויי מההתחלה ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android של אפליקציית Unity.

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

Android

לא נדרש קוד נוסף לשילוב עם nend.

iOS

שילוב של SKAdNetwork

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

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

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

חשוב לרשום את מכשיר הבדיקה ל- AdMob כדי לקבל מודעות בדיקה למודעות באנר, מודעות מעברון ומודעות מתגמלות, nend ממליץ להשתמש במפתחות ה-API ובמזהי Spot שמופיעים בדף הוספה של יחידות מודעות לבדיקה . במהלך הבדיקה אפשר להזין את המפתחות האלה כמפתחות API ומזהי Spot של יחידות המודעות ב-AdMob, ואז להחליף אותם במפתח API ובמזהה Spot כשהאפליקציה מוכנה לייצור.

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

כדי לוודא שמוצגות לך מודעות לבדיקה מ-nend, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות nend (Waterfall) מקורות המודעות.

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-nend, בעלי אפליקציות יכולים לבדוק את השגיאה הבסיסית מתגובת המודעה באמצעות ResponseInfo במחלקות הבאות:

Android

com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter

iOS

GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend

ריכזנו כאן את הקודים וההודעות הנלוות שהתקבלו ממתאם nend כשטעינת מודעה נכשלת:

Android

קוד שגיאה דומיין סיבה
101 com.google.ads.mediation.nend nend זקוק להקשר של פעילות כדי לטעון ולהציג מודעות.
102 com.google.ads.mediation.nend הפרמטרים של שרת nend שהוגדרו AdMob בממשק המשתמש חסרים/לא חוקיים.
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 החזיר שגיאת מודעה. לפרטים נוספים, ראו קוד.

iOS

קוד שגיאה דומיין סיבה
101 com.google.mediation.nend nend SDK החזיר קריאה חוזרת (callback) לכשל בטעינה, ללא מידע נוסף על השגיאה.
102 com.google.mediation.nend nend SDK החזיר קריאה חוזרת (callback) של הצגת הבעיה ללא מידע נוסף על השגיאה.
103 com.google.mediation.nend הפרמטרים של שרת nend שהוגדרו AdMob בממשק המשתמש חסרים/לא חוקיים.
104 com.google.mediation.nend הטעינה של נכסי התמונות של המודעות המותאמות נכשלה.
105 com.google.mediation.nend הצגת המודעות ב-nend נכשלה כי המודעה לא מוכנה.
106 com.google.mediation.nend הגודל המבוקש של מודעת הבאנר אינו תואם לגודל נתמך של מודעת הבאנר.
200-699 ההודעה נשלחה על ידי nend SDK. nend SDK החזיר שגיאה. אפשר לקרוא פרטים נוספים במסמך של nend.

יומן שינויים של הפלאגין לגישור nend

גרסה 8.0.0

גרסה 7.0.0

גרסה 6.0.1

גרסה 6.0.0

גרסה 5.2.0

גרסה 5.1.0

גרסה 5.0.0

גרסה 4.0.1

גרסה 4.0.0

גרסה 3.0.0

גרסה 2.3.0

גרסה

גרסה

  • הפלאגין עודכן כך שיתמוך בממשק ה-API החדש של מתגמלות.
  • תמיכה במתאם Android ל-nend בגרסה 5.1.0.2.
  • יש תמיכה במתאם nend ל-iOS בגרסה 5.1.1.0.

גרסה 2.0.3

  • תמיכה במתאם Android ל-nend בגרסה 5.0.2.1.
  • תמיכה במתאם nend ל-iOS בגרסה 5.0.2.0.

גרסה 2.0.2

  • תמיכה במתאם Android ל-nend בגרסה 5.0.2.0.
  • תמיכה במתאם nend ל-iOS בגרסה 5.0.2.0.

גרסה 2.0.1

  • תמיכה במתאם Android ל-nend בגרסה 5.0.2.0.
  • יש תמיכה במתאם nend ל-iOS בגרסה 5.0.1.0.

גרסה

  • יש תמיכה במתאם Android של nend בגרסה 5.0.0.0.
  • יש תמיכה במתאם nend ל-iOS בגרסה 5.0.0.0.

גרסה 1.0.2

  • יש תמיכה במתאם Android של nend בגרסה 4.0.5.0.
  • יש תמיכה במתאם nend ל-iOS בגרסה 4.0.6.0.

גרסה 1.0.1

  • תמיכה ב-nend Android SDK בגרסה 4.0.4.
  • תמיכה ב-nend iOS SDK בגרסה 4.0.4.

גרסה 1.0.0

  • השקה ראשונה!
  • תמיכה ב-nend Android SDK בגרסה 4.0.2.
  • תומך ב-nend iOS SDK בגרסה 4.0.2.