נתוני הביצועים מתקבלים

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

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

סקירה כללית

  1. מומלץ להפעיל שאילתה כל יום כדי לבדוק את הנתונים ביום אחד לפי אחד מסגנונות השאילתות האלה. הרצת שאילתה יומית על נתונים למשך יום אחד לא תחרוג מהמכסה היומית שלך. בדרך כלל הנתונים זמינים לאחר 2-3 ימים. כדי לראות את הנתונים הזמינים האחרונים, ניתן להריץ שאילתה פשוטה שמקובצת לפי תאריך ב-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, השיטה של ניתוח החיפושים חושפת עד 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
  },
...