دریافت داده های عملکرد شما

می‌توانید با اجرای یک درخواست روزانه برای داده‌های یک روزه، داده‌های عملکرد خود را به سرعت و بدون فراتر رفتن از سهمیه خود جستجو کنید.

باید انتخاب کنید که چه اطلاعاتی در داده‌های خود می‌خواهید: کدام نوع جستجو (وب، تصویر، ویدیو، و غیره) و ابعاد (صفحه، درخواست، کشور یا دستگاه)، و همچنین گروه‌بندی نتایج بر اساس صفحه یا ویژگی . هنگام جستجو برای صفحه و/یا رشته پرس و جو، ممکن است برخی از داده ها حذف شوند ( در اینجا دلیل است ).

نمای کلی

1. توصیه می کنیم هر روز یک پرس و جو برای داده های یک روزه با استفاده از یکی از سبک های پرس و جو که در زیر توضیح داده شده است اجرا کنید. اجرای یک درخواست روزانه برای یک روز داده نباید از سهمیه روزانه شما تجاوز کند. داده ها معمولاً پس از 2-3 روز در دسترس هستند. شما می توانید با اجرای یک پرس و جو ساده که بر اساس تاریخ 10 روز گذشته گروه بندی شده است، اطلاعاتی را که اخیراً در دسترس است، بدانید. در نوشتن سوال خود:
   • گروه بندی نتایج بر اساس صفحه یا ویژگی را انتخاب کنید.
   • انتخاب کنید که آیا می‌خواهید تعداد کامل‌تر یا ابعاد بیشتری در درخواست خود داشته باشید. توجه: داده های ظاهری جستجو (AMP، پیوند آبی، نتیجه غنی، و غیره) باید با استفاده از یک فرآیند دو مرحله ای پرس و جو شوند.
2. با اجرای مجدد همان پرس و جو و افزایش مقدار startRow به میزان 25000 در درخواست تا رسیدن به صفحه آخر (پاسخی با 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 هزار ردیف داده در روز را برای هر نوع جستجو (وب، تصویر و غیره - مرتب‌سازی شده بر اساس کلیک) در معرض نمایش می‌گذارد.

جزئیات پرس و جو

می توانید داده های گروه بندی شده بر اساس صفحه یا ویژگی را جستجو کنید.

گروه بندی بر اساس صفحه

برای شمارش دقیق، باید ابعاد صفحه و پرس و جو را حذف کنید، مانند این:

"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
  },
...