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

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

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

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

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

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

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

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

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

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

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

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

HTTP

باز کردن در API Explorer 
{
    "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

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

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