במדריך הזה נסביר איך להפעיל את התכונות השונות בכלי לבדיקת מודעות ואיך להשתמש בהן.
דרישות מוקדמות
כדי להשתמש בכלי לבדיקת מודעות, צריך:
- צריך לקרוא את המדריך לתחילת העבודה.
- משתמשים בגרסה 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 מיחידת מודעות, מקישים על אותה יחידת מודעות. ברישומים יופיע פירוט של נתוני תהליך בחירת הרשת (Mediation) ב-Waterfall של הבקשות האחרונות למודעות, עד לשלב שבו הבקשה למודעה מולאה (או עד שה-Waterfall הסתיים בלי למלא את הבקשה).
אפשר להרחיב כל בקשה באמצעות חץ החשיפה כדי להציג את התוצאות של רשימת הרשתות בתהליך בחירת רשת של הבקשה, יחד עם שגיאות וזמני טעינה שרלוונטיים לבקשה.
במקורות מודעות של צד שלישי, הודעות השגיאה נשלחות ישירות ממקור המודעות. כדי לקבל מידע נוסף, פנו למקור המודעות של הצד השלישי.
צפייה בפרטי הבידינג של יחידת מודעות
אם אין לכם ניסיון בבידינג, כדאי לקרוא את הסקירה הכללית.
ביומן הבקשות מה-SDK, אפשר לראות את מקורות המודעות לבידינג שהופעלו בבקשה להצגת מודעה. מקישים על יחידת מודעות ביומן הבקשות מה-SDK כדי לראות את הפרטים של כל מקור מודעות במכרז הבידינג.
תוצאות הבידינג ממוינות כך שהפריטים שניתנים למימוש מוצגים בחלק העליון של הרשימה:
בחלק העליון מופיעה רשת המודעות שזכתה במכרז.
בהמשך מופיעות רשתות המודעות שזוהו בהן בעיות. אפשר לפעול בהתאם לשלבים לפתרון בעיות.
אחר כך, יש רשתות מודעות שלא החזירו מודעות או שלא הגישו הצעות מחיר. יכול להיות שהסיבה לכך שמקור המודעות לא מגיש הצעות מחיר קשורה להגדרה שלו או לאופן קבלת ההחלטות שלו. אפשר לעיין במדריך ההגדרה של מקור המודעות או לפנות ישירות למקור המודעות לקבלת תמיכה.
לבסוף, בתחתית הרשימה מופיעות רשתות המודעות שהפסידו במכרז הבידינג.
רשימת רשתות בתהליך בחירת רשת יכולה למקם את מקור המודעות שזכה במכרז הבידינג בהתאם לערך העלות בפועל לאלף חשיפות שלו.
כשמקור מודעות מופעל ב-Waterfall של תהליך בחירת הרשת (Mediation), הוא יכול להציג מודעות. כדי לקבל מידע נוסף על אופן הפעולה של הבידינג עם רשימת רשתות בתהליך בחירת רשת, אפשר לעיין בדוגמה 2 ובדוגמה 3 של מקורות מודעות לבידינג ומקורות מודעות ב-Waterfall בקבוצה לבחירת רשת.
ניפוי באגים מתקדם ביחידות מודעות
כשמנסים לפתור בעיות ביחידות מודעות, כדאי לבדוק את הבקשה להצגת מודעה ואת התשובה כדי לזהות איפה יש כשל, או לשתף אותן עם צוות התמיכה של Google כדי לקבל עזרה בניפוי הבאגים. מקישים על סמל התפריט בראש שרשרת ה-waterfall ובוחרים באפשרות שיתוף הבקשה להצגת מודעה והתשובה כדי לייצא את הבקשה המלאה להצגת מודעה ואת התשובה. כך לא תצטרכו להריץ מעקב אחר תנועת הרשת באפליקציה שלכם.
בנוסף, אפשר להקיש על האפשרות פרמטר לבידינג של צד שלישי באותו תפריט שבו מופיע מחרוזת הבקשה כדי לראות את הפרמטרים לבידינג של צד שלישי אחרי פענוח. כך תוכלו לראות פרטים על פרמטרים של בידינג מצד שלישי שאולי יש בהם בעיות, ולבצע ניפוי באגים באפליקציה או לוודא שרשת מסוימת אוספת את האותות שלה בהצלחה.
הצגת המתאמים הזמינים
לוחצים על הכרטיסייה מתאמים כדי לראות רשימה של כל המתאמים של צד שלישי שמשויכים למקורות המודעות בהגדרות הבידינג או תהליך בחירת הרשת באפליקציה. לאחר מכן, מרחיבים את הכרטיסים כדי לראות את סטטוסי ההפעלה ואת גרסאות ה-SDK שלהם. בנוסף למתאמים נתמכים של צד שלישי, אפשר גם לראות מתאמי אירועים בהתאמה אישית.
אירועים בהתאמה אישית מאפשרים לבעלי אפליקציות להשתמש ברשתות מודעות שלא נתמכות ב-AdMob. אירועים מותאמים אישית נבדלים ממתאמים רגילים של צד שלישי ברשימת המתאמים לפי שמות המחלקות הייחודיים שלהם. בנוסף לשם המחלקה ולפרטי הסטטוס, הכלי לבדיקת מודעות מציג גם את התוויות שהוקצו לאירועים המותאמים אישית האלה בממשק האינטרנט של AdMob.
אם המתאם לא נמצא או אם האתחול שלו נכשל, אפשר לקרוא מידע נוסף במאמר בנושא פתרון בעיות שזוהו באמצעות הכלי לבדיקת מודעות.
בדיקה של יחידות המודעות
אם אתם רוצים לבדוק את יחידת המודעות בלי לנווט אליה בממשק המשתמש של האפליקציה, הכלי לבדיקת מודעות תומך בבדיקה ישירות ממסך הפרטים של יחידת המודעות. בנוסף, אפשר לבדוק כמה יחידות מודעות בו-זמנית, לטעון באופן אסינכרוני את הבקשות להצגת מודעות בדיקה ולצפות בהן, ואפילו לבצע בדיקות של מקור מודעות יחיד.
בדיקות מודעות
הבדיקות של המודעות בכלי לבדיקת מודעות שמתוארות בקטע הזה הן כלי מצוין לאימות חוויית הצופה במודעה הבסיסית ולבדיקת ההגדרה של תהליך בחירת הרשת (mediation) כשמשתמשים בהן עם בדיקה של מקור מודעות יחיד.
כשמוכנים לבדוק את יחידת המודעות, מקישים על הלחצן בקשת מודעת בדיקה בחלק העליון של המסך של הכלי לבדיקת מודעות כדי להפעיל את בדיקת המודעות של הכלי. תוצאות הבדיקה יופיעו ביומן הבקשות מה-SDK מתחת לכותרת Requested from ad inspector (בקשה מהכלי לבדיקת מודעות).
בדיקה של מקור מודעות יחיד
בכלי לבדיקת המודעות יש תכונה להגבלת הבקשות למודעות באפליקציה, כך שהמערכת תציג רק מודעות ממקור מודעות יחיד לבידינג או ממקור מודעות יחיד ב-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) - נתוני הסכמה נוספים (
IABTCF_AddtlConsent) - נתוני השקיפות וההסכמה (
IABTCF_TCString)
אחרי טעינת מודעה או ביצוע בדיקת מודעות בכלי לבדיקת מודעות, מקישים על סמל התפריט בבקשה שמופיעה בקטע יומן הבקשות מה-SDK. לאחר מכן, בוחרים באפשרות אותות פרטיות.
במסך Privacy signals מוצגים אותות הפרטיות שמועברים בבקשה להצגת מודעה.
מידע נוסף על נתוני הסכמה נוספים, ראו המפרט הטכני של Google בנושא הסכמה נוספת. כדי לראות פרטים מדויקים של ההסכמה במחרוזת של נתוני השקיפות וההסכמה, כמו מזהה פלטפורמת ה-CMP ורשימת מזהי הספקים שמשויכים ל-IAB שהמשתמשים הביעו הסכמה לגביהם, לוחצים על Decode כדי לפתוח את IAB GPP Encoder / Decoder.
אם נתקלתם בשגיאות, אתם יכולים לפעול לפי השלבים במאמר בנושא הסבר על בעיות שקשורות לפרטיות כדי לפתור אותן.
העתקת כל נתוני הפלט של ניפוי הבאגים
כלי לבדיקת מודעות תומך בהעתקה של מחרוזת JSON שמכילה את כל פלט הניפוי באגים מהכלי, כולל פרטים על האפליקציה שמקושרת ל-AdMob, סטטוסים של אתחול מתאמים ותוצאות הבדיקה של כל יחידות המודעות.
כדי לעשות זאת, מקישים על סמל האפליקציה שבע פעמים עד שמופיעה ההודעה קובץ ה-JSON של הכלי לבדיקת מודעות הועתק ללוח.