ข้อมูลเบื้องต้นเกี่ยวกับการรายงาน Conversion

คู่มือนี้อธิบายวิธีใช้ฟังก์ชันการรายงาน Conversion ใน Google Analytics Data API v1 ฟีเจอร์นี้ช่วยให้คุณสร้างรายงาน ที่มุ่งเน้นเหตุการณ์ Conversion โดยรองรับรูปแบบการระบุแหล่งที่มาต่างๆ รายงาน Conversion ที่สร้างด้วย Data API จะคล้ายกับรายงานการระบุแหล่งที่มา ที่คุณดูได้ในส่วนการโฆษณา > Conversion ของUI ของ Google Analytics ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือเกี่ยวกับรายงานประสิทธิภาพของ Conversion

วัตถุประสงค์ของการรายงาน Conversion

การรายงาน Conversion ช่วยให้คุณวิเคราะห์ประสิทธิภาพของความพยายามทางการตลาดได้โดยการระบุแหล่งที่มาของ Conversion ที่มีการระบุแหล่งที่มา ให้กับแคมเปญ แหล่งที่มา และสื่อที่เฉพาะเจาะจง การรายงาน Conversion จะใช้รูปแบบการระบุแหล่งที่มาเพื่อกระจายเครดิตไปยังทัชพอยต์ที่ทําให้เกิด Conversion ซึ่งแตกต่างจากรายงานตามเหตุการณ์มาตรฐานที่นับเฉพาะเหตุการณ์

รายงาน Conversion กับรายงานตามเหตุการณ์

  • รายงานตามเหตุการณ์: แสดงจํานวนเหตุการณ์ดิบ (เช่น eventCount) และมีประโยชน์ในการทําความเข้าใจกิจกรรมทั่วไปในพร็อพเพอร์ตี้
  • รายงาน Conversion: มุ่งเน้นที่เหตุการณ์ที่ทําเครื่องหมายเป็น Conversion โดยใช้มิติข้อมูลและเมตริกที่เฉพาะเจาะจง (ดูสคีมารายงาน Conversion) และช่วยให้คุณเห็นข้อมูลที่ระบุแหล่งที่มาตามรูปแบบต่างๆ เช่น จากข้อมูลหรือ คลิกสุดท้าย

เปิดใช้รายงาน Conversion

หากต้องการเรียกใช้รายงาน Conversion ให้ใช้วิธีrunReport ระบบจะถือว่าคำขอเป็นรายงาน Conversion หากคำขอค้นหาเมตริก Conversion อย่างน้อย 1 รายการ (เช่น allConversionsByInteractionDate) หรือหากมีการป้อนข้อมูลฟิลด์ conversionSpec ในเนื้อหาของคำขอ

ออบเจ็กต์ conversionSpec มีฟิลด์ต่อไปนี้

  • conversionActions: รายชื่อชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ที่จะรวม ไว้ในรายงาน (เช่น ["conversionActions/12345"]) หากว่างเปล่า ระบบจะรวม Conversion ทั้งหมด คุณดึงรหัสการดำเนินการที่ถูกต้องได้จาก ฟิลด์ conversion_action ภายในรายการ conversions ในการตอบกลับ ของเมธอด GetMetadata
  • attributionModel: รูปแบบการระบุแหล่งที่มาที่จะใช้ ค่าที่รองรับคือ DATA_DRIVEN (ค่าเริ่มต้น) และ LAST_CLICK

สร้างรายงาน Conversion

นี่คือคําขอตัวอย่างที่ใช้เมธอด runReport เพื่อสร้างรายงาน Conversion ที่แสดง Conversion ตามชื่อแคมเปญโดยใช้รูปแบบการระบุแหล่งที่มาโดยอิงตามข้อมูล

HTTP

เปิดใน API Explorer 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

ตัวอย่าง: สร้างรายงานประสิทธิภาพของ Conversion อีกครั้ง

ตัวอย่างนี้แสดงวิธีดึงข้อมูลการกระทําที่ถือเป็น Conversion ที่ใช้ได้สําหรับพร็อพเพอร์ตี้ก่อน แล้วจึงใช้เพื่อสร้างรายงานที่คล้ายกับรายงานประสิทธิภาพของ Conversion ที่แสดงใน UI ของ Google Analytics ในส่วนการโฆษณา > Conversion > ประสิทธิภาพของ Conversion

ขั้นตอนที่ 1: ดึงข้อมูลการกระทำที่ถือเป็น Conversion

เรียกใช้เมธอด getMetadata เพื่อค้นหารหัสการกระทำที่ถือเป็น Conversion ที่ถูกต้องสำหรับพร็อพเพอร์ตี้ โปรดระบุรหัสพร็อพเพอร์ตี้ GA (แทนการใช้ 0 เพื่อรับช่องที่ใช้ร่วมกันสำหรับ พร็อพเพอร์ตี้ทั้งหมด) เพื่อดูการกระทำที่ถือเป็น Conversion ที่สร้างขึ้นสำหรับพร็อพเพอร์ตี้

การตอบกลับมีconversionsรายการที่มี Conversion Actions ที่พร้อมใช้งาน

{
  ...

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

ขั้นตอนที่ 2: เรียกใช้รายงาน

เรียกใช้เมธอด runReport ใช้รหัสการดำเนินการที่พบในขั้นตอนที่ 1 เพื่อกรองรายงาน หรือปล่อยให้conversionActionsว่างไว้เพื่อรายงาน Conversion ทั้งหมด คำขอนี้จะสร้างรายงาน UI ประสิทธิภาพของ Conversion ขึ้นใหม่โดยแสดงการคลิกโฆษณา ต้นทุนโฆษณา ต้นทุนโฆษณา ต่อคลิก ต้นทุนโฆษณาต่อ Conversion ทั้งหมด การแสดงผลโฆษณา ผลตอบแทนจากค่าโฆษณา รายได้ทั้งหมด และ Conversion ทั้งหมดตามกลุ่มช่องทางเริ่มต้น

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

คุณยืนยันได้ว่าระบบถือว่าการตอบกลับเป็นรายงาน Conversion โดย ตรวจสอบว่าฟิลด์ metadata.section ในการตอบกลับตั้งค่าเป็น SECTION_ADVERTISING

ดูรายการมิติข้อมูลและเมตริกทั้งหมดที่ใช้ได้สําหรับรายงาน Conversion ได้ที่สคีมารายงาน Conversion