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

באמצעות הכלי לבדיקת מודעות בגרסאות SDK של מודעות לנייד שקודמות ל-20.2.0, אפשר:

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

ב-Mobile Ads SDK מגרסה 20.2.0 ואילך אפשר גם:

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

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

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

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

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

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

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

• משתמשים ב-Google Mobile Ads SDK בגרסה 20.0.0 ואילך.

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

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

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

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

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

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

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

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

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

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

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

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

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

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

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

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

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

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

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

דרישות מוקדמות: Google Mobile Ads SDK מגרסה 20.2.0 ואילך

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

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

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

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

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

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

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

  

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

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

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

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

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

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

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

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

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

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

בדיקת מודעות

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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