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

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

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

การตอบกลับจะมีรายการ conversions ที่มีการกระทำที่ถือเป็น Conversion ที่ใช้ได้ดังนี้

{
  ...

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

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

เรียกใช้เมธอด runReport ใช้รหัสการกระทำที่ถือเป็น Conversion ที่พบในขั้นตอนที่ 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