คู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับผู้ชมรีมาร์เก็ตติ้ง

เอกสารนี้จะอธิบายวิธีใช้ Management API เพื่อจัดการกลุ่มเป้าหมายรีมาร์เก็ตติ้งของ Google Analytics

เกริ่นนำ

Management API ช่วยให้คุณเข้าถึงกลุ่มเป้าหมายรีมาร์เก็ตติ้งcreate, get, delete, list, update และ patch สำหรับพร็อพเพอร์ตี้ Google Analytics ได้ หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของกลุ่มเป้าหมายรีมาร์เก็ตติ้ง โปรดดูบทความเกี่ยวกับกลุ่มเป้าหมายรีมาร์เก็ตติ้งใน Analytics ในศูนย์ช่วยเหลือ

Use Case

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

แสดงรายการกลุ่มเป้าหมายรีมาร์เก็ตติ้ง

วิธีแสดงกลุ่มเป้าหมายรีมาร์เก็ตติ้งทั้งหมดสําหรับพร็อพเพอร์ตี้หนึ่งๆ

  1. ใช้ Management API หรือโปรแกรมสำรวจบัญชีเพื่อเรียกดู accountId และ webPropertyId
  2. ใช้เมธอด list ของทรัพยากรกลุ่มเป้าหมายรีมาร์เก็ตติ้ง

โปรดดูข้อมูลอ้างอิง API สำหรับรายละเอียดของเมธอด list สำหรับทรัพยากรกลุ่มเป้าหมายรีมาร์เก็ตติ้ง

สร้างกลุ่มเป้าหมายรีมาร์เก็ตติ้งใหม่

วิธีสร้างผู้ชมรีมาร์เก็ตติ้งใหม่สำหรับพร็อพเพอร์ตี้

  1. ใช้ Management API หรือโปรแกรมสำรวจบัญชี เพื่อเรียกข้อมูล accountId และ webPropertyId
  2. ใช้ Management API หรือโปรแกรมสํารวจบัญชีเพื่อดึงรหัสข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) สําหรับพร็อพเพอร์ตี้ linkedViews []
  3. ใช้คอลเล็กชันลิงก์ Google Ads เพื่อดึงข้อมูลรหัสบัญชี Google Ads สําหรับ linkedAdAccounts.linkedAccountId
    • ปัจจุบันพร็อพเพอร์ตี้ linkedAdAccounts[] จำกัดอยู่ที่ linkedForeignAccount เพียงรายการเดียวเท่านั้น
    • ตั้งค่า linkedAdAccounts[].type เป็น ADWORDS_LINKS, DBM_LINKS, MCC_LINKS หรือ OPTIMIZE ได้
  4. ใช้คอลเล็กชันกลุ่มเพื่อดูตัวเลือกในการตั้งค่าพร็อพเพอร์ตี้ segment ของ includeConditions และในกรณีที่การสร้างกลุ่มเป้าหมายตามสถานะทำเช่นเดียวกันสำหรับ excludeConditions นอกจากนี้ โปรดดูข้อมูลอ้างอิงกลุ่มสำหรับการกำหนดกลุ่ม
    • includeConditions อาจมีค่าสำหรับ membershipDurationDays และ daysToLookBack หรือไม่ก็ได้
    • สามารถตั้งค่า excludeConditions.exclusionDuration เป็น PERMANENT ได้ (ไม่บังคับ)
  5. ใช้เมธอด insert ของทรัพยากรกลุ่มเป้าหมายรีมาร์เก็ตติ้ง

API ช่วยให้คุณสร้างกลุ่มเป้าหมายได้ 2 ประเภท ได้แก่ SIMPLE และ STATE_BASED สำหรับกลุ่มเป้าหมาย SIMPLE คุณต้องสร้าง audienceDefinition ที่มี segment เป็นบวกเท่านั้น โดยไม่ต้องมีโอเปอเรเตอร์ NOT (อักขระ !) หากคุณต้องการรวมเงื่อนไขยกเว้น คุณต้องกำหนด statebasedDefinition โปรดดูกลุ่มเป้าหมายตามสถานะเพื่อดูข้อมูลเพิ่มเติม ดูรายละเอียดในตัวอย่างข้อมูลอ้างอิง

อัปเดตกลุ่มเป้าหมายรีมาร์เก็ตติ้งที่มีอยู่

วิธีอัปเดตผู้ชมรีมาร์เก็ตติ้งที่มีอยู่สำหรับพร็อพเพอร์ตี้

  1. หากมีรหัสกลุ่มเป้าหมายรีมาร์เก็ตติ้งอยู่แล้ว ก็สามารถเรียกใช้ get หรือโทรหา list แล้วเลือกกลุ่มเป้าหมายที่ต้องการอัปเดต
  2. อัปเดตช่องที่เขียนได้และเรียกใช้การส่ง update ในออบเจ็กต์กลุ่มเป้าหมายที่อัปเดตแล้ว