Thông tin cơ bản về tính năng báo cáo lượt chuyển đổi

Hướng dẫn này giải thích cách sử dụng chức năng báo cáo lượt chuyển đổi trong Google Analytics Data API v1. Tính năng này cho phép bạn tạo báo cáo tập trung vào các sự kiện chuyển đổi có hỗ trợ nhiều mô hình phân bổ. Báo cáo lượt chuyển đổi được tạo bằng Data API tương tự như báo cáo phân bổ mà bạn có thể tìm thấy trong mục Quảng cáo > Lượt chuyển đổi của giao diện người dùng Google Analytics. Để biết thêm thông tin, hãy xem bài viết trong trung tâm trợ giúp về Báo cáo hiệu suất lượt chuyển đổi.

Mục đích của tính năng báo cáo lượt chuyển đổi

Tính năng báo cáo lượt chuyển đổi cung cấp một cách để phân tích hiệu quả của nỗ lực tiếp thị bằng cách phân bổ lượt chuyển đổi cho các chiến dịch, nguồn và phương tiện cụ thể. Không giống như các báo cáo tiêu chuẩn dựa trên sự kiện chỉ tính số sự kiện, tính năng báo cáo lượt chuyển đổi áp dụng một mô hình phân bổ để phân phối giá trị đóng góp giữa các điểm tiếp xúc dẫn đến một lượt chuyển đổi.

Lượt chuyển đổi so với báo cáo dựa trên sự kiện

  • Báo cáo dựa trên sự kiện: Cung cấp số lượng sự kiện thô (ví dụ: eventCount) và hữu ích để hiểu hoạt động chung trên tài sản của bạn.
  • Báo cáo lượt chuyển đổi: Tập trung vào các sự kiện đã được đánh dấu là lượt chuyển đổi. Các báo cáo này sử dụng các phương diện và chỉ số cụ thể (xem Lược đồ báo cáo lượt chuyển đổi) và cho phép bạn xem dữ liệu được phân bổ dựa trên các mô hình như Dựa trên dữ liệu hoặc Lượt nhấp cuối cùng.

Bật báo cáo lượt chuyển đổi

Để chạy báo cáo lượt chuyển đổi, hãy sử dụng runReport phương thức. Một yêu cầu được coi là báo cáo lượt chuyển đổi nếu yêu cầu đó truy vấn một hoặc nhiều chỉ số lượt chuyển đổi (ví dụ: allConversionsByInteractionDate) hoặc nếu trường conversionSpec được điền trong nội dung yêu cầu.

Đối tượng conversionSpec chứa các trường sau:

  • conversionActions: Danh sách tên tài nguyên hành động chuyển đổi cần đưa vào báo cáo (ví dụ: ["conversionActions/12345"]). Nếu để trống, tất cả lượt chuyển đổi sẽ được đưa vào. Bạn có thể truy xuất các mã nhận dạng hành động chuyển đổi hợp lệ từ trường conversion_action trong danh sách conversions trong phản hồi của phương thức GetMetadata.
  • attributionModel: Mô hình phân bổ cần sử dụng. Các giá trị được hỗ trợ là DATA_DRIVEN (mặc định) và LAST_CLICK.

Tạo báo cáo lượt chuyển đổi

Sau đây là yêu cầu mẫu sử dụng phương thức runReport để tạo báo cáo lượt chuyển đổi cho biết lượt chuyển đổi theo tên chiến dịch bằng mô hình phân bổ Dựa trên dữ liệu.

HTTP

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

Ví dụ: Tạo lại báo cáo hiệu suất lượt chuyển đổi

Ví dụ này minh hoạ cách truy xuất các hành động chuyển đổi hiện có cho một tài sản, sau đó sử dụng các hành động đó để tạo báo cáo tương tự như báo cáo Hiệu suất lượt chuyển đổi trong giao diện người dùng Google Analytics trong mục Quảng cáo > Lượt chuyển đổi > Hiệu suất lượt chuyển đổi.

Bước 1: Truy xuất hành động chuyển đổi

Gọi getMetadata phương thức để tìm các mã nhận dạng hành động chuyển đổi hợp lệ cho tài sản của bạn. Hãy nhớ chỉ định mã nhận dạng tài sản GA (thay vì sử dụng 0 để nhận các trường chung cho tất cả tài sản) để xem các hành động chuyển đổi được tạo cho tài sản của bạn.

Phản hồi chứa danh sách conversions với các hành động chuyển đổi hiện có:

{
  ...

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

Bước 2: Chạy báo cáo

Gọi phương thức runReport. Sử dụng các mã nhận dạng hành động chuyển đổi tìm thấy ở Bước 1 để lọc báo cáo hoặc để trống conversionActions để báo cáo tất cả lượt chuyển đổi. Yêu cầu này tạo lại báo cáo Hiệu suất lượt chuyển đổi trên giao diện người dùng bằng cách hiển thị số lượt nhấp vào quảng cáo, chi phí quảng cáo, chi phí quảng cáo mỗi lượt nhấp, chi phí quảng cáo mỗi lượt chuyển đổi, số lượt hiển thị quảng cáo, lợi tức trên chi tiêu quảng cáo, tổng doanh thu và tất cả lượt chuyển đổi theo nhóm kênh mặc định.

HTTP

Mở trong 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"
    }
}

Sau đây là phản hồi mẫu cho yêu cầu này:

{
  "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"
}

Bạn có thể xác minh rằng phản hồi được coi là báo cáo lượt chuyển đổi bằng cách kiểm tra xem trường metadata.section trong phản hồi có được đặt thành SECTION_ADVERTISING hay không.

Để biết danh sách đầy đủ các phương diện và chỉ số hiện có cho báo cáo lượt chuyển đổi, hãy tham khảo Lược đồ báo cáo lượt chuyển đổi.