الحصول على بيانات الأداء

يمكنك إجراء طلبات بحث في بيانات الأداء سريعًا وبدون تجاوز حصتك من خلال تشغيل طلب بحث يومي للحصول على بيانات ليوم واحد.

يجب اختيار المعلومات التي تريدها في بياناتك: أنواع البحث (الويب، صورة، فيديو، وما إلى ذلك) والأبعاد (الصفحة، أو طلب البحث، أو البلد، أو الجهاز)، فضلاً عن إمكانية تجميع النتائج بحسب الصفحة، أو الموقع. عند طلب البحث عن صفحة و/أو سلسلة طلب بحث، قد يتم تجاهل بعض البيانات (إليك السبب).

نظرة عامة

  1. ننصحك بتنفيذ طلب بحث يوميًا بما يعادل بيانات يوم واحد باستخدام أحد أنماط طلبات البحث الموضّحة أدناه. يجب ألا يتجاوز تشغيل طلب بحث يومي ليوم واحد من البيانات حصتك اليومية. تتوفر البيانات عادةً بعد يومين إلى 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

الحدود القصوى للبيانات

بالإضافة إلى حصة استخدام واجهة برمجة التطبيقات، تعرض طريقة إحصاءات البحث 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.

طلب البحث الأول:

احصل على قائمة بأنواع شكل الظهور في البحث على موقعك الإلكتروني.

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