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

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

เอกสารนี้อธิบายรายการกลุ่มเป้าหมายที่เกิดซ้ำ ซึ่งเป็นฟีเจอร์ขั้นสูงของ 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 ดูรายการมิติข้อมูลที่รองรับโดยวิธีการนี้ได้ในเอกสารสคีมาการส่งออกกลุ่มเป้าหมาย เฉพาะข้อมูลของมิติข้อมูลที่กล่าวถึงในช่องนี้เท่านั้นที่จะรวมอยู่ในรายการกลุ่มเป้าหมาย

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

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

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

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

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

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

เช่น

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

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

{
  "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 เมื่อสร้างรายการกลุ่มเป้าหมายตามรอบใหม่

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

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

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

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

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

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