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

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

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

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

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

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

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

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

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

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

گزارش تبدیل ایجاد کنید

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

اچ‌تی‌پی

باز کردن در کاوشگر API 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

مثال: گزارش عملکرد تبدیل را دوباره ایجاد کنید

این مثال نشان می‌دهد که چگونه ابتدا اقدامات تبدیل موجود برای یک ویژگی را بازیابی کنیم و سپس از آنها برای ایجاد گزارشی مشابه گزارش عملکرد تبدیل که در رابط کاربری گوگل آنالیتیکس در مسیر تبلیغات > تبدیل‌ها > عملکرد تبدیل نشان داده شده است، استفاده کنیم.

مرحله ۱: بازیابی اقدامات تبدیل

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

پاسخ شامل یک لیست conversions با اقدامات تبدیل موجود است:

{
  ...

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

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

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

اچ‌تی‌پی

باز کردن در کاوشگر API 
{
    "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 تنظیم شده است، تأیید کنید که پاسخ به عنوان یک گزارش تبدیل در نظر گرفته شده است.

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