עמודות שמורות

Search Ads 360 Reporting API החדש זמין עכשיו. ה-API החדש מספק גמישות משופרת ליצירה של דוחות בהתאמה אישית ולשילוב הנתונים באפליקציות הדיווח ותהליכים. מידע נוסף על המעבר לממשק החדש של Search Ads 360 ועל השימוש בו API.

כדי לדווח על פעילויות ב-Floodlight, מטרות עסקיות ב-Google Analytics או אירועים מותאמים אישית מדדי KPI, המפרסמים יכולים להיכנס לממשק משתמש של Search Ads 360 וליצור יותר עמודות שמורות, כמו עמודות פעילות ב-Floodlight, עמודות פעילות ב-Google Analytics, או עמודות של נוסחאות. שלך יכולים לכלול עמודה שמורה בבקשת הדוח, כדי להוריד את הנתונים שלה או כדי לסנן דוח.

אחזור של רשימה של עמודות שמורות

כדי להציג את כל העמודות השמורות שמפרסם יצר, יש לשלוח SavedColumns.list() בקשה. התגובה כוללת את savedColumnName לכל אחת מהעמודות של המפרסם.

בקשת דוחות לעמודות שמורות

כדי לכלול עמודה שמורה בבקשה לדוח, צריך להוסיף עמודה עם המאפיין המאפיין savedColumnName מוגדר לשם העמודה: 

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

כשמשתמשים בעמודות שמורות, חשוב לזכור את הנקודות הבאות:

  • העמודות השמורות מוגדרות ברמת המפרסם. אם אתם כולל עמודה שמורה בבקשה, request.reportScope חייב לציין מפרסם, או רמה נמוכה יותר היקף. לכן כל דוח יכול לכלול עמודות שמורות רק מפרסם יחיד.

  • השמות של העמודות השמורים הם תלויי אותיות רישיות, תלויי רווחים לבנים ו רגיש לפיסוק. המאפיין savedColumnName צריך להיות זהה לשם העמודה השמורה . אם השם של עמודה שמורה זהה לשם של עמודה אחרת באותה בקשה, מערכת Search Ads 360 דורשת לציין headerText ייחודי ואלטרנטיבי באחת מהעמודות או בשתיהן.

  • אפשר לשנות או להסיר עמודות שמורות בניהול הקמפיין ב-Search Ads 360 UI בכל זמן; אם בקשה שמציינת את העמודות השמורות נכשלת, מנסים להסיר את העמודות השמורות מהבקשה ולשלוח אותן שוב.

  • דוחות מצטברים לא יכולים לכלול מדדים שאינם מפורשים שנתמכות על ידי ה-API (לדוגמה, עמודות של פעילות ב-Google Analytics). לחשבון בנוסף, כי משתמשי Search Ads 360 יכולים להגדיר מחדש עמודות שמורות, ייתכן שדוחות שמכילים עמודות שמורות לא יהיו מדויקים.