ใช้ Data Manager API เพื่อส่งเหตุการณ์ที่แนะนําและเหตุการณ์ที่กําหนดเองของ Google Analytics
ดูรายละเอียดได้ที่หัวข้อส่งเหตุการณ์
หากคุณอัปเกรดจาก Measurement Protocol ของ Google Analytics โปรดดูวิธีการใน อัปเกรดจาก Measurement Protocol เป็น Data Manager API
กรณีการใช้งาน
กรณีการใช้งานบางส่วนสําหรับการส่งเหตุการณ์ที่แนะนําและเหตุการณ์ที่กําหนดเองด้วย 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