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

يمكنك الاستعلام عن بيانات الأداء بسرعة، وبدون تجاوز حصتك، من خلال تشغيل استعلام يومي لبيانات يوم واحد.

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

نظرة عامة

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