חשוב לדעת: נפסיק את השימוש בשיטות get ו-getByCustomerId ב-Search Ads 360 Conversion API ברבעון השלישי של 2025. כדי להמשיך לגשת לנתוני ההמרות, צריך ליצור דוח באמצעות משאב ההמרות באמצעות Search Ads 360 Reporting API החדש. כאן מופיעים פרטים נוספים.
במקום לקבל קובץ dump של כל הנתונים בכל פעם שתבקש דוח, תוכל לבקש מדי פעם רק את הנתונים שהשתנו מאז הדוח האחרון שלך. סביר להניח
שהדוחות המצטברים האלה יהיו קטנים משמעותית מהדוח המלא.
אם אתם מבקשים דוחות מצטברים, עליכם להביא בחשבון את הפרטים הבאים:
עדיין מומלץ לבקש דוח מלא מדי פעם, למקרה
לאיבוד חלק מהשינויים המצטברים. לדוגמה, אם מבקשים דוחות מצטברים שבועיים במהלך ינואר, בסוף פברואר צריך לבקש דוח מלא
עבור ינואר כדי להבטיח שכל הנתונים של ינואר יגיעו.
בגלל שלא תמיד אפשר לקבוע אם ישויות מסוימות השתנו, דוח מצטבר יכלול את הישות אם מערכת Search Ads 360 אפילו תחשד שהישות השתנתה. פירוש הדבר הוא שדוחות מצטברים עשויים להכיל נתונים
שלא השתנו.
המדדים של בקשות שהשתנו מאז חותמת הזמן שצוינה. המדדים מאוחסנים ברמת פירוט יומית ועשויים להשתנות במשך יום אחד, אבל לא ביום אחר, ולכן צריך לפלח את הבקשות האלה לפי יום (חובה לציין את העמודה date). לדוגמה, דוח keyword עם העמודות clicks, actions ו-date יחזיר שורה לכל מילת מפתח ותאריך שבו המספר המתועד של קליקים או פעולות השתנה מאז חותמת הזמן הנתונה.
חותמת הזמן חייבת להיות לכל היותר 8 ימים לפני מועד הבקשה. כדי לתעד
את כל המדדים המשתנים, עליך לשלוח בקשת changedMetricsSinceTimestamp
לפחות פעם ב-7 ימים, ולהפיק דוח מלא לגבי כל תאריך
לאחר הסדרת המדדים (עדיף להמתין לפחות 7 ימים). דפוס לדוגמה
הוא יצירת שני דוחות בכל יום: דוח מצטבר למדדים שהשתנו ב-36 השעות האחרונות, ודוח מלא
למדדים שהתרחשו לפני 8 ימים.
changedAttributesSinceTimestamp=timestamp
מאפייני הבקשות שהשתנו מאז חותמת הזמן הנתונה. בקשת
changedAttributesSinceTimestamp יכולה לכלול רק עמודות של מאפיינים (ללא עמודות של מדדים או פילוח), והיא לא פועלת בדוחות גולמיים של אירועים, כמו
דוחות conversion. לדוגמה, דוח campaign עם העמודות dailyBudget
ו-campaignStartDate יחזיר שורה לכל קמפיין
שהתקציב היומי או תאריך ההתחלה שלו השתנו מאז חותמת הזמן הנתונה.
הערה: שינויים במאפייני ההורה לא מתועדים
בדוחות של changedAttributesSinceTimestamp. לדוגמה, מילת מפתח עשויה לרשת את שיטת הבידינג שלה מקבוצת המודעות שברמה העליונה.
גם אם לקבוצת המודעות הוגדרה שיטת בידינג חדשה, יכול להיות שמילת המפתח הזו לא תופיע בדוח. עמודות מאפיינים שהערך שלהן תלוי
בישויות ההורה (ולכן עשוי להשתנות בלי שהמערכת תאסוף אותן
בדוחות של changedAttributesSinceTimestamp), בדרך כלל
כוללות את התחילית 'אפקטיבי', למשל effectiveLabelIds או effectiveBidStartegy.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2023-12-14 (שעון UTC)."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports allow you to retrieve only the data that has changed since your last request, making reports smaller and more efficient.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to periodically request full reports in addition to incremental reports to ensure all data is captured.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports can be requested based on either changed metrics or changed attributes using specific time range properties.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003echangedAttributesSinceTimestamp\u003c/code\u003e requests provide efficient updates for attributes, changes to parent attributes might not be reflected, necessitating awareness of potential data discrepancies.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows users to build custom reports and integrate data into their applications. It offers incremental reports, which retrieve only data that has changed since the last request, reducing report size. Users can request changes in metrics (`changedMetricsSinceTimestamp`) or attributes (`changedAttributesSinceTimestamp`). Full reports are still recommended periodically to ensure no data is missed. For `changedMetricsSinceTimestamp`, data must be segmented by day and should be requested every seven days. Changed attributes only report changes to the attribute itself, not inherited changes from parent.\n"],null,[]]
