אפשר להשתמש בכלי לבדיקת מודעות כדי:
- בדיקה של יחידות המודעות
- לבדוק אם הבקשות למודעות מתמלאות כצפוי
- לזהות שגיאות ולהציג פרטים על הדרכים לפתור אותן
- הצגת הפרטים של כל רשת מודעות ב-Open Bidding לפי בקשה
- הצגת פרטים של תהליך בחירת הרשת (Mediation) של כל רשת מודעות בכל בקשה
- לבדוק מקורות מודעות ספציפיים של צד שלישי בתהליך בחירת הרשת ב-Open Bidding או ב-Waterfall
- לוודא שהגדרתם נכון כל יחידת מודעות ל-Open Bidding ולתהליך בחירת הרשת ב-Waterfall
במדריך הזה נדגים איך להפעיל את התכונות השונות בכלי לבדיקת מודעות ולהשתמש בהן.
דרישות מוקדמות
כדי להשתמש בכלי לבדיקת מודעות:
- בצעו את ההוראות במדריך לתחילת העבודה.
- יש להשתמש ב-Google Mobile Ads SDK 8.10.0 ואילך.
- הפעלת מצב בדיקה או קישור המכשיר אל Ad Manager. הכלי לבדיקת מודעות מופעל רק במכשירים לבדיקה או במכשירים מקושרים.
הפעלה של הכלי לבדיקת מודעות
אפשר להפעיל את הכלי לבדיקת מודעות מכל מקום באפליקציה בדרכים הבאות:
- משתמשים בלחצן ההפעלה מתפריט ניפוי הבאגים.
- משתמשים בתנועה שבחרתם בהגדרות של הכלי לבדיקת מודעות.
- באופן פרוגרמטי באמצעות ה-API שסופק.
הפעלה באמצעות תפריט ניפוי הבאגים
אין צורך לבצע שינויים באפליקציה כדי להפעיל את הכלי לבדיקת מודעות דרך תפריט ניפוי הבאגים. פשוט מוצאים את המודעה שהוצגה ברשת Ad Manager ולוחצים לחיצה ארוכה על המודעה עם שתי אצבעות כדי לפתוח את תפריט ניפוי הבאגים. לאחר מכן בוחרים באפשרות פתיחת הכלי לבדיקת מודעות.
אם לא קישרתם את המכשיר, ייתכן שתתבקשו להיכנס לחשבון Ad Manager.
אפשר גם לבחור באפשרות ההגדרות של הכלי לבדיקת מודעות בהגדרות של ניפוי הבאגים, ולבחור תנועה שתאפשר למערכת לפתוח את הכלי לבדיקת מודעות בעתיד, בלי לעבור לתפריט ניפוי הבאגים.
הפעלה באופן פרוגרמטי
אפשר להפעיל את הכלי לבדיקת מודעות גם באופן פרוגרמטי:
Swift
GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
// Error will be non-nil if there was an issue and the inspector was not displayed.
}
Objective-C
[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
completionHandler:^(NSError *error) {
// Error will be non-nil if there was an issue and the inspector was not displayed.
}];
ה-API הזה פועל במכשירי בדיקה שרשומים באופן פרוגרמטי.
מוודאים שהבקר של תצוגה מפורטת שהועבר ל-API הזה כבר גלוי במלואו במסך (בוצעה קריאה ל-viewDidAppear:). אם בקר התצוגה המפורטת שהועבר נמצא בתהליך התצוגה, למשל כשה-API מופעל בפונקציה viewDidLoad של בקר התצוגה, ההצגה של הכלי לבדיקת מודעות תיכשל.
הצגה של יחידות מודעות ופתרון בעיות
אחרי שמפעילים את האפליקציה, מופיע המסך הראשי של בודק המודעות ובו רשימה של כל יחידות המודעות מאז שבודק המודעות הופעל במהלך סשן האפליקציה הזה, נשלחו בקשות להצגת מודעות מהמכשיר. הרשימה כוללת גם יחידות מודעות שהתכונה Open Bidding מופעלת בהן, שמסודרות באופן כרונולוגי עם מספר הבקשות הגבוהות ביותר שהושלמו, ויחידות שלא בקשות להצגת מודעות שהושלמו:
מומלץ להפעיל את Google Mobile Ads SDK לפני שמשתמשים בכלי לבדיקת המודעות.
הצגת פרטי תהליך בחירת הרשת (Mediation) ב-Waterfall של יחידת מודעות
מקישים על יחידת מודעות כדי להציג את יומן הבקשות שלה מה-SDK. יומן הבקשות להצגת מודעות מכיל פרטים על רשימת הרשתות בתהליך בחירת הרשת עד לנקודה שבה הצגת המודעה מולאה (או שה-Waterfall הסתיים בלי למלא) את הבקשות האחרונות להצגת מודעות.
אפשר להרחיב כל בקשה באמצעות אינדיקטור הגילוי הנאות כדי להציג את התוצאות של רשימת הרשתות בתהליך בחירת הרשת, לצד שגיאות וזמן אחזור שהיו רלוונטיים לבקשה.
במקורות מודעות של צד שלישי, הודעות השגיאה נשלחות ישירות ממקור המודעות. כדי לקבל מידע נוסף, יש לפנות אל מקור המודעות של הצד השלישי.
הצגת פרטי הבידינג של יחידת מודעות
אם זו הפעם הראשונה שאתם משתמשים ב-Open Bidding, כדאי לקרוא את המבוא ל-Open Bidding.
ביומן הבקשות מה-SDK, אפשר לראות את Open Bidding מקורות המודעות שמופעלים בבקשה להצגת מודעה. אפשר להקיש על יחידת מודעות ביומן הבקשות מה-SDK כדי לראות את הפרטים של כל מקור מודעות Open Bidding במכרז.
Open Bidding התוצאות ממוינות כך שהפריטים הרלוונטיים לפעולה יופיעו קרוב יותר לראש הרשימה:
בחלק העליון מוצגת רשת המודעות שזכתה במכרז.
עכשיו מופיעות רשתות המודעות שזוהו בהן בעיות. לאחר מכן תוכלו להיעזר השלבים לפתרון בעיות מפורטים בסוף Open Bidding השאלות הנפוצות.
לאחר מכן יש רשתות המודעות שלא החזירו מודעות עבורן או לא הגישו הצעת מחיר. זה יכול להצביע על בעיות רבות ושונות במקור המודעות, כי יכול להיות שלא הוגדרה עבורו הצעת מחיר בגלל ההגדרה או ההחלטה שהתקבלה. אפשר לעיין במדריך ההגדרה של מקור המודעות או שאלות נפוצות לגבי Open Bidding לקבלת תמיכה נוספת.
לבסוף, בחלק התחתון של הרשימה מוצגות רשתות המודעות שהפסידוOpen Bidding במכרז.
רשימת הרשתות בתהליך בחירת הרשת יכולה למקם את מקור המודעות שזכה Open Bidding במכרז, בהתאם לערך העלות בפועל לאלף חשיפות שהוגדר לו.
רשימת רשתות בתהליך בחירת הרשת נוצרת כאשר כמה קבוצות תפוקה מתחרות על אותו מלאי. אפשר להוסיף עד עשרה שותפי תפוקה של צד שלישי לקבוצת תפוקה אחת, כולל שותפי תפוקה של Open Bidding ותהליך בחירת הרשת (Mediation) לשותפי תפוקה של אפליקציות לנייד.
ניפוי באגים מתקדם של יחידות מודעות
במהלך פתרון בעיות ביחידות של מודעות, כדאי להתעמק בבקשה להצגת מודעה ובתגובה כדי לזהות היכן משהו נכשל, או לשתף אותה עם התמיכה של Google כדי לקבל עזרה בניפוי באגים. כדי לייצא את הבקשה המלאה ואת התגובה המלאה, מקישים על סמל התפריט בחלק העליון של שרשרת ה-Waterfall ובוחרים באפשרות Share ad request and response (שיתוף בקשה למודעה ותגובה). כך לא תצטרכו להריץ מעקבי רשת באפליקציה שלכם.
בנוסף, אפשר להציג פרמטרים מפוענחים של בידינג של צד שלישי. כדי לעשות את זה, מקישים על האפשרות Third-party bidding parameter (פרמטר לבידינג של צד שלישי) באותו תפריט של מחרוזת הבקשה. כך תוכלו לראות באילו פרמטרים של בידינג של צד שלישי יש בעיות אפשריות, לנפות באגים באפליקציה או לוודא שהרשת אוספת את האותות שלה בהצלחה.
הצגת המתאמים הזמינים
לוחצים על הכרטיסייה מתאמים כדי להציג רשימה של כל המתאמים של צד שלישי המשויכים למקורות המודעות בהגדרות הבידינג או תהליך בחירת הרשת באפליקציה. לאחר מכן, מרחיבים את הכרטיסים כדי להציג את סטטוס האתחול ואת גרסאות ה-SDK שלהם. לצד המתאמים הנתמכים של צד שלישי אפשר להציג גם מתאמים בהתאמה אישית של אירועים. אירועים מותאמים אישית מאפשרים לבעלי אתרים להשתמש ברשתות מודעות Ad Managerשלא תומכות. ניתן להבחין בין אירועים בהתאמה אישית לבין מתאמים רגילים של צד שלישי ברשימת המתאמים באמצעות שמות המחלקות הייחודיים שלהם. בנוסף לשליחת פרטי השם והסטטוס של המחלקה, בכלי לבדיקת המודעות מוצגות גם התוויות שהוקצו לאירועים מותאמים אישית בממשקAd Manager האינטרנט.
אם המתאם לא נמצא או שלא הופעל, מומלץ לעיין במאמר בדיקה של הצגת המודעות באפליקציות לנייד לקבלת מידע נוסף.
בדיקה של יחידות המודעות
כדי לבדוק את יחידת המודעות בלי לנווט אליה בממשק המשתמש של האפליקציה, אפשר להשתמש בכלי לבדיקת מודעות ישירות ממסך הפרטים של יחידת המודעות. בנוסף, אפשר לבדוק כמה יחידות של מודעות בו-זמנית, לטעון באופן אסינכרוני ולהציג את הבקשות להצגת מודעות לבדיקה, ואפילו לבצע בדיקות של מקור מודעות יחיד.
בדיקת מודעות
הבדיקות של המודעות בכלי לבדיקת מודעות שמתוארות בקטע הזה הן כלי מצוין לאימות חוויית המשתמש הבסיסית במודעות ולאימות ההגדרות של תהליך בחירת הרשת (Mediation) כשמשתמשים בבדיקה של מקור מודעות יחיד.
כשתהיו מוכנים לבדוק את יחידת המודעות, הקישו על הלחצן בקשת מודעה לבדיקה בחלק העליון של המסך בכלי לבדיקת מודעות כדי להפעיל את בדיקת המודעות בכלי לבדיקת מודעות. לאחר מכן, תוצאות הבדיקה יופיעו ביומן הבקשות מה-SDK מתחת לכותרת Request from ad מדדים.
בדיקה של מקור מודעות יחיד
בכלי לבדיקת המודעות יש תכונה שבעזרתה אפשר להגביל את הבקשות להצגת מודעות באפליקציה, כך שיוצגו מודעות רק ממקור מודעות אחד Open Bidding או מ-Waterfall של תהליך בחירת הרשת. כך תוכלו לוודא שהטמעתם בצורה נכונה את המתאם של הצד השלישי ושמקור המודעות פועל כמצופה.
כדי להפעיל את התכונה הזו, מחליפים את המצב במתג Single ad source (בדיקה של מקור מודעות יחיד) שנמצא בתחתית המסך. תוצג תיבת הדו-שיח הבאה לבחירת מקור מודעות:
עליכם להפעיל את ה-SDK של מודעות Google לנייד לפני שתוכלו לבדוק מקור מודעות יחיד.
לאחר מכן אפשר לבחור מקור מודעות אחד לבדיקה. אחרי שבוחרים מקור מודעות, מופיע המסך הבא:
הגדרת הבדיקה של מקור מודעות יחיד חלה על בקשות עתידיות להצגת מודעות שתבצעו באותו סשן. עם זאת, הוא אינו חל על מודעות שנשמרו בעבר במטמון במהלך הפעלה זו שעדיין לא הוצגו. מומלץ לאלץ הפעלה מחדש של האפליקציה כשמחילים בדיקה של מקור מודעות יחיד, כדי לבטל את התוקף של מודעות שנשמרו במטמון, שייתכן שיוצגו במקום שמקור המודעות שבחרתם יקבל בקשה.
לאחר הפעלת האפליקציה מחדש, בכל המיקומים של יחידות המודעות יתבצע ניסיון להציג מודעה מהרשת שנבחרה בלבד. כשמפעילים את הכלי לבדיקת מודעות כשבדיקה של מקור מודעות יחיד פעילה, מקור המודעות שמשמש לבדיקה פעילה:
במצב בדיקה של מקור מודעות יחיד, מתבצע ניסיון למילוי של כל הבקשות להצגת מודעות במקור המודעות שנבחר, גם אם מקור המודעות הוגדר לבידינג או לתהליך בחירת הרשת (Mediation) ביחידת המודעות המבוקשת. אם מקור המודעות שאתם בודקים לא נמצא ברשימת הרשתות בתהליך בחירת הרשת של יחידת מודעות, תופיע הודעת השגיאה "ללא מילוי".
כשבודקים מקור מודעות יחיד אפשר להקיש על יחידת מודעות כדי להציג את יומן הבקשות שלה מה-SDK. כך תוכלו לראות אם מקור המודעות מילא את הבקשות למודעות שנשלחו אחרי שהפעלתם בדיקה של מקור מודעות יחיד. אם מקור המודעות לא הצליח לטעון מודעה, תופיע הודעת שגיאה שמתארת את השגיאה.
אם הוספתם כמה מופעים של מקור המודעות שנבחר ל-Waterfall של תהליך בחירת הרשת, כל המופעים של הקריאה למקור המודעות יופיעו ב-Waterfall עד למילוי הבקשה להצגת המודעה או עד שה-Waterfall יסתיים בלי למלא אותה.
הפסקת בדיקה של מקור מודעות יחיד
כדי להפסיק את הבדיקה, מעבירים את המתג למצב מושבת:
לאחר מכן תופיע הודעת אישור במסך ההפעלה מחדש הבא:
מומלץ לאלץ את ההפעלה מחדש של האפליקציה אחרי הפסקת הבדיקה, כדי לבטל את התוקף של המודעות שנשמרו במטמון עבור מקור המודעות שנבדק.
העתקת כל פלטי ניפוי הבאגים
הכלי לבדיקת מודעות תומך בהעתקה של מחרוזת JSON שמכילה את כל הפלטים של ניפוי הבאגים מהכלי, כולל פרטים עלAd Manager האפליקציה, הסטטוסים של הפעלת המתאמים ותוצאות הבדיקה של כל יחידות המודעות.
כדי לעשות את זה, מקישים שבע פעמים על סמל האפליקציה עד שמופיעה ההודעה עותק JSON לכלי לבדיקת מודעות שהועתקו ללוח.