במדריך הזה נסביר איך להפעיל את התכונות השונות בכלי לבדיקת מודעות ואיך להשתמש בהן.
דרישות מוקדמות
כדי להשתמש בכלי לבדיקת מודעות, צריך:
- צריך לקרוא את המדריך לתחילת העבודה.
- צריך להשתמש בגרסה 9.1.0 ואילך של Google Mobile Ads SDK.
- הוספת המכשיר כמכשיר בדיקה הכלי לבדיקת מודעות מופעל רק במכשירי בדיקה.
הפעלת הכלי לבדיקת מודעות
אפשר להפעיל את הכלי לבדיקת המודעות מכל מקום באפליקציה בדרכים הבאות:
- משתמשים בתנועת המגע שנבחרה בממשק המשתמש של AdMob כשרושמים מכשיר בדיקה.
- באופן פרוגרמטי באמצעות ה-API שסופק.
- משתמשים בכפתור ההפעלה בתפריט ניפוי הבאגים.
הפעלה באמצעות תנועות
כדי להפעיל את הכלי לבדיקת מודעות באמצעות תנועה, לא צריך לבצע שינויים באפליקציה. פשוט מבצעים את התנועה (ניעור או ניעור כפול) שהגדרתם ב-AdMob למכשיר הבדיקה. מידע נוסף
אחרי שמגדירים תנועה בממשק המשתמש של AdMob (ומחכים 15 דקות עד שהיא תתעדכן), האפליקציה צריכה לשלוח בקשה להצגת מודעה כדי ש-Google Mobile Ads SDK יקבל מידע על הגדרת התנועה. אם המחוות שציינתם לא פועלות, נסו לטעון מודעה, להפעיל מחדש את האפליקציה ולבדוק שוב את המחוות.
הפעלה פרוגרמטית
אפשר גם להפעיל את הכלי לבדיקת המודעות באופן פרוגרמטי:
ה-API הזה פועל במכשירי בדיקה שנרשמו באופן פרוגרמטי או בממשק המשתמש של AdMob.
צפייה ביחידות של מודעות ופתרון בעיות שקשורות אליהן
אחרי ההפעלה, מופיע המסך הראשי של הכלי לבדיקת מודעות, שכולל רשימה של כל יחידות המודעות בממשק המשתמש של AdMob שמשויכות למזהה האפליקציה שלכם ב-AdMob עם הגדרות של בידינג או מנגנון בחירת רשת:
מומלץ להפעיל את Google Mobile Ads SDK לפני שמשתמשים בכלי לבדיקת מודעות.
איך רואים את פרטי רשימת הרשתות בתהליך בחירת רשת של יחידת מודעות
אפשר להקיש על יחידת מודעות כדי לראות את יומן הבקשות שלה מה-SDK. ביומן מופיעים פרטים על ה-Waterfall של תהליך בחירת הרשת עד לנקודה שבה הבקשה להצגת מודעה מולאה (או עד שה-Waterfall הסתיים בלי למלא אותה) עבור הבקשות האחרונות להצגת מודעות.
אפשר להרחיב כל בקשה באמצעות חץ החשיפה כדי להציג את התוצאות של רשימת הרשתות בתהליך בחירת הרשת של הבקשה, יחד עם כל שגיאה וזמן טעינה שרלוונטיים לבקשה.
במקורות מודעות של צד שלישי, הודעות השגיאה נשלחות ישירות ממקור המודעות. כדי לקבל מידע נוסף, פנו למקור המודעות של הצד השלישי.
איך רואים פרטי בידינג של יחידת מודעות
אם אין לכם ניסיון בבידינג, כדאי לקרוא את הסקירה הכללית.
ביומן הבקשות מה-SDK, אפשר לראות את מקורות המודעות לבידינג שהופעלו בבקשה להצגת מודעה. מקישים על יחידת מודעות ביומן הבקשות מה-SDK כדי לראות את הפרטים של כל מקור מודעות במכרז הבידינג.
תוצאות הבידינג ממוינות בסדר כזה שהפריטים שניתנים למימוש מופיעים קרוב יותר לראש הרשימה:
בחלק העליון מוצגת רשת המודעות שזכתה במכרז.
בהמשך מפורטות רשתות המודעות שזוהו בהן בעיות. אפשר לפעול בהתאם לשלבים לפתרון בעיות.
אחר כך מופיעות רשתות המודעות שלא החזירו מודעות או לא הגישו הצעות מחיר. יכול להיות שהסיבה לכך שמקור המודעות לא הגיש הצעת מחיר קשורה להגדרה שלו או לאופן קבלת ההחלטות שלו. אפשר לעיין במדריך ההגדרה של מקור המודעות או לפנות ישירות למקור המודעות לקבלת תמיכה.
לבסוף, בתחתית הרשימה מופיעות רשתות המודעות שהפסידו במכרז הבידינג.
רשימת רשתות בתהליך בחירת רשת (Mediation) ב-Waterfall יכולה למקם את מקור המודעות שזכה במכרז הבידינג בהתאם לערך העלות בפועל לאלף חשיפות שהוגדר עבורו.
כשמקור מודעות מופעל ב-Waterfall של תהליך בחירת הרשת (Mediation), הוא יכול להציג מודעות. כדי לקבל מידע נוסף על אופן הפעולה של הבידינג עם רשימת רשתות בתהליך בחירת רשת, אפשר לעיין בדוגמה 2 ובדוגמה 3 של מקורות מודעות לבידינג ומקורות מודעות ב-Waterfall בקבוצה לבחירת רשת.
ניפוי באגים מתקדם ביחידות מודעות
כשמנסים לפתור בעיות ביחידות מודעות, כדאי לבדוק את הבקשה להצגת מודעה ואת התשובה כדי לזהות איפה יש כשל, או לשתף אותן עם צוות התמיכה של Google כדי לקבל עזרה בניפוי הבאגים. מקישים על סמל התפריט בחלק העליון של שרשרת ה-waterfall ובוחרים באפשרות שיתוף הבקשה להצגת מודעה והתשובה כדי לייצא את הבקשה המלאה להצגת מודעה ואת התשובה. כך לא תצטרכו להריץ מעקב אחר הרשת באפליקציה שלכם.
בנוסף, אפשר להקיש על האפשרות פרמטר לבידינג של צד שלישי באותו תפריט שבו מופיע מחרוזת הבקשה כדי לראות את הפרמטרים לבידינג של צד שלישי אחרי פענוח. כך תוכלו לראות פרטים על פרמטרים לבידינג של צד שלישי שאולי יש בהם בעיות, ולבצע ניפוי באגים באפליקציה או לוודא שרשת מסוימת אוספת את האותות שלה בהצלחה.
הצגת המתאמים הזמינים
לוחצים על הכרטיסייה Adapters (מתאמים) כדי לראות רשימה של כל המתאמים של צד שלישי שמשויכים למקורות המודעות בהגדרות הבידינג או תהליך הבחירה של רשת מודעות באפליקציה. לאחר מכן, מרחיבים את הכרטיסים כדי לראות את סטטוסי האתחול ואת גרסאות ה-SDK שלהם. בנוסף למתאמים נתמכים של צד שלישי, אפשר גם לראות מתאמי אירועים בהתאמה אישית.
אירועים בהתאמה אישית מאפשרים לבעלי אפליקציות להשתמש ברשתות מודעות שלא נתמכות ב-AdMob. אירועים מותאמים אישית נבדלים ממתאמים רגילים של צד שלישי ברשימת המתאמים לפי שמות המחלקות הייחודיים שלהם. בנוסף לשם המחלקה ולמידע על הסטטוס, הכלי לבדיקת מודעות מציג גם את התוויות שהוקצו לאירועים המותאמים אישית האלה בממשק האינטרנט של AdMob.
אם המתאם לא נמצא או אם ההפעלה שלו נכשלה, אפשר לקרוא מידע נוסף במאמר פתרון בעיות שזיהיתם באמצעות הכלי לבדיקת מודעות.
בדיקה של יחידות המודעות
אם אתם רוצים לבדוק את יחידת המודעות בלי לנווט אליה בממשק המשתמש של האפליקציה, הכלי לבדיקת מודעות תומך בבדיקה ישירות ממסך הפרטים של יחידת המודעות. בנוסף, אתם יכולים לבדוק כמה יחידות מודעות בו-זמנית, לטעון באופן אסינכרוני את בקשות הבדיקה להצגת מודעות ולהציג אותן, ואפילו לבצע בדיקות של מקור מודעות יחיד.
בדיקות מודעות
הבדיקות של המודעות בכלי לבדיקת מודעות שמתוארות בקטע הזה הן כלי מצוין לאימות חוויית הצופה במודעה הבסיסית ולבדיקת ההגדרה של תהליך בחירת הרשת (Mediation) כשמשתמשים בהן עם בדיקה של מקור מודעות יחיד.
כשמוכנים לבדוק את יחידת המודעות, מקישים על הלחצן בקשה למודעת בדיקה בחלק העליון של המסך בכלי לבדיקת מודעות כדי להפעיל את בדיקת המודעות בכלי. תוצאות הבדיקה יופיעו ביומן הבקשות מה-SDK מתחת לכותרת Requested from הכלי לבדיקת מודעות.
בדיקה של מקור מודעות יחיד
בכלי לבדיקת המודעות יש תכונה להגבלת הבקשות למודעות באפליקציה, כך שהמערכת תציג רק מודעות ממקור מודעות יחיד לבידינג או ממקור מודעות יחיד ב-Waterfall. כך תוכלו לוודא שהטמעתם נכון את המתאם של הצד השלישי ושמקור המודעות ממלא בקשות כמצופה.
כדי להפעיל את התכונה הזו, מעבירים את המתג Single ad source test (בדיקה של מקור מודעות יחיד) בחלק התחתון של המסך. מוצגת תיבת הדו-שיח הבאה לבחירת מקור מודעות:
כדי לבדוק מקור מודעות יחיד, קודם צריך להפעיל את Google Mobile Ads SDK.
אחר כך תוכלו לבחור מקור מודעות יחיד לבדיקה. אחרי שבוחרים מקור תנועה, מופיע המסך הבא:
ההגדרה של בדיקת מקור מודעות יחיד חלה על כל הבקשות העתידיות למודעות שתשלחו באותו סשן. עם זאת, היא לא חלה על מודעות שכבר נשמרו במטמון באותו סשן, ושעדיין לא הוצגו. מומלץ לכפות הפעלה מחדש של האפליקציה כשמחילים בדיקה של מקור מודעות יחיד, כדי לבטל מודעות שמורות במטמון שיכול להיות שיוצגו במקום שמקור המודעות שבחרתם יקבל בקשה.
אחרי שמפעילים מחדש את האפליקציה, המערכת מנסה להציג מודעה רק מהרשת שנבחרה בכל מיקומי המודעות. כשמפעילים את הכלי לבדיקת המודעות בזמן שבדיקה של מקור מודעות יחיד פעילה, מוצג מקור המודעות הפעיל שנבדק:
במצב בדיקה של מקור מודעות יחיד, המערכת תנסה למלא את כל הבקשות להצגת מודעות ממקור המודעות שנבחר, גם אם הוא הוגדר לבידינג או לתהליך בחירת רשתות עבור יחידת המודעות שנדרשה וגם אם לא. אם מקור המודעות שאתם בודקים לא נמצא ברשימת הרשתות בתהליך בחירת הרשת של יחידת מודעות, תוצג לכם הודעה על שגיאת הצגה (no fill).
כשבודקים מקור מודעות יחיד אפשר ללחוץ על יחידת מודעות כדי להציג את יומן הבקשות שלה מה-SDK. כך תוכלו לראות אם מקור המודעות מילא את הבקשות להצגת מודעות שנשלחו אחרי שהפעלתם בדיקה של מקור מודעות יחיד. אם מקור המודעות לא הצליח לטעון מודעה, תוצג הודעת שגיאה עם תיאור השגיאה.
אם הוספתם כמה מופעים של מקור המודעות שנבחר לרשימת רשתות בתהליך בחירת הרשת, יוצג לכם כל מופע של הקריאה שנשלחה למקור המודעות ב-Waterfall עד למילוי הבקשה להצגת מודעה או עד שה-Waterfall יסתיים בלי למלא אותה.
הפסקת בדיקה של מקור מודעות יחיד
כדי להפסיק את הבדיקה, מעבירים את המתג למצב כבוי:
אחרי כן תופיע הודעת אישור מעל מסך ההפעלה מחדש הבא:
מומלץ לכפות הפעלה מחדש של האפליקציה אחרי שמפסיקים את הבדיקה, כדי לבטל את המודעות שנשמרו במטמון של מקור המודעות שנבדק.
ניפוי באגים בהגדרות הפרטיות
דרישות מוקדמות: Google Mobile Ads SDK גרסה 9.6.0 ואילך
אתם יכולים להשתמש בכלי לבדיקת מודעות כדי לראות את אותות הפרטיות הבאים שמועברים בבקשה להצגת מודעה כחלק מהשילוב של בעלי תוכן דיגיטלי עם TCF של IAB Europe:
- ה-GDPR חל (
IABTCF_gdprApplies) - מחרוזת AC (
IABTCF_AddtlConsent) - נתוני שקיפות והסכמה (
IABTCF_TCString)
אחרי טעינת מודעה או ביצוע בדיקת מודעות בכלי לבדיקת מודעות, מקישים על סמל התפריט בבקשה בקטע יומן הבקשות מה-SDK. אחר כך בוחרים באפשרות אותות פרטיות.
במסך אותות פרטיות מוצגים אותות הפרטיות שמועברים בבקשה להצגת מודעה.
מידע נוסף על נתוני הסכמה נוספים, ראו המפרט הטכני של Google בנושא הסכמה נוספת. כדי לראות פרטים מדויקים של ההסכמה במחרוזת של נתוני השקיפות וההסכמה, כמו מזהה פלטפורמת ה-CMP ורשימת מזהי הספקים שמשויכים ל-IAB שהמשתמשים הביעו הסכמה לגביהם, לוחצים על Decode כדי לפתוח את IAB GPP Encoder / Decoder.
אם נתקלתם בשגיאות, אתם יכולים לפעול לפי השלבים במאמר בנושא הסבר על בעיות שקשורות לפרטיות כדי לפתור אותן.
העתקת כל פלט ניפוי הבאגים
כלי לבדיקת מודעות תומך בהעתקה של מחרוזת JSON שמכילה את כל פלט הניפוי באגים מהכלי, כולל פרטים על האפליקציה שמקושרת ל-AdMob, סטטוסים של אתחול מתאמים ותוצאות הבדיקה של כל יחידות המודעות.
כדי לעשות זאת, מקישים על סמל האפליקציה שבע פעמים עד שמופיעה ההודעה קובץ ה-JSON של הכלי לבדיקת מודעות הועתק ללוח.