التقارير المقسّمة

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. توفّر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات وعمليات إعداد التقارير. اطّلِع على المزيد من المعلومات عن نقل البيانات إلى واجهة Search Ads 360 Reporting API الجديدة واستخدامها.

تعرض Search Ads 360 API بيانات مجمّعة فقط ما لم تطلب بيانات أكثر تفصيلاً وتقسيمًا. على سبيل المثال، يسرد عمود النقرات في تقرير الكلمات الرئيسية إجمالي عدد النقرات على كلمة رئيسية خلال النطاق الزمني الذي تحدّده.

keywordText keywordLandingPage النقرات
بريمجات http://www.example.com 6000

ولكن إذا طلبت تقرير الكلمات الرئيسية الذي يتم تقسيمه على أساس ربع سنوي، سترى صفًا واحدًا لكل كلمة رئيسية في كل ربع سنة، وسيعرض عمود "النقرات" القيم الإجمالية ربع السنوية.

keywordText keywordLandingPage quarterStart quarterEnd النقرات
بريمجات http://www.example.com 2012-01-01 2012-03-31 1,000
بريمجات http://www.example.com 2012-04-01 2012-06-30 1,000
بريمجات http://www.example.com 2012-07-01 2012-09-30 1,000
بريمجات http://www.example.com 2012-10-01 2012-12-31 3,000

تجدر الإشارة إلى أنّ التقرير المقسّم لا يعرض صفًا إلا إذا كانت البيانات متاحة للشريحة. على سبيل المثال، في تقرير الكلمات الرئيسية الذي يتضمّن العمود floodlightActivity، لن يظهر زوج نشاط الكلمة الرئيسية وFloodlight في التقرير إذا لم تكن هناك مقاييس منسوبة إليه خلال النطاق الزمني للتقرير.

بعض الشرائح غير متوافقة مع أعمدة معيّنة

قد تتسبب بعض الشرائح في عرض أعمدة معيّنة لبيانات غير صالحة. على سبيل المثال، يكون التقسيم حسب floodlightActivity مفيدًا فقط في حال تضمين أعمدة تُعِدّ تقارير عن بيانات Floodlight، مثل dfaActions وdfaRevenue وdfaTransactions وdfaWeightedActions. لا تحتوي الأنواع الأخرى من أعمدة الإحالات الناجحة (مثل adWordsConversions) أو الأعمدة التي تسجِّل مقاييس محرّكات البحث (مثل النقرات ومرّات الظهور) على البيانات التي تمّ الإبلاغ عنها من خلال Floodlight، لذا تعرِض قيمًا غير صالحة في حال تقسيم التقرير حسب floodlightActivity.

كيفية طلب تقرير مقسّم

لطلب تقرير مُقسَّم، عليك تضمين عمود يدرج segment كسلوكه في مرجع أنواع التقارير.

الطلب غير المتزامن التالي مخصص لتقرير الكلمات الرئيسية المقسم حسب ربع السنة. سيتضمّن عمود النقرات في كلّ صف إجمالي عدد النقرات في ربع السنة:

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345" // Replace with your IDs
  },
  "reportType": "keyword",

  "columns": [
     { "columnName": "campaignId" },
     { "columnName": "keywordText" },
     { "columnName": "keywordLandingPage" },

     { "columnName": "quarterStart" },
     { "columnName": "quarterEnd" },
     { "columnName": "clicks" },
  ]
  "timeRange" : {
    "startDate" : "2012-01-01",
    "endDate" : "2012-12-31"
  },
  "downloadFormat": "csv",
  "maxRowsPerFile": 5000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
  
ملاحظة: انتبِه إلى التواريخ. إذا كنت تريد إنشاء تقرير ربع سنوي، احرص على أن يتضمّن timeRange للتقرير ربع السنة بأكمله. وإلا ستحصل على نتائج جزئية فقط، ما قد يدفع المستخدمين إلى الاعتقاد بأنّ هناك انخفاضًا كبيرًا في عدد النقرات والأرباح وما إلى ذلك.

طلب شرائح متعددة

يمكنك تضمين أكثر من عمود شريحة في طلبك. لاحظ ما يلي:

  • في حال التقسيم حسب الأسبوع أو الشهر أو ربع السنة، ننصحك بتضمين عمودَي البداية والنهاية في طلبك. على سبيل المثال، في تقرير ربع سنوي، يمكنك تضمين عمودَي quarterStart وquarterEnd. سيؤدي تضمين هذين العمودين إلى عرض تاريخَي البدء والانتهاء للفترة، ما سيساعد في التأكّد من تضمين بيانات لكل فترة كاملة.

  • لا يمكنك تضمين أنواع مختلفة من الشرائح المرتبطة بالوقت في الطلب نفسه. على سبيل المثال، لا يمكنك التقسيم حسب ربع السنة والشهر في الطلب نفسه.

  • يمكن أن يزداد عدد الصفوف بشكل كبير مع كل مقطع إضافي.