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

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن توفر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات إعداد التقارير والعمليات. مزيد من المعلومات عن نقل البيانات إلى التجربة الجديدة من "إعلانات شبكة البحث 360" واستخدامها 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 1000
بريمجات http://www.example.com 2012-04-01 2012-06-30 1000
بريمجات http://www.example.com 2012-07-01 2012-09-30 1000
بريمجات http://www.example.com 2012-10-01 2012-12-31 3000

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

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

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