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

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

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

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

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

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

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

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

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

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

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

หากต้องการสร้างรายการผู้ชมที่เกิดซ้ำ ให้เรียกใช้ 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 เพื่อแสดงรายการกลุ่มเป้าหมายที่เกิดซ้ำทั้งหมดของพร็อพเพอร์ตี้

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

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

หากต้องการกำหนดค่าการแจ้งเตือนเว็บฮุค ให้ระบุ webhookNotification ขณะสร้างรายการผู้ชมที่เกิดซ้ำ

ทำตามคำแนะนำของ Async audience lists with webhooks เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้เว็บฮุคใน Google Analytics Data API เวอร์ชัน 1

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

ในการเรียกผู้ใช้ในการส่งออกกลุ่มเป้าหมาย ให้เรียกเมธอด 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
}