گزارش در مورد افزونه‌های پیوند سایت Google Ads

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

می‌توانید انواع مختلفی از گزارش‌ها را درخواست کنید که حاوی معیارهایی برای افزونه‌های پیوند سایت Google Ads هستند:

  • یک گزارش adGroup یا campaign تقسیم‌بندی شده که تعداد کلیک‌ها، نمایش‌ها و سایر داده‌ها را برای هر پیوند سایت در یک گروه تبلیغاتی یا کمپین نشان می‌دهد.

  • یک گزارش conversion یا visit که داده‌های خام مربوط به بازدیدها و تبدیل‌های فردی را نشان می‌دهد، از جمله شناسه هر پیوند سایتی که کلیک شده و برای بازدید/تبدیل نسبت داده شده است.

  • گزارش feedItem که معیارها و جزئیات پیکربندی را برای هر پیوند سایت در همه کمپین‌ها و گروه‌های تبلیغاتی که برای آنها اعمال شده است نشان می‌دهد.

یک گزارش گروه تبلیغاتی یا کمپین تقسیم‌بندی شده را درخواست کنید

برای مشاهده تعداد کلیک‌ها، نمایش‌ها و سایر داده‌ها برای هر پیوند سایت در یک گروه تبلیغاتی یا کمپین، یک گزارش adGroup یا campaign درخواست کنید و یکی از ستون‌های تقسیم‌بندی پیوند سایت، مانند sitelinkDisplayText را بگنجانید.

درخواست نمونه

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaign",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "sitelinkDisplayText" },
    { "columnName": "feedItemId" },
    { "columnName": "clicks" },
    { "columnName": "clicksWithFeedItemShowing" },
    { "columnName": "adWordsConversions" }
  ],
  "timeRange" : {
    "startDate" : "2014-07-21",
    "endDate" : "2014-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

گزارش نمونه

در اینجا نمونه‌ای از گزارش campaign در قالب CSV است که توسط sitelinkDisplayText تقسیم‌بندی شده است:

account,campaign,sitelinkDisplayText,feedItemId,clicks,clicksWithFeedItemShowing,adWordsConversions
Hooper's - Google,Accessories,Summer 2014,33700000014504870,10895,12895,1157
Hooper's - Google,Accessories,$30 and Under,33700000014504871,10816,12816,1145
Hooper's - Google,Accessories,Tote Bags,33700000014504872,12790,12790,1147

برای مشاهده داده‌های خام درباره بازدیدها و تبدیل‌های فردی، از جمله شناسه هر پیوند سایتی که کلیک شده و به بازدید/تبدیل نسبت داده شده است، یک گزارش conversion یا visit درخواست کنید و ستون feedItemId را در درخواست قرار دهید.

درخواست نمونه

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "conversion",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "floodlightActivity" },
    { "columnName": "feedType" },
    { "columnName": "feedItemId" }
  ],
  "timeRange" : {
    "startDate" : "2014-07-21",
    "endDate" : "2014-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

گزارش نمونه

در اینجا نمونه ای از گزارش conversion در قالب CSV با برخی از ستون های مورد فید آورده شده است:

account,campaign,floodlightActivity,feedType,feedItemId
Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504870
Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504871
Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504872

برای دریافت اطلاعات بیشتر در مورد پیوندهای سایت در تبدیل‌ها، یک گزارش feedItem درخواست کنید . سپس از feedItemId برای یافتن پیوندهای سایتی که در گزارش تبدیل یا بازدید به آنها اشاره شده است استفاده کنید.

درخواست گزارش feedItem

برای مشاهده معیارها و جزئیات پیکربندی برای هر پیوند سایت در همه کمپین ها و گروه های تبلیغاتی که برای آنها اعمال شده است، یک گزارش feedItem درخواست کنید.

درخواست نمونه

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "feedItem",
  "columns": [
     { "columnName": "feedItemId" },
     { "columnName": "sitelinkDisplayText" },
     { "columnName": "sitelinkDescription1" },
     { "columnName": "sitelinkDescription2" },
     { "columnName": "sitelinkLandingPageUrl" },
     { "columnName": "clicks" },
     { "columnName": "clicksWithFeedItemShowing" },
     { "columnName": "dfaRevenue" }
  ],
  "timeRange" : {
    "startDate" : "2014-07-21",
    "endDate" : "2014-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

گزارش نمونه

در اینجا نمونه ای از گزارش feedItem در قالب CSV آمده است:

feedItemId,sitelinkDisplayText,sitelinkDescription1,sitelinkDescription2,sitelinkLandingPageUrl,clicks,clicksWithFeedItemShowing,dfaRevenue
33700000014504870,Summer 2014,,,http://www.hoopers.com/summer2012,10895,12895,141653.25421900
33700000014504871,$30 and Under,,,http://www.hoopers.com/sortby/lowprice,10816,12816,143600.27534400
33700000014504872,Tote Bags,,,http://www.hoopers.com/tote,12790,12790,140178.19750400