באמצעות הכלי לבדיקת מודעות, אפשר:
- בדיקה של יחידות המודעות
- לבדוק אם המודעות מתמלאות כמצופה
- לזהות שגיאות ולראות איך לפתור אותן
- הצגת הפרטים של כל רשת מודעות מסוג Open Bidding לפי בקשה
- להציג את פרטי הגישור של כל רשת מודעות לפי בקשה
- בדיקה של מקורות מודעות ספציפיים של צד שלישי ב-Open Bidding או של תהליך בחירת הרשת (Mediation) ב-Waterfall
- ודאו שהגדרתם נכון כל יחידת מודעות עבור Open Bidding ותהליך בחירת הרשת ב-Waterfall
במדריך הזה נסביר איך להשיק את התכונות השונות בכלי לבדיקת מודעות ולהשתמש בהן.
דרישות מוקדמות
כדי להשתמש בכלי לבדיקת מודעות, צריך:
- מבצעים את ההוראות שמופיעות במדריך לתחילת העבודה.
- צריך להשתמש Flutter בגרסת הפלאגין של מודעות לנייד 1.3.0 ואילך.
- מפעילים מצב בדיקה או מקשרים את המכשיר ל-Ad Manager. הכלי לבדיקת מודעות מופעל רק במכשירים לבדיקה או במכשירים מקושרים.
הפעלה של הכלי לבדיקת מודעות
אפשר להפעיל את הכלי לבדיקת מודעות מכל מקום באפליקציה בדרכים הבאות:
- משתמשים בלחצן ההפעלה שבתפריט ניפוי הבאגים.
- משתמשים בתנועה שבחרתם בהגדרות של הכלי לבדיקת מודעות.
- שימוש פרוגרמטי ב-API שסופק.
הפעלה באמצעות תפריט ניפוי באגים
אין צורך לבצע שינויים באפליקציה כדי להפעיל את הכלי לבדיקת מודעות דרך תפריט ניפוי הבאגים. פשוט מחפשים מודעה שמוצגת על ידי רשת Ad Manager ואז לוחצים לחיצה ארוכה על המודעה עם שתי אצבעות כדי לפתוח את תפריט ניפוי הבאגים. ובוחרים באפשרות פתיחה של הכלי לבדיקת מודעות.
אם לא קישרתם את המכשיר, יכול להיות שתתבקשו להיכנס לחשבון Ad Manager.
אפשר גם לבחור את ההגדרות של הכלי לבדיקת מודעות בהגדרות ניפוי הבאגים ולבחור תנועה שיכולה לפתוח את הכלי לבדיקת מודעות בעתיד, בלי שתצטרכו לעבור דרך תפריט ניפוי הבאגים.
הפעלה באופן פרוגרמטי
אפשר להפעיל את הכלי לבדיקת מודעות גם באופן פרוגרמטי:
MobileAds.instance.openAdInspector(
(AdInspectorError? error) {
// Error will be non-null if ad inspector closed due to an error.
});
ה-API הזה פועל במכשירי בדיקה שנרשמו באופן פרוגרמטי.
הצגה של יחידות מודעות ופתרון בעיות
לאחר ההפעלה, המסך הראשי של הכלי לבדיקת מודעות יופיע עם רשימה של כל יחידות המודעות המכשיר שלח בקשות להצגת מודעות מאז שכלי לבדיקת מודעות הופעל במהלך הסשן הזה באפליקציה. הרשימה מכילה גם יחידות מודעות שמופעלות בהן Open Bidding, מסודרות לפי סדר כרונולוגי עם הבקשות האחרונות שהושלמו ראשונה, ויחידות שלא הוגשו עבורן בקשות למודעות שהושלמו:
מומלץ להפעיל את ה-SDK של Google Mobile Ads לפני שמשתמשים בכלי לבדיקת מודעות.
הצגת פרטי רשימת הרשתות בתהליך בחירת הרשת עבור יחידת מודעות
מקישים על יחידת מודעות כדי לצפות ביומן הבקשות שלה ל-SDK. ביומן הזה מופיעים פרטים על רשימת הרשתות בתהליך בחירת הרשת עד לנקודה שבה המודעה מולאה (או ה-Waterfall ללא מילוי) לבקשות האחרונות להצגת מודעות.
אפשר להרחיב כל בקשה באמצעות מחוון הגילוי הנאות כדי להציג את התוצאות של רשימת הרשתות בתהליך בחירת הרשת עבור הבקשה, יחד עם כל שגיאה וזמן אחזור רלוונטי לבקשה הזו.
במקורות מודעות של צד שלישי, הודעות השגיאה נשלחות ישירות ממקור המודעות. כדי לקבל מידע נוסף, אפשר לפנות למקור המודעות של הצד השלישי.
הצגת פרטי בידינג של יחידת מודעות
אם זו הפעם הראשונה שאתם משתמשים ב-Open Bidding, מומלץ לקרוא את המבוא ל-Open Bidding.
ביומן הבקשות מה-SDK אפשר לראות את bidding מקורות המודעות שמופעלת בבקשה להצגת מודעה. כדי לראות את הפרטים של כל מקור מודעות bidding במכרז, אפשר להקיש על יחידת מודעות ביומן הבקשות ל-SDK.
התוצאות bidding ממוינות כדי לקרב את הפריטים שניתן לבצע להם פעולה לראש הרשימה:
בחלק העליון מוצגת רשת המודעות שזכתה במכרז.
בהמשך מוצגות רשתות המודעות שיש בהן בעיות. אפשר לפעול לפי שלבים לפתרון בעיות בסוף bidding השאלות הנפוצות.
לאחר מכן, יש רשתות של מודעות שלא הוחזרו להן מודעות או שלא הגישו הצעות מחיר. זהו סימן אפשרי לבעיות שונות במקור המודעות, כי יכול להיות שלא הוגשה בו הצעת מחיר בגלל ההגדרה או ההחלטה שהתקבלה. תוכלו לעיין במדריך ההגדרה של מקור המודעות או שאלות נפוצות בנושא Open Bidding לקבלת תמיכה נוספת.
לבסוף, בחלק התחתון של הרשימה מופיעות רשתות המודעות שהפסידוbidding במכרז.
רשימת הרשתות בתהליך בחירת הרשת יכולה להציב את מקור המודעות שזכהbidding במכרז, בהתאם לערך העלות בפועל לאלף חשיפות (eCPM) שלו.
רשימת רשתות בתהליך בחירת רשת היא מצב שבו מספר קבוצות תפוקה מתחרות על אותו מלאי שטחי פרסום. אפשר להוסיף עד עשרה שותפי תפוקה של צד שלישי לקבוצת תפוקה אחת, כולל שותפי תפוקה ב-Open Bidding ותהליך בחירת הרשת (Mediation) לשותפי תפוקה של אפליקציות לנייד.
ניפוי באגים מתקדם של יחידות מודעות
במהלך פתרון בעיות ביחידות של מודעות, כדאי להתעמק בבקשה להצגת מודעה ובתגובה לבקשה כדי לזהות איפה משהו נכשל, או לשתף את המידע עם התמיכה של Google כדי לנפות באגים. כדי לייצא את הבקשה המלאה של הבקשה להצגת מודעה ואת התגובה לבקשה להצגת מודעה, מקישים על סמל התפריט בחלק העליון של שרשרת ה-Waterfall ובוחרים באפשרות Share ad request and request כך לא תצטרכו להריץ מעקבי רשת באפליקציה שלכם.
בנוסף, אפשר לראות פרמטרים מפוענחים של בידינג של צד שלישי על ידי הקשה על האפשרות 3 Party bidding parameter (פרמטר של בידינג של צד שלישי) באותו תפריט שבו מופיעה מחרוזת הבקשה. כאן מופיעים פרטים על הפרמטרים של בידינג של צד שלישי שעלולים לגרום לבעיות, ועוזרים לנפות באגים באפליקציה או לוודא שרשת מסוימת אוספת את האותות שלה בצורה נכונה.
|
|
הצגת המתאמים הזמינים
לוחצים על הכרטיסייה Adapters כדי להציג רשימה של כל המתאמים של צד שלישי שמשויכים למקורות המודעות בהגדרות של הבידינג או תהליך בחירת הרשת באפליקציה. לאחר מכן מרחיבים את הכרטיסים כדי לראות את סטטוסי האתחול ואת גרסאות ה-SDK שלהם. לצד מתאמים נתמכים של צדדים שלישיים תוכלו גם להציג מתאמים לאירועים בהתאמה אישית. אירועים מותאמים אישית מאפשרים לבעלי אפליקציות להשתמש ברשתות של מודעות Ad Managerשלא תומכות בהן. נבדלים בין אירועים מותאמים אישית לבין מתאמים רגילים של צד שלישי ברשימת המתאמים לפי שמות המחלקות הייחודיים שלהם. בנוסף למתן השם והסטטוס של המחלקה, הכלי לבדיקת מודעות מציג גם את התוויות שהוקצו לאירועים המותאמים אישית האלה בAd Manager ממשק האינטרנט.
אם המתאם לא נמצא או שאי אפשר להפעיל אותו, אפשר לעיין במאמר בדיקה של הצגת מודעות לקידום אפליקציות לנייד לקבלת מידע נוסף.
|
|
בדיקה של יחידות המודעות
אם תרצו לבדוק את יחידת המודעות בלי שתצטרכו לנווט אליה בממשק המשתמש של האפליקציה, הכלי לבדיקת מודעות תומך בכך ישירות ממסך הפרטים של יחידת המודעות. בנוסף, אפשר לבדוק מספר יחידות מודעות בו-זמנית, לטעון ולהציג באופן אסינכרוני את הבקשות למודעות לבדיקה, ואפילו לבצע בדיקות של מקור מודעות יחיד.
בדיקת מודעות
הבדיקות של הכלי לבדיקת מודעות שמפורטות בקטע הזה הן כלי מעולה לאימות חוויית המשתמש הבסיסית עם המודעות ולאימות ההגדרות של תהליך בחירת הרשת כשבודקים את מקור המודעות יחיד.
כשרוצים לבדוק את יחידת המודעות, מקישים על הלחצן Request test ad (בקשת מודעה לבדיקה) בחלק העליון של המסך של הכלי לבדיקת מודעות כדי להפעיל את בדיקת המודעות של הכלי לבדיקת מודעות. תוצאות הבדיקה יופיעו ביומן הבקשות ל-SDK מתחת לכותרת בקשה מכלי לבדיקת מודעות.
בדיקה של מקור מודעות יחיד
בכלי לבדיקת מודעות יש תכונה שמגבילה את הבקשות להצגת מודעות באפליקציה כך שיוצגו מודעות רק ממקור מודעות אחד bidding או ממקור מודעות אחד ברשימת הרשתות בתהליך בחירת הרשת. כך תוכלו לוודא שהטמעתם בצורה נכונה את המתאם של הצד השלישי ושמקור המודעות פועל כצפוי.
כדי להפעיל את התכונה הזו, מעבירים את המתג בדיקה של מקור מודעות יחיד בתחתית המסך. תוצג תיבת הדו-שיח הבאה לבחירת מקור המודעות:
כדי להשתמש בבדיקות של מקור מודעות יחיד, צריך להפעיל את ה-SDK של Google Mobile Ads.
בשלב הבא אתם יכולים לבחור מקור מודעות אחד לבדיקה. אחרי שבוחרים מקור מודעות, מופיע המסך הבא:
הגדרת הבדיקה של מקור מודעות יחיד תחול על כל הבקשות העתידיות להצגת מודעות שתשלחו באותו סשן. עם זאת, הוא לא חל על מודעות שנשמרו במטמון בעבר בסשן הזה, שעדיין לא הוצגו. אילוץ הפעלה מחדש של האפליקציה מומלץ לבצע כשמחילים בדיקה של מקור מודעות יחיד, כדי לבטל את התוקף של מודעות שנשמרו במטמון שהיו יכולות להופיע במקום שמקור המודעות שבחרתם יקבל בקשה.
אחרי שמפעילים מחדש את האפליקציה, בכל המיקומים של יחידות המודעות המערכת מנסה להציג מודעה מהרשת שנבחרה בלבד. כשמפעילים את הכלי לבדיקת מודעות כשמתבצעת בדיקה של מקור מודעות אחד, מופיע מקור המודעות הפעיל לבדיקה:
במצב בדיקה של מקור מודעות יחיד, מתבצע ניסיון למלא את כל הבקשות להצגת מודעות במקור המודעות שנבחר, גם אם מקור המודעות הזה הוגדר לבידינג או לתהליך בחירת הרשת (Mediation) עבור יחידת המודעות המבוקשת. אם מקור המודעות שאתם בודקים לא נמצא ברשימת הרשתות בתהליך בחירת הרשת של יחידת מודעות, תופיע הודעת השגיאה "לא מולאה".
בבדיקה של מקור מודעות יחיד אפשר להקיש על יחידת מודעות כדי להציג את יומן הבקשות שלה מה-SDK. כך אפשר לדעת אם מקור המודעות מילא את הבקשות להצגת מודעות שנשלחו אחרי שהופעלה בדיקה של מקור מודעות יחיד. אם מקור המודעות לא הצליח לטעון מודעה, מופיעה הודעת שגיאה שמתארת את השגיאה.
אם הוספתם מספר מופעים של מקור המודעות שנבחר ל-Waterfall של תהליך בחירת הרשת, תראו כל מופע של הקריאה למקור המודעות ב-Waterfall עד שהמודעה תתמלא או שה-Waterfall יסתיים ללא מילוי.
הפסקת בדיקה של מקור מודעות יחיד
כדי להפסיק את הבדיקה, מעבירים את המתג למצב כבוי:
לאחר מכן תופיע הודעת אישור במסך ההפעלה מחדש הבא:
אחרי שמפסיקים את הבדיקה, מומלץ להפעיל מחדש את האפליקציה באופן ידני כדי לשלול את התוקף של מודעות שנשמרו במטמון למקור המודעות שנבדק.
העתקת כל תוצאות ניפוי הבאגים
הכלי לבדיקת מודעות תומך בהעתקה של מחרוזת JSON שמכילה את כל נתוני הפלט של ניפוי הבאגים מהכלי, כולל פרטים עלAd Manager האפליקציה, סטטוסים של אתחול מתאמים ותוצאות הבדיקה של כל יחידות המודעות.
כדי לעשות זאת, מקישים על סמל האפליקציה שבע פעמים עד שמופיעה ההודעה קובץ JSON של הכלי לבדיקת מודעות שהועתקה ללוח.