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

เอกสารนี้อธิบายรายการกลุ่มเป้าหมายที่เกิดซ้ำ ซึ่งเป็นฟีเจอร์ขั้นสูงของ 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
}