گزارش های بخش بندی شده

API جدید Search Ads 360 Reporting اکنون در دسترس است. API جدید انعطاف‌پذیری بیشتری برای ایجاد گزارش‌های سفارشی و ادغام داده‌ها در برنامه‌ها و فرآیندهای گزارش‌دهی شما فراهم می‌کند. درباره انتقال و استفاده از Search Ads 360 Reporting API جدید بیشتر بیاموزید.

Search Ads 360 API فقط داده‌های جمع‌آوری شده را برمی‌گرداند، مگر اینکه داده‌های دقیق‌تر و بخش‌بندی شده را درخواست کنید. برای مثال، ستون کلیک‌ها در گزارش کلمه کلیدی ، تعداد کل کلیک‌های روی یک کلمه کلیدی را در بازه زمانی که شما مشخص کرده‌اید، فهرست می‌کند.

کلمه کلیدی متن کلمه کلیدی LandingPage کلیک می کند
ویجت ها http://www.example.com 6000

اما اگر یک گزارش کلمه کلیدی را درخواست کنید که به سه ماه تقسیم شود، برای هر کلمه کلیدی یک ردیف برای هر سه ماهه خواهید دید و ستون کلیک ها مجموع سه ماهه را فهرست می کند.

کلمه کلیدی متن کلمه کلیدی LandingPage یک چهارم شروع پایان سه ماهه کلیک می کند
ویجت ها http://www.example.com 01-01-2012 31/03/2012 1000
ویجت ها http://www.example.com 01/04/2012 30/06/2012 1000
ویجت ها http://www.example.com 01/07/2012 30/09/2012 1000
ویجت ها http://www.example.com 01-10-2012 31-12-2012 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
}
  
توجه : مراقب خرما باشید. اگر درخواست گزارش سه ماهه دارید، مطمئن شوید که محدوده زمانی گزارش شامل کل سه ماهه باشد. در غیر این صورت، فقط نتایج جزئی دریافت خواهید کرد، که ممکن است باعث شود مردم فکر کنند کلیک ها، درآمد و غیره به شدت کاهش یافته است.

درخواست چندین بخش

شما می توانید بیش از یک ستون بخش را در یک درخواست قرار دهید. به موارد زیر توجه کنید:

  • اگر بر اساس هفته، ماه یا سه ماهه تقسیم بندی می کنید، توصیه می کنیم هر دو ستون شروع و پایان را در درخواست خود قرار دهید. به عنوان مثال، در یک گزارش فصلی، هر دو ستون quarterStart و quarterEnd را در نظر بگیرید. گنجاندن هر دوی این ستون‌ها، تاریخ شروع و پایان دوره را نشان می‌دهد، که به تأیید اینکه داده‌های هر دوره کامل را وارد کرده‌اید، کمک می‌کند.

  • شما نمی توانید انواع مختلف بخش های مربوط به زمان را در یک درخواست قرار دهید. به عنوان مثال، شما نمی توانید در یک درخواست واحد بر اساس سه ماهه و ماه تقسیم بندی کنید.

  • تعداد سطرها می تواند با هر بخش اضافی به صورت تصاعدی افزایش یابد.