اصول اولیه گزارش تبدیل

این راهنما نحوه استفاده از عملکرد گزارش‌دهی تبدیل را در Google Analytics Data API v1 توضیح می‌دهد. این ویژگی به شما امکان می‌دهد گزارش‌هایی تولید کنید که بر رویدادهای تبدیل متمرکز هستند و از مدل‌های اسنادی مختلف پشتیبانی می‌کنند. گزارش‌های تبدیل ایجادشده با Data API مشابه گزارش‌های اسنادی است که می‌توانید در بخش تبلیغات > تبدیل‌ها در میانای کاربر Google Analytics پیدا کنید. برای اطلاعات بیشتر، مقاله مرکز راهنمایی گزارش عملکرد تبدیل را ببینید.

هدف گزارش‌دهی تبدیل

گزارش‌دهی تبدیل روشی برای تحلیل اثربخشی تلاش‌های بازاریابی شما با نسبت دادن تبدیل‌ها به پویش‌ها، منابع، و رسانه‌های خاص ارائه می‌دهد. برخلاف گزارش‌های استاندارد رویدادمحور که فقط رویدادها را می‌شمارند، گزارش‌دهی تبدیل از مدل اسنادی برای توزیع اعتبار بین نقطه تماس‌هایی که منجر به تبدیل شده‌اند استفاده می‌کند.

تبدیل‌ها درمقابل گزارش‌های رویدادمحور

  • گزارش‌های مبتنی بر رویداد: تعداد خام رویدادها (مثلاً eventCount) را ارائه می‌دهند و برای درک فعالیت کلی در دارایی شما مفید هستند.
  • گزارش‌های تبدیل: بر رویدادهایی تمرکز می‌کند که به‌عنوان تبدیل علامت‌گذاری شده‌اند. این گزارش‌ها از ابعاد و سنجه‌های خاصی استفاده می‌کنند (به طرح‌واره گزارش‌های تبدیل مراجعه کنید) و به شما امکان می‌دهند داده‌های منسوب‌شده را براساس مدل‌هایی مانند «داده‌محور» یا «آخرین کلیک» مشاهده کنید.

فعال کردن گزارش‌های تبدیل

برای اجرای گزارش تبدیل، از روش runReport استفاده کنید. اگر درخواستی یک یا چند سنجه تبدیل (برای مثال، allConversionsByInteractionDate) را پُرسمان کند، یا اگر فیلد conversionSpec در متن درخواست پُر شده باشد، آن درخواست به‌عنوان گزارش تبدیل درنظر گرفته می‌شود.

شیء conversionSpec شامل فیلدهای زیر است:

  • conversionActions: فهرستی از نام‌های منبع کنش تبدیل برای گنجاندن در گزارش (برای مثال، ["conversionActions/12345"]). اگر خالی باشد، همه تبدیل‌ها گنجانده می‌شوند. شناسه‌های معتبر کنش تبدیل را می‌توان از فیلد conversion_action در فهرست conversions در پاسخ روش GetMetadata بازیابی کرد.
  • ‫attributionModel: مدل اسنادی برای استفاده. مقادیر پشتیبانی‌شده عبارت‌اند از DATA_DRIVEN (پیش‌فرض) و LAST_CLICK.

تولید گزارش تبدیل

در اینجا نمونه درخواستی بااستفاده از روش runReport برای تولید گزارش تبدیل ارائه شده است که تبدیل‌ها را براساس نام پویش بااستفاده از مدل اسناد داده‌محور نشان می‌دهد.

HTTP

{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

مثال: بازآفرینی گزارش عملکرد تبدیل

این مثال نشان می‌دهد که چگونه ابتدا کنش‌های تبدیل دردسترس را برای یک دارایی بازیابی کنید و سپس از آن‌ها برای ایجاد گزارشی مشابه گزارش «عملکرد تبدیل» که در میانای کاربر Google Analytics در بخش تبلیغات > تبدیل‌ها > عملکرد تبدیل نشان داده شده است استفاده کنید.

مرحله ۱: بازیابی کنش‌های تبدیل

روش getMetadata را فراخوانی کنید تا شناسه‌های کنش تبدیل معتبر را برای دارایی‌تان پیدا کنید. حتماً شناسه دارایی GA را مشخص کنید (به‌جای استفاده از 0 برای دریافت فیلدهای مشترک برای همه دارایی‌ها) تا بتوانید کنش‌های تبدیل ایجادشده برای دارایی‌تان را ببینید.

پاسخ حاوی فهرست conversions با کنش‌های تبدیل دردسترس است:

{
  ...

  "conversions": [
    {
      "conversionAction": "conversionActions/12345",
      "displayName": "purchase"
    },
    {
      "conversionAction": "conversionActions/67890",
      "displayName": "sign_up"
    }
  ]
}

مرحله ۲: اجرای گزارش

روش runReport را فراخوانی کنید. از شناسه‌های کنش تبدیل که در مرحله ۱ پیدا کردید برای فیلتر کردن گزارش استفاده کنید، یا conversionActions را خالی بگذارید تا همه تبدیل‌ها گزارش شود. این درخواست یک گزارش میانای کاربر عملکرد تبدیل را با نشان دادن کلیک‌های تبلیغاتی، هزینه آگهی، هزینه آگهی به‌ازای هر کلیک، هزینه آگهی به‌ازای همه تبدیل‌ها، ظهورهای آگهی، بازگشت هزینه‌کرد تبلیغات، درآمد کل، و همه تبدیل‌ها براساس گروه کانال پیش‌فرض بازسازی می‌کند.

HTTP

{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "defaultChannelGroup"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByInteractionDate"
        },
        {
            "name": "advertiserAdCost"
        },
        {
            "name": "advertiserAdCostPerAllConversionsByInteractionDate"
        },
        {
            "name": "advertiserAdImpressions"
        },
        {
            "name": "advertiserAdClicks"
        },
        {
            "name": "advertiserAdCostPerClick"
        },
        {
            "name": "totalRevenueByInteractionDate"
        },
        {
            "name": "returnOnAdSpendByInteractionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [
            "conversionActions/12345"
        ],
        "attributionModel": "DATA_DRIVEN"
    }
}

در اینجا یک پاسخ نمونه برای این درخواست آورده شده است:

{
  "dimensionHeaders": [
    {
      "name": "defaultChannelGroup"
    }
  ],
  "metricHeaders": [
    {
      "name": "allConversionsByInteractionDate",
      "type": "TYPE_FLOAT"
    },
    {
      "name": "advertiserAdCost",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "advertiserAdCostPerAllConversionsByInteractionDate",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "advertiserAdImpressions",
      "type": "TYPE_INTEGER"
    },
    {
      "name": "advertiserAdClicks",
      "type": "TYPE_INTEGER"
    },
    {
      "name": "advertiserAdCostPerClick",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "totalRevenueByInteractionDate",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "returnOnAdSpendByInteractionDate",
      "type": "TYPE_FLOAT"
    }
  ],
  "rows": [
    {
      "dimensionValues": [
        {
          "value": "Paid Search"
        }
      ],
      "metricValues": [
        {
          "value": "75.2"
        },
        {
          "value": "500"
        },
        {
          "value": "6.65"
        },
        {
          "value": "10000"
        },
        {
          "value": "500"
        },
        {
          "value": "1"
        },
        {
          "value": "1500"
        },
        {
          "value": "3"
        }
      ]
    }
  ],
  "rowCount": 1,
  "metadata": {
    "schemaRestrictionResponse": {},
    "currencyCode": "USD",
    "timeZone": "America/Los_Angeles",
    "section": "SECTION_ADVERTISING"
  },
  "kind": "analyticsData#runReport"
}

می‌توانید با بررسی اینکه فیلد metadata.section در پاسخ روی SECTION_ADVERTISING تنظیم شده است، تأیید کنید که پاسخ به‌عنوان گزارش تبدیل درنظر گرفته شده است.

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