สร้างการส่งออกกลุ่มเป้าหมาย

กลุ่มเป้าหมายใน Google Analytics ช่วยให้คุณแบ่งกลุ่มผู้ใช้ในรูปแบบที่มีความสำคัญต่อธุรกิจ กลุ่มเป้าหมายช่วยให้คุณจัดกลุ่มผู้ใช้เว็บไซต์หรือแอปพลิเคชันตามแอตทริบิวต์ที่แชร์ได้

คุณสามารถส่งออกกลุ่มเป้าหมาย รวมถึงภาพรวมของผู้ใช้ โดยใช้ Data API

โปรดดูข้อมูลสำคัญเกี่ยวกับข้อมูลที่คุณเห็นในการส่งออกกลุ่มเป้าหมายจากคู่มือสิ่งที่คาดหวังเกี่ยวกับข้อมูลการส่งออกกลุ่มเป้าหมาย

ภาพรวม

ส่งคําขอ Data API ต่อไปนี้เพื่อสร้างและค้นหาการส่งออกกลุ่มเป้าหมาย

1. เรียกใช้เมธอด audienceExports.create เพื่อสร้างการส่งออกกลุ่มเป้าหมาย
2. ใช้การเรียกใช้เมธอด audienceExports.query เพื่อดึงข้อมูลผู้ใช้ในกลุ่มเป้าหมาย

หากต้องการข้อมูลเพิ่มเติม ให้เรียกใช้ audienceExports.get เพื่อเรียกข้อมูลเมตาการกําหนดค่าเกี่ยวกับการส่งออกกลุ่มเป้าหมายที่เฉพาะเจาะจง และเรียกใช้ audienceExports.list เพื่อแสดงรายการการส่งออกกลุ่มเป้าหมายทั้งหมดสําหรับพร็อพเพอร์ตี้ที่เฉพาะเจาะจง

เลือกเอนทิตีการรายงาน

เมธอด Data API ทั้งหมดกำหนดให้ต้องระบุตัวระบุพร็อพเพอร์ตี้ Google Analytics ในเส้นทางคำขอ URL ในรูปแบบ properties/GA_PROPERTY_ID เช่น

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

ระบบจะสร้างรายงานตามข้อมูลเหตุการณ์ Google Analytics ที่รวบรวมในพร็อพเพอร์ตี้ Google Analytics ที่ระบุ

หากคุณใช้ไลบรารีไคลเอ็นต์ Data API รายการใดรายการหนึ่ง ก็ไม่จำเป็นต้องเปลี่ยนเส้นทาง URL คำขอ ไคลเอ็นต์ API ส่วนใหญ่ระบุproperty พารามิเตอร์ที่คาดหวังสตริงในรูปแบบ properties/GA_PROPERTY_ID ดูตัวอย่างการใช้ไลบรารีไคลเอ็นต์ได้ในคู่มือเริ่มใช้งานฉบับย่อ

สร้างการส่งออกกลุ่มเป้าหมาย

หากต้องการสร้างการส่งออกกลุ่มเป้าหมาย ให้เรียกใช้เมธอด audienceExports.create โดยใช้ออบเจ็กต์ AudienceExport ในคําขอ พารามิเตอร์ต่อไปนี้เป็นพารามิเตอร์ที่ต้องระบุ

• ชื่อกลุ่มเป้าหมายที่ถูกต้องในช่อง audience โดยจัดรูปแบบเป็น properties/{propertyId}/audiences/{audienceId} คุณใช้เมธอด audiences.list ของ Google Analytics Admin API v1 เพื่อรับค่านี้ได้ ฟิลด์ Audience.name ของการตอบกลับ audiences.list มีชื่อกลุ่มเป้าหมาย
• รายการมิติข้อมูลที่ถูกต้องในช่อง dimensions ดูรายการมิติข้อมูลที่รองรับโดยวิธีการนี้ได้ในเอกสารสคีมาการส่งออกกลุ่มเป้าหมาย เฉพาะข้อมูลของมิติข้อมูลที่กล่าวถึงในช่องนี้เท่านั้นที่จะรวมอยู่ในการนําส่งกลุ่มเป้าหมาย

ต่อไปนี้คือตัวอย่างคําขอสร้างการส่งออกกลุ่มเป้าหมาย

คำขอ HTTP

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

การตอบกลับของเมธอด audienceExports.create มีชื่อการส่งออกกลุ่มเป้าหมายในช่อง name เช่น properties/1234567/audienceExports/123 ตัวอย่างการตอบกลับมีดังนี้

การตอบสนองของ HTTP

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "CREATING",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  }
}

คุณสามารถใช้ name เพื่อค้นหาผู้ใช้จากการส่งออกกลุ่มเป้าหมาย

ค้นหาสถานะความพร้อมของการส่งออกกลุ่มเป้าหมาย

ระบบอาจใช้เวลาหลายนาทีในการสร้างการส่งออกกลุ่มเป้าหมายหลังจากaudienceExports.create การเรียกใช้

คุณสามารถตรวจสอบสถานะความพร้อมของการส่งออกกลุ่มเป้าหมายได้โดยเรียกใช้เมธอด audienceExports.get

ใช้ชื่อการส่งออกกลุ่มเป้าหมายจากการตอบกลับ audienceExports.create เพื่อระบุการส่งออกกลุ่มเป้าหมายในคําขอ

ตัวอย่างคําขอมีดังนี้

คำขอ HTTP

GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123

ระบบจะแสดงสถานะความพร้อมสําหรับการส่งออกกลุ่มเป้าหมายในช่อง state ของคําตอบ เมื่อสร้างกลุ่มเป้าหมายที่จะส่งออกเสร็จแล้ว สถานะของกลุ่มเป้าหมายจะเปลี่ยนจาก CREATING เป็น ACTIVE

ตัวอย่างคำตอบมีดังนี้

การตอบสนองของ HTTP

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

คุณสามารถดูสถานะการส่งออกกลุ่มเป้าหมายทั้งหมดได้โดยเรียกใช้เมธอด audienceExports.list

ดึงข้อมูลผู้ใช้จากการส่งออกกลุ่มเป้าหมาย

เมื่อสร้างการส่งออกกลุ่มเป้าหมายแล้ว ให้เรียกใช้เมธอด audienceExports.query และระบุ name ของการส่งออกกลุ่มเป้าหมายในคําขอ

ตัวอย่างคําขอมีดังนี้

คำขอ HTTP

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

หากการส่งออกกลุ่มเป้าหมายพร้อมแล้ว การเรียกใช้นี้จะแสดงรายการผู้ใช้ในกลุ่มเป้าหมาย

ตัวอย่างการตอบกลับมีดังนี้

การตอบสนองของ HTTP

{
  "audienceExport": {
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "ACTIVE",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  },
  "audienceRows": [
    {
      "dimensionValues": [
        {
          "value": "1000276123.1681742376"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000374452.1668627377"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000391956.1652750758"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000410539.1682018694"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000703969.1666725875"
        }
      ]
    }
  ],
  "rowCount": 5
}