เหตุการณ์ที่แนะนำและเหตุการณ์ที่กำหนดเองของ Google Analytics

ใช้ Data Manager API เพื่อส่งเหตุการณ์ที่แนะนําและ กําหนดเองของ Google Analytics

ส่งเหตุการณ์ที่แนะนําและเหตุการณ์ที่กําหนดเอง

หากคุณอัปเกรดจาก Google Analytics Measurement Protocol โปรดดูวิธีการใน อัปเกรดจาก Measurement Protocol เป็น Data Manager API

ภาพรวมเวิร์กโฟลว์

หากต้องการส่งข้อมูลเหตุการณ์ด้วย Data Manager API ให้ทําตามขั้นตอนต่อไปนี้

  1. เตรียมปลายทาง: กําหนดออบเจ็กต์ Destination สําหรับช่อง destinations ของคําขอการนําเข้าเพื่อระบุบัญชีเป้าหมายและ Conversion หรือปลายทางเหตุการณ์ ดูรายละเอียดได้ที่ เตรียมปลายทางสำหรับ

  2. เตรียมข้อมูลเหตุการณ์และตัวระบุ: ป้อนข้อมูลในช่อง Event ด้วยรายละเอียดเหตุการณ์และ ตัวระบุที่จําเป็น (เช่น ตัวระบุการคลิกโฆษณา ไคลเอ็นต์ หรืออินสแตนซ์ของแอป หากคุณใส่ข้อมูลติดต่อของผู้ใช้ใน userData ให้แปลงตัวระบุเป็นรูปแบบมาตรฐาน และแฮช SHA-256 ตาม หลักเกณฑ์การจัดรูปแบบ และ เข้ารหัสตัวระบุ (ไม่บังคับ) ดูรายละเอียดได้ที่ เตรียมข้อมูลเหตุการณ์

  3. สร้างและส่งคําขอการนําเข้า: ส่ง events.ingest ที่มีบันทึก destinations, Event และ encryptionInfo หากคุณเข้ารหัส userData ใช้ validateOnly: true เพื่อทดสอบเพย์โหลดสําหรับ ข้อผิดพลาดแบบล้มเหลวอย่างรวดเร็ว ก่อนที่จะส่งข้อมูลการใช้งานจริง ดูส่งเหตุการณ์สำหรับ ข้อกําหนดของช่องและตัวอย่างโค้ด

  4. ตรวจสอบการวินิจฉัย: ดึงข้อมูลการวินิจฉัยการประมวลผลแบบไม่พร้อมกัน และตรวจสอบสถานะการนําเข้าด้วย requestStatus.retrieve

กรณีการใช้งาน

ตัวอย่างกรณีการใช้งานสําหรับการส่งเหตุการณ์ที่แนะนําและเหตุการณ์ที่กําหนดเองด้วย Data Manager API มีดังนี้

  • เชื่อมโยงพฤติกรรมออนไลน์กับออฟไลน์

  • วัดการโต้ตอบทั้งฝั่งไคลเอ็นต์และฝั่งเซิร์ฟเวอร์

  • ส่งเหตุการณ์ที่เกิดขึ้นภายนอกการโต้ตอบของผู้ใช้ทั่วไป เช่น Conversion ออฟไลน์

  • ส่งเหตุการณ์จากอุปกรณ์และแอปที่ไม่สามารถทำการเก็บรวบรวมแบบอัตโนมัติได้ เช่น คีออสก์และนาฬิกา

ข้อมูลที่ได้จากผู้ใช้

คุณสามารถส่งข้อมูลลูกค้าบุคคลที่หนึ่ง เช่น อีเมล หมายเลขโทรศัพท์ และที่อยู่จริงที่แฮชแล้ว ในช่อง userData ของ Event ซึ่งจะช่วยปรับปรุงการวัดผล Conversion, การระบุแหล่งที่มา และการสร้างกลุ่มเป้าหมายใน Google Analytics

โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อส่งข้อมูลที่ได้จากผู้ใช้

  • ส่งพร้อมเหตุการณ์: ใน Data Manager API ข้อมูลที่ได้จากผู้ใช้ต้องส่ง เป็นส่วนหนึ่งของ Event ระบบไม่รองรับการอัปโหลดแบบสแตนด์อโลนที่ไม่มีเหตุการณ์

  • การจัดรูปแบบและการแฮช: ตัวระบุส่วนบุคคล (เช่น อีเมล หมายเลขโทรศัพท์ ชื่อ และที่อยู่) ต้องได้รับการแปลงเป็นรูปแบบมาตรฐานและแฮชโดยใช้ SHA-256 ก่อนอัปโหลด ส่วนช่องอื่นๆ (เช่น เมือง รัฐหรือจังหวัด รหัสไปรษณีย์ และรหัสประเทศ) จะได้รับการแปลงเป็นรูปแบบมาตรฐานแต่ไม่แฮช โปรดดูข้อกําหนดเฉพาะใน คู่มือ จัดรูปแบบข้อมูลผู้ใช้

  • การเข้ารหัส: คุณสามารถ เข้ารหัสข้อมูลผู้ใช้ที่แฮชแล้วได้ (ไม่บังคับ)

  • รหัสผู้ใช้: เราขอแนะนำให้ระบุ userId ควบคู่กับ userData ทุกครั้งที่มีตัวระบุผู้ใช้ที่สอดคล้องกัน

  • การติดตั้งใช้งาน: ดูวิธีการสร้างคําขอได้ที่ เพิ่มข้อมูลที่ได้จากผู้ใช้

ข้อควรพิจารณาในการผสานรวม

โปรดคำนึงถึงข้อควรพิจารณาต่อไปนี้เมื่อใช้ Data Manager API

รีมาร์เก็ตติ้ง

Google Analytics รองรับรีมาร์เก็ตติ้งในอุปกรณ์เดียวกันเมื่อคุณเปิด สัญญาณ Google สําหรับ รีมาร์เก็ตติ้งข้ามอุปกรณ์ userId ต้องระบุ

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

ตัวระบุโฆษณา

Google Analytics จะรวมตัวระบุโฆษณา (เช่น GBRAID หรือ WBRAID) ที่รวบรวมระหว่างการโต้ตอบออนไลน์กับเหตุการณ์ Data Manager API โดยอัตโนมัติโดยใช้ clientId หรือ appInstanceId

การตั้งค่าความเป็นส่วนตัว

Google Analytics จะรวมเหตุการณ์ Data Manager API กับการโต้ตอบออนไลน์โดยใช้ clientId หรือ appInstanceId เพื่อใช้การตั้งค่าความเป็นส่วนตัวของผู้ใช้ เช่น "โฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้" และ "จำกัดการติดตามโฆษณา"

นอกจากนี้ คุณยังระบุการตั้งค่าความยินยอมของผู้ใช้ในแต่ละเหตุการณ์ได้โดยตรงโดยใช้ออบเจ็กต์ consent

ข้อมูลทางภูมิศาสตร์และข้อมูลอุปกรณ์

Google Analytics จะรวมข้อมูลทางภูมิศาสตร์และข้อมูลอุปกรณ์ล่าสุดจากการติดแท็กกับเหตุการณ์ Data Manager API โดยอัตโนมัติโดยใช้ clientId หรือ appInstanceId ซึ่งจะช่วยให้เหตุการณ์ Data Manager API ปรากฏในรายงานที่มีมิติข้อมูลทางภูมิศาสตร์และอุปกรณ์

หากต้องการให้เหตุการณ์ Data Manager API แสดงข้อมูลทางภูมิศาสตร์และข้อมูลอุปกรณ์ จากเซสชัน เฉพาะ แทนที่จะเป็นข้อมูลล่าสุดสําหรับ clientId หรือ appInstanceId ให้ใส่รายการใน additionalEventParameters โดยตั้งค่า parameterName เป็น session_id และ value เป็นรหัสของเซสชันที่เฉพาะเจาะจง แล้วส่งเหตุการณ์ภายใน 24 ชั่วโมงนับจากเวลาเริ่มต้นของเซสชัน

คุณสามารถระบุข้อมูลทางภูมิศาสตร์และข้อมูลอุปกรณ์สําหรับเหตุการณ์ โดยใช้ Data Manager API ได้

แบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์อย่างเต็มรูปแบบ

แม้ว่าคุณจะส่งเหตุการณ์ไปยัง Google Analytics ด้วย Data Manager API เพียงอย่างเดียวได้ แต่คุณอาจเห็นรายงานเพียงบางส่วน จุดประสงค์ของ Data Manager API คือการเสริมเหตุการณ์ที่มีอยู่ซึ่งรวบรวมโดยใช้ gtag, Tag Manager หรือ Firebase ชื่อเหตุการณ์และพารามิเตอร์บางชื่อสงวนไว้สําหรับใช้ผ่าน การเก็บรวบรวมอัตโนมัติและไม่สามารถส่งผ่าน Data Manager API ได้

สร้างหรือเปลี่ยนชื่อเหตุการณ์

เหตุการณ์ที่ส่งด้วย Data Manager API จะไม่ทริกเกอร์กฎสําหรับ การสร้างหรือเปลี่ยนชื่อเหตุการณ์ แอปพลิเคชันของคุณควรติดตั้งใช้งานตรรกะเพื่อส่งเหตุการณ์ที่กําหนดเองผ่าน Data Manager API ซึ่งคล้ายกับกฎที่กําหนดค่าไว้ใน UI ของ Google Analytics

ถัดไป
ส่งกิจกรรม