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

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

בגרסה 7.0.0 ואילך של Mobile Ads Unity, אפשר:

• בדיקת יחידות המודעות
• בדיקת המתאמים של הצד השלישי
• לבדוק אם המודעות מתמלאות כמצופה
• לזהות שגיאות ולראות איך לפתור אותן
• להציג את פרטי הבידינג ואת פרטי ה-Waterfall בתהליך בחירת הרשת (Mediation) של כל רשת מודעות לכל בקשה
• בדיקה של מקורות מודעות ספציפיים של צד שלישי לבידינג ולבחירת רשת

• ודאו שהגדרתם בצורה נכונה כל יחידת מודעות לבידינג ולתהליך בחירת הרשת (Mediation) ב-Waterfall

• בדיקת שילובים של אירועים מותאמים אישית

במדריך הזה נסביר איך להשיק את התכונות השונות בכלי לבדיקת מודעות ולהשתמש בהן.

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

כדי להשתמש בכלי לבדיקת מודעות, צריך:

• יצירת חשבון AdMob והגדרת אפליקציה.

• קוראים את המדריך לתחילת העבודה.

• משתמשים בפלאגין של Mobile Ads ל-Unity בגרסה 7.0.0 ואילך.

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

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

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

1. משתמשים בתנועה שנבחרה בממשק המשתמש של AdMob כשרושמים מכשיר בדיקה.
2. באופן פרוגרמטי באמצעות ממשק ה-API שסופק.
3. משתמשים בלחצן ההפעלה בתפריט ניפוי הבאגים.

הפעלה באמצעות תנועות

אין צורך לבצע שינויים באפליקציה כדי להפעיל הכלי לבדיקת מודעות באמצעות תנועה. פשוט צריך לבצע את התנועה (הקפצה כפולה או ניעור) שהגדרתם ב-AdMob במכשיר הבדיקה. מידע נוסף

אחרי שמגדירים תנועה בממשק המשתמש של AdMob (וממתינים 15 דקות להפצתה), האפליקציה צריכה לשלוח בקשה להצגת מודעה ל-SDK של Google Mobile Ads כדי ללמוד על הגדרת התנועה שלכם. אם התנועה שציינתם לא פועלת, נסו לטעון מודעה, להפעיל מחדש את האפליקציה ולבדוק שוב את התנועה.

הפעלה באופן פרוגרמטי

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

public void OnButtonClick() {
  MobileAds.OpenAdInspector((AdInspectorError error) =>
  {
    // Error will be set if there was an issue and the inspector was not displayed.
  });
}

ה-API הזה פועל במכשירי בדיקה שנרשמו באופן פרוגרמטי או בממשק המשתמש של AdMob.

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

לאחר ההפעלה, יופיע המסך הראשי של בודק המודעות, שכולל רשימה של כל יחידות המודעות בממשק המשתמש של AdMob שמשויכות למזהה האפליקציה ב-AdMob, ויש להן הגדרות בידינג או תהליך בחירת רשת (Mediation):

מומלץ להפעיל את Google Mobile Ads SDK לפני שמשתמשים בכלי לבדיקת המודעות.

הצגת פרטי ה-Waterfall בתהליך בחירת הרשת (Mediation) של יחידת מודעות

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

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

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

הצגת פרטי הבידינג של יחידת מודעות

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

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

תוצאות הבידינג ממוינות כך שהפריטים שאפשר לבצע בהם פעולה מוצגים קרוב יותר לחלק העליון של הרשימה:

• בחלק העליון מוצגת רשת המודעות שזכתה במכרז.

• לאחר מכן מופיעות רשתות המודעות שזוהו בהן בעיות. תוכלו להיעזר בשלבים לפתרון הבעיות.

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

• לבסוף, בתחתית הרשימה מופיעות רשתות המודעות שהפסידו במכרז הבידינג.

  

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

כשמקור מודעות מופעל ב-Waterfall של תהליך בחירת הרשת, הוא יכול להציג מודעות. למידע נוסף על האופן שבו הבידינג עובד עם רשימת הרשתות בתהליך בחירת הרשת, ראו דוגמה 2 ודוגמה 3 למקורות מודעות לבידינג ולמקורות מודעות ב-Waterfall בקבוצה לבחירת רשת.

ניפוי באגים מתקדם של יחידות מודעות

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

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

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

Android

iOS

הצגת המתאמים הזמינים

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

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

Android

iOS

הערה: הטמעות קודמות של אירועים בהתאמה אישית, לפני גרסת ה-API v20.0.0 (Android) ו-v9.0.0 (iOS), שממשקי API שהוצאו משימוש למחלקות משנה לא תומכים באתחול, והם מופיעים כבעיה שנמצאה בכלי לבדיקת מודעות. אם האזהרה הזו מופיעה בכלי לבדיקת מודעות, למרות ששילוב האירועים בהתאמה אישית נראה תקין, צריך לבדוק אם האפליקציה משתמשת בממשקים שהוצאו משימוש, כמו CustomEventBanner (Android)‏ | GADCustomEventBanner (iOS), ולהחליף אותם בכיתה החדשה Adapter (Android)‏ | GADMediationAdapter (iOS).

בדיקה של יחידות המודעות

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

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

בדיקת מודעות

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

כשתהיו מוכנים לבדוק את יחידת המודעות, תוכלו להקיש על הלחצן בקשה להצגת מודעה לבדיקה בחלק העליון של המסך של הכלי לבדיקת מודעות כדי להפעיל את בדיקת המודעות של הכלי לבדיקת מודעות. לאחר מכן, תוצאות הבדיקה יופיעו ביומן הבקשות מה-SDK מתחת לכותרת Requested from ad inspector.

איך בודקים את הצגת המודעות באפליקציה באמצעות הכלי לבדיקת המודעות

בדיקה של מקור מודעות יחיד

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

כדי להפעיל את התכונה הזו, מעבירים את המתג Single ad source test (בדיקה של מקור מודעות יחיד) למצב מופעל בחלק התחתון של המסך. תוצג תיבת הדו-שיח הבאה לבחירת מקור המודעות:

Android

iOS

כדי לבדוק מקור מודעות יחיד, קודם צריך להפעיל את Google Mobile Ads SDK.

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

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

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

במצב בדיקה של מקור מודעות יחיד, המערכת תנסה למלא את כל הבקשות להצגת מודעות ממקור המודעות שנבחר, גם אם הוא הוגדר לבידינג וגם אם הוא הוגדר לתהליך בחירת הרשת עבור יחידת המודעות המבוקשת. אם מקור המודעות שאתם בודקים לא נמצא ברשימת הרשתות בתהליך בחירת הרשת של יחידת מודעות, תוצג לכם הודעת השגיאה 'אין הצגה (no fill)'.

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

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

איך מפסיקים בדיקה של מקור מודעות יחיד

כדי להפסיק את הבדיקה, מעבירים את המתג למצב כבוי:

לאחר מכן תופיע הודעת אישור מעל מסך ההפעלה מחדש הבא:

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

העתקת כל תוצאות ניפוי הבאגים

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

כדי לעשות זאת, מקישים על סמל האפליקציה שבע פעמים עד שמופיעה ההודעה העתקת ה-JSON של בודק המודעות ללוח.