ข้อมูลเบื้องต้นเกี่ยวกับการรายงาน 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 
{
    "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 ที่ใช้ได้ดังนี้

{
  ...

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

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

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

HTTP

เปิดในโปรแกรมสำรวจ 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"
}

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

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