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

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

למודעות לנייד Flutter 1.3.0 ואילך, אפשר:

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

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

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

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

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

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

  • שימוש בגרסת הפלאגין Flutter מודעות לנייד 1.3.0 ומעלה.

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

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

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

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

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

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

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

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

MobileAds.instance.openAdInspector(
  (AdInspectorError? error) {
    // Error will be non-null if ad inspector closed due to an error.
  });

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

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

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

אנחנו ממליצים להפעיל את מודעות Google לנייד SDK לפני שמשתמשים בכלי לבדיקת מודעות.

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

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

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

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

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

אם אין לכם ניסיון בבידינג, כדאי לקרוא את המאמר סקירה כללית.

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

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

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

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

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

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

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

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

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

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

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

Android
iOS

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

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

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

Android
iOS

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

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

בדיקת מודעות

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

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

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

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

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

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

Android
iOS

עליכם להפעיל את מודעות Google לנייד SDK לפני שתוכלו להשתמש בבדיקה של מקור מודעות יחיד.

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

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

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

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

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

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

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

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

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

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

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

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

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