เอกสารนี้อธิบายรายการกลุ่มเป้าหมายที่เกิดซ้ำ ซึ่งเป็นฟีเจอร์ขั้นสูงของ 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 ให้ระบุช่อง webhookNotification เมื่อสร้างรายการกลุ่มเป้าหมายที่เกิดซ้ำใหม่
ทำตามคำแนะนำ Async audience lists with webhooks เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้เว็บฮุคใน 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
}