ה-AdSense Management API כולל קריאות ליצירת דוחות חדשים ושמורים. הם יכולים לכלול ניתוחי נתונים פשוטים, כמו רווחים ליום, או טבלאות מורכבות מאוד של שיעורי קליקים לכל ערוץ מותאם אישית בכל מדינה. במדריך הזה מופיעה רשימה של תרחישי קצה שצריך לטפל בהם כראוי כדי לשלב בצורה יעילה את ממשקי ה-API.
מבנה הדוח
תוצאות הדוח מוחזרות כאובייקט ReportResult. הפרטים המלאים מופיעים בחומר העזר בנושא התשובות לדוח.
שימוש במאפיינים כרונולוגיים: DATE, WEEK ו-MONTH
הדוחות יכולים להיות ריקים או שיהיו בהם פערים
אם לא הייתה פעילות במהלך תקופת הזמן שצוינה בבקשה, לא ייווצרו בקשות להצגת מודעות ובשירות הדוחות לא יוצגו שורות לגבי תקופות הזמן האלה. יש לכך חשיבות אם אתם, לדוגמה, משרטטים גרף.
למידע נוסף, קראו את המדריך למילוי תאריכים.
בקשה למאפיינים MONTH ו-WEEK באותו דוח
לדוח הזה יכולות להיות השלכות שליליות או בלתי צפויות. אם שבוע שייך לשני חודשים שונים, יוצגו שתי שורות לאותו שבוע, אחת לכל חודש.
דוגמה
| מאפיינים | מדדים | תאריך התחלה | תאריך סיום |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
החזרות:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | 2014-04-27 | 43 |
* היום הראשון בשבוע
פתרון
הסרת MONTH מהדוח.
WEEK | CLICKS |
|---|---|
| 2014-04-27 | 93 |
קיבוץ ערכי המאפיינים
כשתבקשו מאפיינים כמו אלה שקשורים לפלטפורמות (מחשבים, מכשירים ניידים מתקדמים וכו'), לדוגמה, יוצגו רק הפלטפורמות שיש בהן פעילות. אם ביום, בשבוע או בחודש מסוימים אין ביקורים ממכשירים ניידים מתקדמים, לא יהיה מידע עבור קטגוריה זו.
דוגמה
| מאפיינים | מדדים | תאריך התחלה | תאריך סיום |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
החזרות:
| חודש | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | מחשב | 100 |
| 2014-03 | מכשירים ניידים מתקדמים | 5 |
| 2014-04 | מחשב | 75 |
פתרון
כשמעבדים את תוצאות הדוח, מניחים שהערך הוא אפס לערכי המאפיינים שלא מופיעים בתוצאות:
| חודש | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | מחשב | 100 |
| 2014-03 | מכשירים ניידים מתקדמים | 5 |
| 2014-04 | מחשב | 75 |
| 2014-04 | מכשירים ניידים מתקדמים | 0 |
שילוב של כמה דוחות רציפים
לפעמים הדוח גדול מדי מכדי ליצור את כולו בבת אחת וצריך לקבץ אותו. אם האפליקציה שלכם עושה זאת, מומלץ להביא בחשבון את המקרים הבאים:
- אם השתמשת במאפיינים
WEEKאוMONTHואתה מפצל את הדוח באמצע שבוע או חודש, לכל דוח יהיו רשומות כפולות עם נתונים שונים. - חשוב לוודא שהמדדים והמאפיינים בכל הדוחות זהים, כי ייתכן שלא ניתן יהיה לשלב את הנתונים בעזרת מאפיינים שונים.
חשבונות מיוחדים
יכול להיות שלחלק מהמשתמשים שלכם יש חשבונות AdSense עם מאפיינים לא צפויים או שאתם לא יודעים עליהם. חשוב להביא בחשבון את הפרטים הבאים:
- בעלי אתרים עם אלפי דומיינים או אתרים
- בעלי אתרים עם אלפי יחידות מודעות או ערוצים מותאמים אישית
- בעלי אתרים שרוצים לדווח על מספר לקוחות מודעות (AdSense לחיפוש, AdSense לווידאו וכו')
מספר חשבונות
למשתמשים יכולה להיות גישה ליותר מחשבון AdSense אחד. לכן צריך לציין מספר חשבון לכל קריאה ל-API. קריאה ל-accounts.list מאחזרת רשימה של חשבונות, ותיבת הדו-שיח של Account Chooser צריכה להיות מוצגת למשתמש. אפשר לעקוף את השיטה הזאת אם מספר החשבונות שנשלפו הוא אחד.
שינויים באזור הזמן
בעלי אתרים ב-AdSense יכולים לשנות את אזור הזמן שלהם בכל עת, וכתוצאה מכך עלולות להיות עליות או ירידות חדות בדוחות. למידע נוסף, קראו את המדריך בנושא דיווח על אזור זמן מקומי.