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

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

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

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

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

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

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

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