המערכת מאחזרת את נתוני הביצועים

אפשר להריץ שאילתות על נתוני הביצועים במהירות, מבלי לחרוג מהמכסה, לפי הרצת שאילתה יומית על נתונים של יום אחד.

עליכם לבחור איזה מידע תרצו לכלול בנתונים: אילו סוגי חיפוש (אינטרנט, תמונה, וידאו וכו') ואילו מאפיינים (דף, שאילתה, מדינה או מכשיר), וגם האם קיבוץ תוצאות לפי דף או לנכס. כששולחים שאילתה לגבי דף ו/או מחרוזת שאילתה, יכול להיות שחלק מהנתונים יושמטו (זו הסיבה לכך).

סקירה כללית

1. מומלץ להריץ שאילתה מדי יום לגבי נתונים של יום אחד, באמצעות אחת מהאפשרויות הסגנונות שמתוארים בהמשך. הפעלת שאילתה יומית לנתונים של יום אחד לא אמורה לחרוג מהמכסה היומית. בדרך כלל הנתונים זמינים לאחר יומיים עד שלושה ימים. כדי לבדוק מהם הנתונים הזמינים האחרונים, אפשר להריץ שאילתה פשוטה שמקובצת לפי תאריך מ-10 הימים האחרונים. לכתיבת השאילתה שלך:
   • בוחרים אם לקבץ את התוצאות לפי דף או לפי נכס.
   • בוחרים אם רוצים ספירה מלאה יותר או יותר מאפיינים בשאילתה. הערה: צריך לשלוח שאילתה לגבי נתונים של מראה החיפוש (AMP, קישור כחול, תוצאת חיפוש מתקדמת וכן הלאה) באמצעות תהליך דו-שלבי.
2. כדי לעבור בין הדפים של התוצאות, מריצים מחדש את אותה שאילתה ומגדילים את הערך של startRow ב-25,000 בבקשה עד שמגיעים לדף האחרון (תגובה עם 0 שורות).
3. אפשר גם להריץ את אותה שאילתה עם פרמטר type אחר.

הנה דוגמה לקוד מדומה לשאילתה יחידה. אפשר להריץ את הפונקציה הזו פעם ביום לכל ערך type שרוצים לקבל נתונים לגביו.

int maxRows = 25000; // Current max response size
int i = 0;
do {
  response = Request(startDate = 3_days_ago,
                     endDate = 3_days_ago,
                     ... add dimensions, type ...
                     rowLimit = maxRows,
                     startRow = i * maxRows);
  i++;
  …  // Do something with the response data.
} while (response.rows.count() != 0); // Page through all result rows

מגבלות נתונים

בנוסף למכסה לשימוש ב-API, השיטה של Search Analytics חושפת עד 50,000 שורות של נתונים ליום לכל סוג חיפוש (אינטרנט, תמונה וכו' – ממוינים לפי קליקים).

פרטי השאילתה

אפשר לשלוח שאילתות לגבי נתונים שמקובצים לפי דף או לפי נכס.

קיבוץ לפי דף

כדי לקבל ספירות מדויקות, צריך להשמיט את המאפיינים 'דף' ו'שאילתה', באופן הבא:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"

• startDate / endDate: בוחרים חלון של יום אחד על ידי בחירה של אותו התאריך.
• dimensions: אופציונלי: אפשר לכלול את country או device.
• type: אפשר למנות את כל ערך type לפי הצורך בשאילתה נפרדת.
• aggregationType: חייב להיות byPage.

כדי לקבל פרטים רבים יותר, כולל מידע על הדף ו/או השאילתה, על חשבון אובדן נתונים מסוימים, אפשר להריץ שאילתה כזאת:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"

• startDate / endDate: כדי לבחור חלון של יום אחד, בוחרים את אותו תאריך.
• dimensions: הכללה של page. אפשר לכלול כל שילוב של query, country או device.
• type: אפשר למנות את כל ערך type לפי הצורך בשאילתה נפרדת.

קיבוץ לפי נכס

כדי לקבל ספירות מדויקות, צריך להשמיט את המאפיינים 'דף' ו'שאילתה', באופן הבא:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"

• startDate / endDate: בוחרים באותו תאריך כדי לבחור חלון של יום אחד.
• dimensions: אפשר לכלול את country ו/או את device.
• type: אפשר גם למנות את כל ערך type לפי הצורך בשאילתה נפרדת.

כדי לקבל פרטים נוספים, כולל מידע על השאילתה, המדינה או המכשיר, תוך אובדן של חלק מהנתונים, מריצים שאילתה כמו זו:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"

• startDate / endDate: כדי לבחור חלון של יום אחד, בוחרים את אותו תאריך.
• dimensions: אופציונלי: אפשר לכלול כל שילוב של query, country או device.
• type: אפשר למנות את כל ערך type לפי הצורך בשאילתה נפרדת.

קיבוץ תוצאות לפי דף או נכס

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

למה הנתונים נעלמים כשמבקשים פרטים נוספים?

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

אחזור נתונים של מראה החיפוש

מראה החיפוש לא זמין כעמודה יחד עם מאפיינים אחרים. לכן, אם אתם רוצים לראות מידע על המראה של האתר בחיפוש, עליכם לפעול לפי התהליך הבא:

1. מציינים את searchAppearance כמאפיין היחיד, וכך כל הנתונים יקובצו לפי סוג מראה החיפוש ללא מאפיינים אחרים.
2. אפשר להריץ שאילתה שנייה, לסנן לפי אחד מסוגי המראה בחיפוש שמפורטים בשלב 1 ולהוסיף לשאילתה את המאפיינים הרצויים (דף, מדינה, שאילתה וכו').

כדי לאחזר נתונים לגבי כמה סוגים של מראה חיפוש, צריך להריץ את השלב השני פעם אחת לכל סוג מראה החיפוש שמופיע בשלב 1.

שאילתה ראשונה:

קבלת רשימה של סוגי מראה החיפוש באתר.

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "searchAppearance"
  ]
}

תוצאות:

באתר שלכם יש סוגים כמו INSTANT_APP,‏ AMP_BLUE_LINK וכן הלאה.

 "rows": [
  {
   "keys": [
    "INSTANT_APP"
   ],
   "clicks": 443024.0,
   "impressions": 4109826.0,
   "ctr": 0.10779629113251997,
   "position": 1.088168452873674
  },
  {
   "keys": [
    "AMP_BLUE_LINK"
   ],
   "clicks": 429887.0,
   "impressions": 1.7090884E7,
   "ctr": 0.025152999692701676,
   "position": 7.313451603790653
  },...

השאילתה השנייה:

מסננים לפי אחד מסוגי מראה החיפוש שמופיעים בשלב 1, יחד עם המאפיינים הרצויים (דף, מכשיר וכו'). כאן אנחנו מסננים לפי AMP_BLUE_LINK.

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "device" // and/or page, country, ...
  ],
  "dimensionFilterGroups": [
    {
      "filters": [
        {
          "dimension": "searchAppearance",
          "operator": "equals",
          "expression": "AMP_BLUE_LINK"
        }
      ]
    }
  ]
}

תוצאות:

פירוט של AMP_BLUE_LINK לפי סוגי מכשירים.

"rows": [
  {
   "keys": [
    "MOBILE"
   ],
   "clicks": 429887.0,
   "impressions": 1.7090783E7,
   "ctr": 0.025153148337323107,
   "position": 7.31339517914422
  },
  {
   "keys": [
    "DESKTOP"
   ],
   "clicks": 0.0,
   "impressions": 66.0,
   "ctr": 0.0,
   "position": 12.257575757575758
  },
...