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

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

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

หากคุณอัปเกรดจาก Measurement Protocol ของ Google Analytics โปรดดูวิธีการที่หัวข้ออัปเกรดจาก 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 คือการเพิ่มประสิทธิภาพการรวบรวมข้อมูลอัตโนมัติผ่าน gtag, Tag Manager และ Google Analytics สำหรับ Firebase ไม่ใช่การแทนที่

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Google Analytics รองรับรีมาร์เก็ตติ้งในอุปกรณ์เดียวกันเมื่อคุณเปิด Google Signals หากต้องการทำรีมาร์เก็ตติ้งข้ามอุปกรณ์ คุณต้องใช้ 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