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

يمكنك إجراء طلب بحث عن بيانات الأداء بسرعة وبدون تجاوز حصتك، وذلك عن طريق تنفيذ طلب بحث يومي عن بيانات يوم واحد.

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

نظرة عامة

1. ننصحك بتشغيل طلب بحث كل يوم لبيانات بقيمة يوم واحد باستخدام أحد أنماط طلبات البحث الموضّحة أدناه. إنّ إجراء طلب بحث يومي لبيانات يوم واحد يجب ألا يتجاوز حصتك اليومية. تتوفّر البيانات عادةً بعد يومَين أو 3 أيام، ويمكنك معرفة أحدث البيانات المتاحة من خلال تنفيذ طلب بحث بسيط مجمّع حسب التاريخ لآخر 10 أيام. عند كتابة طلب البحث:
   • اختَر ما إذا كنت تريد تجميع النتائج حسب الصفحة أو الموقع الإلكتروني.
   • اختَر ما إذا كنت تريد أعدادًا أكثر اكتمالاً أو سمات أكثر في طلب البحث. ملاحظة: يجب الاستعلام عن بيانات شكل الظهور في البحث (AMP والرابط الأزرق والنتائج الغنية بصريًا وما إلى ذلك) باستخدام عملية مؤلفة من خطوتين.
2. تصفَّح النتائج من خلال إعادة تنفيذ طلب البحث نفسه، مع زيادة قيمة startRow بمقدار 25,000 في الطلب إلى أن تصل إلى الصفحة الأخيرة (ردّ بدون صفوف).
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، ثم إضافة أي سمات مطلوبة إلى طلب البحث (الصفحة أو البلد أو طلب البحث أو غير ذلك).

لاسترداد بيانات حول أنواع متعددة لشكل الظهور في البحث، يجب تنفيذ الخطوة الثانية مرة واحدة لكل نوع شكل ظهور في البحث مُدرَج في الخطوة 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
  },
...