รายการกลุ่มเป้าหมายที่เกิดซ้ำ

เอกสารนี้อธิบายเกี่ยวกับรายการกลุ่มเป้าหมายที่เกิดซ้ำ ซึ่งเป็นฟีเจอร์ขั้นสูงของ Google Analytics Data API v1 หากต้องการดูข้อมูลเบื้องต้นเกี่ยวกับฟีเจอร์การส่งออกรายการกลุ่มเป้าหมาย โปรดดูคู่มือข้อมูลเบื้องต้นเกี่ยวกับการส่งออกกลุ่มเป้าหมาย

รายการกลุ่มเป้าหมายที่เกิดซ้ำจะสร้างรายการกลุ่มเป้าหมายทุกวันเมื่อมีการเปลี่ยนแปลงการเป็นสมาชิกกลุ่มเป้าหมาย เพื่อให้คุณใช้ข้อมูลล่าสุดได้

รายการกลุ่มเป้าหมายทั่วไป (ที่ไม่เกิดซ้ำ) คือรายการผู้ใช้แบบคงที่ในกลุ่มเป้าหมาย ณ เวลาที่สร้างรายการ

สร้างรายการกลุ่มเป้าหมายใหม่ทุกวัน

ระบบจะใช้เวลาในการประมวลผลข้อมูลกลุ่มเป้าหมายของ 1 วันและอัปเดตการเป็นสมาชิกแตกต่างกันไป จึงไม่มีวิธีใดที่จะรับประกันได้ว่าข้อมูลรายการกลุ่มเป้าหมายจะได้รับการอัปเดตภายใน 24 ชั่วโมง

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

รายการกลุ่มเป้าหมายจะอิงตามข้อมูลเหตุการณ์จาก 1 วันก่อนการเปลี่ยนแปลงการเป็นสมาชิกล่าสุด หากคุณสร้างรายการกลุ่มเป้าหมายก่อนที่จะมีการอัปเดตการเป็นสมาชิกรายวัน ระบบจะใช้ข้อมูลจาก 2 วันก่อน หากคุณสร้างรายการกลุ่มเป้าหมายหลังจากการอัปเดตการเป็นสมาชิกรายวัน ระบบจะใช้ข้อมูลจากเมื่อวาน

สำรวจรายการกลุ่มเป้าหมายที่เกิดซ้ำเป็นระยะ

รายการกลุ่มเป้าหมายที่เกิดซ้ำจะสร้างรายการกลุ่มเป้าหมายก็ต่อเมื่อมีข้อมูลเพิ่มเติมของวันนั้นๆ ซึ่งจะช่วยให้คุณไม่ต้องคาดเดาว่าจะสร้างรายการกลุ่มเป้าหมายใหม่เมื่อใด แต่คุณสามารถสำรวจรายการกลุ่มเป้าหมายที่เกิดซ้ำตลอดทั้งวันเพื่อดูว่ามีข้อมูลเพิ่มเติมหรือไม่

สร้างรายการกลุ่มเป้าหมายที่เกิดซ้ำ

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

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

ตัวอย่างคำขอสร้างรายการกลุ่มเป้าหมายที่เกิดซ้ำ

คำขอ HTTP

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

การตอบกลับของเมธอด recurringAudienceLists.create จะมีชื่อในช่อง name (เช่น properties/1234567/recurringAudienceLists/123) ซึ่งสามารถใช้ในการค้นหาในภายหลังเพื่อดึงข้อมูลเมตาของการกำหนดค่าสำหรับรายการกลุ่มเป้าหมายที่เกิดซ้ำนี้ นอกจากนี้ ข้อมูลเมตาของการกำหนดค่ายังมี ชื่อทรัพยากรสำหรับอินสแตนซ์รายการกลุ่มเป้าหมาย ที่สร้างขึ้นสำหรับรายการกลุ่มเป้าหมายที่เกิดซ้ำนี้ด้วย

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

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

สำรวจข้อมูลเมตาของการกำหนดค่า

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

ตัวอย่าง

คำขอ HTTP

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123

ระบบจะแสดงผลอินสแตนซ์ของ RecurringAudienceList ในการตอบกลับ ซึ่งจะมีข้อมูลเมตาของการกำหนดค่า ซึ่งรวมถึง ชื่อทรัพยากรสำหรับอินสแตนซ์รายการกลุ่มเป้าหมาย ที่สร้างขึ้นสำหรับรายการกลุ่มเป้าหมายที่เกิดซ้ำนี้

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

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

คุณสามารถใช้ recurringAudienceLists.list เพื่อแสดงรายการกลุ่มเป้าหมายที่เกิดซ้ำทั้งหมดสำหรับพร็อพเพอร์ตี้

ใช้ Webhook เพื่อรับการแจ้งเตือนแบบไม่พร้อมกันเกี่ยวกับรายการกลุ่มเป้าหมายใหม่

แทนที่จะสำรวจข้อมูลเมตาของการกำหนดค่าเกี่ยวกับรายการกลุ่มเป้าหมายที่เกิดซ้ำที่เฉพาะเจาะจง เป็นระยะๆ โดยใช้เมธอด recurringAudienceLists.get คุณสามารถรับการแจ้งเตือน Webhook แบบไม่พร้อมกันเมื่อรายการกลุ่มเป้าหมาย พร้อมใช้งาน

หากต้องการกำหนดค่าการแจ้งเตือน Webhook ให้ระบุช่อง webhookNotification เมื่อสร้างรายการกลุ่มเป้าหมายที่เกิดซ้ำใหม่

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Webhook ใน Google Analytics Data API v1 ได้ในคู่มือ Async audience lists with webhooks

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

หากต้องการดึงข้อมูลผู้ใช้ในการส่งออกกลุ่มเป้าหมาย ให้เรียกใช้เมธอด audienceExports.query และระบุชื่อการส่งออกกลุ่มเป้าหมาย ที่ดึงข้อมูลจากข้อมูลเมตาของการกำหนดค่าที่ได้รับจาก recurringAudienceLists.get หรือ recurringAudienceLists.list

คำขอ 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
}