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