במקום לקבל קובץ dump של כל הנתונים בכל פעם שתבקש דוח, תוכל לבקש מדי פעם רק את הנתונים שהשתנו מאז הדוח האחרון שלך. סביר להניח שהדוחות המצטברים האלה יהיו קטנים משמעותית מהדוח המלא.
אם אתם מבקשים דוחות מצטברים, עליכם להביא בחשבון את הפרטים הבאים:
- עדיין מומלץ לבקש דוח מלא מדי פעם, למקרה לאיבוד חלק מהשינויים המצטברים. לדוגמה, אם מבקשים דוחות מצטברים שבועיים במהלך ינואר, בסוף פברואר צריך לבקש דוח מלא עבור ינואר כדי להבטיח שכל הנתונים של ינואר יגיעו.
- בגלל שלא תמיד אפשר לקבוע אם ישויות מסוימות השתנו, דוח מצטבר יכלול את הישות אם מערכת Search Ads 360 אפילו תחשד שהישות השתנתה. פירוש הדבר הוא שדוחות מצטברים עשויים להכיל נתונים שלא השתנו.
כדי לבקש דוח מצטבר, צריך לציין אחד ממאפייני Reports.request.timeRange
הבאים:
changedMetricsSinceTimestamp=timestampהמדדים של בקשות שהשתנו מאז חותמת הזמן שצוינה. המדדים מאוחסנים ברמת פירוט יומית ועשויים להשתנות במשך יום אחד, אבל לא ביום אחר, ולכן צריך לפלח את הבקשות האלה לפי יום (חובה לציין את העמודה
date). לדוגמה, דוחkeywordעם העמודותclicks,actionsו-dateיחזיר שורה לכל מילת מפתח ותאריך שבו המספר המתועד של קליקים או פעולות השתנה מאז חותמת הזמן הנתונה.חותמת הזמן חייבת להיות לכל היותר 8 ימים לפני מועד הבקשה. כדי לתעד את כל המדדים המשתנים, עליך לשלוח בקשת
changedMetricsSinceTimestampלפחות פעם ב-7 ימים, ולהפיק דוח מלא לגבי כל תאריך לאחר הסדרת המדדים (עדיף להמתין לפחות 7 ימים). דפוס לדוגמה הוא יצירת שני דוחות בכל יום: דוח מצטבר למדדים שהשתנו ב-36 השעות האחרונות, ודוח מלא למדדים שהתרחשו לפני 8 ימים.changedAttributesSinceTimestamp=timestampמאפייני הבקשות שהשתנו מאז חותמת הזמן הנתונה. בקשת
changedAttributesSinceTimestampיכולה לכלול רק עמודות של מאפיינים (ללא עמודות של מדדים או פילוח), והיא לא פועלת בדוחות גולמיים של אירועים, כמו דוחותconversion. לדוגמה, דוחcampaignעם העמודותdailyBudgetו-campaignStartDateיחזיר שורה לכל קמפיין שהתקציב היומי או תאריך ההתחלה שלו השתנו מאז חותמת הזמן הנתונה.הערה: שינויים במאפייני ההורה לא מתועדים בדוחות שלchangedAttributesSinceTimestamp. לדוגמה, מילת מפתח עשויה לרשת את שיטת הבידינג שלה מקבוצת המודעות שברמה העליונה. גם אם לקבוצת המודעות הוגדרה שיטת בידינג חדשה, יכול להיות שמילת המפתח הזו לא תופיע בדוח. עמודות מאפיינים שהערך שלהן תלוי בישויות ההורה (ולכן עשוי להשתנות בלי שהמערכת תאסוף אותן בדוחות שלchangedAttributesSinceTimestamp), בדרך כלל כוללות את התחילית 'אפקטיבי', למשלeffectiveLabelIdsאוeffectiveBidStartegy.