אפשר להשתמש בכלי לבדיקת מודעות כדי:
- בדיקת יחידות המודעות
- לבדוק אם הבקשות למודעות מתמלאות כצפוי
- לזהות שגיאות ולהציג הצעות לפתרון בעיות
- להציג את הפרטים של כל רשת מודעות לבידינג לכל בקשה
- להציג את פרטי תהליך בחירת הרשת (Mediation) של כל רשת מודעות לכל בקשה
- בדיקה של מקורות מודעות ספציפיים של צד שלישי לבידינג או בתהליך בחירת הרשת (Mediation) ב-Waterfall
- ודאו שהגדרתם בצורה נכונה כל יחידת מודעות לבידינג ולתהליך בחירת הרשת (Mediation) ב-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 של בקר התצוגה, ההצגה של הכלי לבדיקת מודעות תיכשל.
הצגה ופתרון בעיות של יחידות מודעות
לאחר ההפעלה, יופיע המסך הראשי של הכלי לבדיקת מודעות, שכולל רשימה של כל היחידות של המודעות שהמכשיר שלח עליהן בקשות להצגת מודעות מאז שהכלי הופעל במהלך סשן האפליקציה הזה. הרשימה כוללת גם יחידות של מודעות שבהן מופעל בידינג, שממוינות באופן כרונולוגי, כאשר הבקשות שהושלמו לאחרונה מופיעות קודם, וגם יחידות של מודעות שלא הוגשו עבורן בקשות להצגת מודעות (מוטשטשות):
מומלץ להפעיל את Google Mobile Ads SDK לפני שמשתמשים בכלי לבדיקת המודעות.
הצגת פרטי רשימת הרשתות בתהליך בחירת הרשת עבור יחידת מודעות
כדי להציג את רישומי היומן של הבקשות שנשלחו ל-SDK מיחידת מודעות מקישים על אותה יחידת מודעות. ברישומים יופיע פירוט של נתוני תהליך בחירת הרשת (Mediation) ב-Waterfall של הבקשות האחרונות למודעות, עד לשלב שבו הבקשה למודעה מולאה (או עד שה-Waterfall הסתיים בלי למלא את הבקשה).
אפשר להרחיב כל בקשה באמצעות סמל הגילוי הנאות כדי להציג את התוצאות של ה-Waterfall בתהליך בחירת הרשת (Mediation) של הבקשה הזו, יחד עם כל שגיאה וזמן אחזור רלוונטיים לבקשה הזו.
במקורות מודעות של צד שלישי, הודעות השגיאה נשלחות ישירות ממקור המודעות. כדי לקבל מידע נוסף, אפשר לפנות למקור המודעות של הצד השלישי.
הצגת פרטי הבידינג של יחידת מודעות
אם זו הפעם הראשונה שאתם משתמשים בבידינג, כדאי לקרוא את המבוא ל-Open Bidding.
ביומן הבקשות מה-SDK אפשר לראות את מקורות המודעות לבידינג שמופעלים בבקשה להצגת מודעה. אפשר להקיש על יחידת מודעות ביומן הבקשות מה-SDK כדי להציג את הפרטים של כל מקור מודעות במכרז לבידינג.
תוצאות הבידינג ממוינות כך שהפריטים שאפשר לבצע בהם פעולה מוצגים קרוב יותר לחלק העליון של הרשימה:
בחלק העליון מוצגת רשת המודעות שזכתה במכרז.
לאחר מכן מופיעות רשתות המודעות שזוהו בהן בעיות. אפשר לפעול לפי השלבים לפתרון הבעיות שמופיעים בסוף השאלות הנפוצות בנושא בידינג.
לאחר מכן, יש רשתות מודעות שלא הוחזרו להן מודעות או שלא הגישו הצעות מחיר. ייתכן שהסיבה לכך היא בעיות שונות במקור המודעות, כי יכול להיות שהוא לא הגיש הצעות מחיר בגלל ההגדרה או תהליך קבלת ההחלטות שלו. לקבלת תמיכה נוספת, אפשר לעיין במדריך ההגדרה של מקור המודעות או בשאלות הנפוצות בנושא Open Bidding.
לבסוף, בתחתית הרשימה מופיעות רשתות המודעות שהפסידו במכרז הבידינג.
רשימת הרשתות בתהליך בחירת הרשת יכולה להציב את מקור המודעות שזכה במכרז הבידינג, בהתאם לערך העלות בפועל לאלף חשיפות (eCPM) שלו.
רשימת הרשתות ב-Mediation היא תוצאה של מספר קבוצות של תשואה שמתחרות על אותו מלאי שטחי פרסום. אפשר להוסיף עד עשרה שותפי הכנסות של צד שלישי לקבוצת הכנסות אחת, כולל שותפי הכנסות לבידינג ושותפי הכנסות לבחירת רשת לאפליקציות לנייד.
ניפוי באגים מתקדם של יחידות מודעות
כשאתם מנסים לפתור בעיות ביחידות המודעות, כדאי לבדוק לעומק את הבקשה להצגת המודעה ואת התגובה כדי לזהות איפה הבעיה, או לשתף את הנתונים האלה עם התמיכה של Google כדי לקבל עזרה בניפוי הבאגים. כדי לייצא את הבקשה המלאה של הבקשה להצגת מודעה ואת התגובה לבקשה להצגת מודעה, מקישים על סמל התפריט בחלק העליון של שרשרת ה-Waterfall ובוחרים באפשרות Share ad request and ad כך לא תצטרכו להריץ מעקבי רשת באפליקציה שלכם.
בנוסף, אפשר לראות פרמטרים מפוענחים של בידינג של צד שלישי על ידי הקשה על האפשרות 3 Party bidding parameter (פרמטר של בידינג של צד שלישי) באותו תפריט שבו מופיעה מחרוזת הבקשה. כאן מופיעים פרטים על הפרמטרים של בידינג של צד שלישי שעלולים לגרום לבעיות, ועוזרים לנפות באגים באפליקציה או לוודא שרשת מסוימת אוספת את האותות שלה בצורה נכונה.
הצגת המתאמים הזמינים
לוחצים על הכרטיסייה מתאמים כדי לראות רשימה של כל המתאמים של הצד השלישי שמשויכים למקורות המודעות בהגדרות הבידינג או בתהליך בחירת הרשת באפליקציה. לאחר מכן, מרחיבים את הכרטיסים כדי לראות את סטטוסי האיפוס ואת גרסאות ה-SDK שלהם. לצד מתאמים נתמכים של צדדים שלישיים תוכלו גם להציג מתאמים לאירועים בהתאמה אישית. אירועים מותאמים אישית מאפשרים לבעלי תוכן דיגיטלי להשתמש ברשתות מודעות שלא נתמכות ב-Ad Manager. אפשר להבדיל בין אירועים מותאמים אישית לבין מתאמים רגילים של צד שלישי ברשימה של המתאמים לפי שמות המחלקות הייחודיים שלהם. בנוסף למתן השם והסטטוס של המחלקה, הכלי לבדיקת מודעות מציג גם את התוויות שהוקצו לאירועים המותאמים אישית האלה בממשק האינטרנט של Ad Manager.
אם לא מוצאים את המתאם או שהוא לא מופעל, תוכלו לקרוא מידע נוסף במאמר בדיקת הצגת המודעות באפליקציות לנייד.
בדיקה של יחידות המודעות
אם אתם רוצים לבדוק את יחידת המודעות בלי לנווט אליה בממשק המשתמש של האפליקציה, הכלי לבדיקת מודעות תומך בכך ישירות ממסך הפרטים של יחידת המודעות. בנוסף, תוכלו לבדוק כמה יחידות מודעות בו-זמנית, לטעון את הבקשות להצגת מודעות לבדיקה ולהציג אותן באופן אסינכררוני, ואפילו לבצע בדיקות של מקור מודעות יחיד.
בדיקת מודעות
הבדיקות של הכלי לבדיקת מודעות שמתוארות בקטע הזה הן כלי מצוין לאימות חוויית המשתמש של המודעה הבסיסית ולאימות ההגדרות של תהליך בחירת הרשת (Mediation) כשבודקים את מקור המודעות יחיד.
כשרוצים לבדוק את יחידת המודעות, מקישים על הלחצן Request test ad (בקשת מודעה לבדיקה) בחלק העליון של המסך של הכלי לבדיקת מודעות כדי להפעיל את בדיקת המודעות של הכלי לבדיקת מודעות. תוצאות הבדיקה יופיעו ביומן הבקשות ל-SDK מתחת לכותרת בקשה מכלי לבדיקת מודעות.
בדיקה של מקור מודעות יחיד
בכלי לבדיקת המודעות יש תכונה שמאפשרת להגביל את הבקשות להצגת מודעות באפליקציה כך שיוצגו רק מודעות ממקור מודעות יחיד לבידינג או ממקור מודעות יחיד ב-Waterfall לבחירת רשת. כך תוכלו לוודא שהטמעתם בצורה נכונה את המתאם של הצד השלישי ושמקור המודעות מוצג כמצופה.
כדי להפעיל את התכונה הזו, מעבירים את המתג Single ad source test (בדיקה של מקור מודעות יחיד) למצב מופעל בחלק התחתון של המסך. תוצג תיבת הדו-שיח הבאה לבחירת מקור המודעות:
כדי לבדוק מקור מודעות יחיד, קודם צריך להפעיל את Google Mobile Ads SDK.
לאחר מכן תוכלו לבחור מקור מודעות יחיד לבדיקה. אחרי שבוחרים מקור מודעות, מופיע המסך הבא:
ההגדרה של בדיקה של מקור מודעות יחיד חלה על כל הבקשות הבאות להצגת מודעות שתשלחו באותו סשן. עם זאת, הוא לא חל על מודעות שנשמרו במטמון בעבר בסשן הזה, שעדיין לא הוצגו. אילוץ הפעלה מחדש של האפליקציה מומלץ לבצע כשמחילים בדיקה של מקור מודעות יחיד, כדי לבטל את התוקף של מודעות שנשמרו במטמון שהיו יכולות להופיע במקום שמקור המודעות שבחרתם יקבל בקשה.
אחרי הפעלה מחדש של האפליקציה, כל מיקומי יחידות המודעות ינסו להציג מודעה מהרשת שנבחרה בלבד. כשמפעילים את הכלי לבדיקת מודעות כשבדיקה של מקור מודעות יחיד פעילה, מוצג מקור המודעות הפעיל לבדיקה:
במצב בדיקה של מקור מודעות יחיד, כל הבקשות להצגת מודעות מנסות למלא את הבקשות במקור המודעות שנבחר, גם אם מקור המודעות הזה הוגדר לבידינג או לתהליך בחירת הרשת (Mediation) עבור יחידת המודעות המבוקשת. אם מקור המודעות שאתם בודקים לא נמצא ברשימת הרשתות בתהליך בחירת הרשת של יחידת מודעות, תוצג לכם הודעת השגיאה 'אין הצגה (no fill)'.
כשבודקים מקור מודעות יחיד אפשר להקיש על יחידת מודעות כדי להציג את יומן הבקשות שלה מה-SDK. כך אפשר לדעת אם מקור המודעות מילא את הבקשות להצגת מודעות שנשלחו אחרי שהופעלה בדיקה של מקור מודעות יחיד. אם מקור המודעות לא הצליח לטעון מודעה, תוצג הודעת שגיאה עם תיאור השגיאה.
אם הוספתם כמה מופעים של מקור המודעות שנבחר לרשימת רשתות בתהליך בחירת הרשת, יוצג לכם כל מופע של הקריאה שנשלחה למקור המודעות ב-Waterfall עד למילוי הבקשה להצגת מודעה או עד לסיום ה-Waterfall בלי למלא את הבקשה.
איך מפסיקים בדיקה של מקור מודעות יחיד
כדי להפסיק את הבדיקה, מעבירים את המתג למצב כבוי:
לאחר מכן תופיע הודעת אישור במסך ההפעלה מחדש הבא:
מומלץ לכפות הפעלה מחדש של האפליקציה אחרי הפסקת הבדיקה, כדי לבטל את התוקף של מודעות שנשמרו במטמון של מקור המודעות שנבדק.
העתקת כל הפלט של ניפוי הבאגים
בודק המודעות תומך בהעתקה של מחרוזת JSON שמכילה את כל הפלט של ניפוי הבאגים מהכלי, כולל פרטים על אפליקציית Ad Manager, סטטוסים של אתחול המתאם ותוצאות הבדיקה של כל יחידות המודעות.
כדי לעשות זאת, מקישים על סמל האפליקציה שבע פעמים עד שמופיעה ההודעה העתקת ה-JSON של בודק המודעות ללוח.