סקירה כללית של הדוחות

‫Campaign Manager 360 API מספק כמה דרכים לאחזור נתונים של מודעות שנוהל בהן טראפיק דרך Campaign Manager 360.

שירות הדוחות

יצירת דוחות באמצעות שירות Reports כוללת תהליך עבודה רב-שלבי להגדרה, ליצירה ולאחזור של קובצי דוחות (כמו קובצי CSV או Excel). זהו נתיב הדיווח הרגיל של Campaign Manager 360 API, והוא מתאים למערכי נתונים גדולים, לסקריפטים מתוזמנים אוטומטיים או לאפליקציות downstream שצורכות קבצים.

תהליך העבודה בדרך כלל כולל את השלבים הבאים:

1. מגדירים או מאתרים משאב Report (מציינים מאפיינים, מדדים, טווחי תאריכים ומסננים) שנשמר עם מזהה דוח ייחודי. מידע נוסף זמין במאמר יצירה ועדכון של דוחות.
2. מריצים את יצירת הדוח על ידי קריאה לשיטה reports.run. הפעולה הזו מוסיפה את הרצת הדוח לתור ומחזירה placeholder File resource. מידע נוסף זמין במאמר בנושא איתור והרצה של דוחות.
3. בודקים באופן תקופתי את הסטטוס של המשאב File. התהליך הזה פועל באופן אסינכרוני, ולכן הסטטוס של הקובץ יתחיל כ-PROCESSING וישתנה ל-REPORT_AVAILABLE כשהוא יושלם. מידע נוסף זמין במאמר בנושא איתור והרצה של דוחות.
4. אחרי שהדוח מוכן, מאחזרים את תוכן הקובץ (CSV או Excel). הורדת דוחות

הרצת דוחות באופן סינכרוני

אם אתם צריכים ליצור קובץ דוח (CSV או Excel) לכמות קטנה של נתונים, אתם יכולים להריץ את הדוח באופן סינכרוני על ידי קריאה לשיטה reports.run עם הפרמטר synchronous שמוגדר לערך true. ה-API מנסה ליצור את הדוח בתוך פרק זמן קצר. אם הביצוע יימשך זמן רב יותר, הפעלת הדוח תעבור אוטומטית לתור האסינכרוני.

פרטים נוספים זמינים במאמר בנושא דוחות סינכרוניים.

נתוני דוח השאילתות

אפשר להשתמש בשיטה reportData.query כדי לשלוח שאילתה ישירות לנתוני הדיווח במקום ליצור קובץ דוח.

• במקום ליצור ולשמור משאב Report, מציינים את המאפיינים, המדדים וקריטריונים אחרים לסינון או למיון ישירות בבקשה.
• התשובה מכילה נתוני דוח מובְנים, כך שלא צריך לשלוח בקשות להורדת קובץ שנוצר.
• הבקשה מופעלת באופן סינכרוני עם מגבלה של 60 שניות.

פרטים נוספים זמינים במאמר בנושא שאילתת נתוני דוחות בפורמט JSON.