เอกสารนี้อธิบายแนวคิดที่สำคัญเกี่ยวกับการใช้ปลั๊กอิน Google Analytics สำหรับ Unity
ก่อนเริ่มต้น
ก่อนเริ่มดำเนินการ โปรดตรวจสอบว่าคุณได้ดำเนินการตามรายการต่อไปนี้เรียบร้อยแล้ว
- คุณควรมีพร็อพเพอร์ตี้ Google Analytics และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) อย่างน้อย 1 รายการสำหรับส่งข้อมูลจากเกมของคุณ
- หากคุณต้องการติดตามธุรกรรมอีคอมเมิร์ซ ให้เปิดใช้อีคอมเมิร์ซในรายงาน
- ดาวน์โหลด googleanalyticsv3.unitypackage จากที่เก็บปลั๊กอิน Google Analytics สำหรับ Unity แล้วนำเข้าลงในโปรเจ็กต์ Unity (คุณควรทำได้โดยการดับเบิลคลิกไฟล์)
การตั้งค่าและการกำหนดค่า
เลือกแพลตฟอร์มเพื่อดูรายละเอียดการกำหนดค่า ดังนี้
- หากโปรเจ็กต์ยังไม่มีไฟล์ชื่อ AndroidManifest.xml ในไดเรกทอรี <YOUR PROJECT ROOT>/Assets/Plugins/Android/ ให้สร้างโปรเจ็กต์สำหรับ Android จากนั้นคัดลอก AndroidManifest.xml จากไดเรกทอรี Temp/StagingArea/ (ไฟล์จะอยู่ในไดเรกทอรีที่คุณเลือกสร้างไว้) วางลงใน<รูทโปรเจ็กต์>/Assets/Plugins/Android/
- เพิ่มสิทธิ์ต่อไปนี้ลงใน
AndroidManifest.xml ใน <YOUR PROJECT ROOT>
/Assets/Plugins/Android/ เหนือแท็ก
<application>
<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
- หากต้องการเปิดใช้การติดตามแคมเปญ ให้เพิ่มบริการดังนี้
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService" /> <receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true" > <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
-
เพิ่มไลบรารีต่อไปนี้ลงในโปรเจ็กต์ Xcode
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- หากคุณต้องการให้เพิ่มไลบรารีโดยอัตโนมัติเมื่อสร้างสำหรับ iOS ให้คัดลอกไฟล์ PostProcessBuildPlayer_GA จากไดเรกทอรี iOS Extras แล้ววางไว้ในไดเรกทอรี <YOUR PROJECT ROOT>/Assets/Editor
- ดาวน์โหลดสคริปต์ mod_pbxproj.py แล้วคัดลอกลงในไดเรกทอรี Editor ตอนนี้ระบบจะเพิ่มไลบรารีโดยอัตโนมัติระหว่างบิลด์
กําหนดค่าล่วงหน้าสำหรับ GAv3
ต้องทำตามขั้นตอนต่อไปนี้เพื่อกําหนดค่า Prefab ของ GAv3
- คลิกออบเจ็กต์สำเร็จรูป
GAv3.prefab
ซึ่งอยู่ใน Assets/Plugins/GoogleAnalyticsV3 ในมุมมองโปรเจ็กต์ - มุมมองตัวตรวจสอบจะแสดงคอมโพเนนต์สคริปต์ที่แนบอยู่กับสำเร็จรูปที่มีพร็อพเพอร์ตี้หลายรายการ
ป้อนพร็อพเพอร์ตี้เหล่านี้ด้วยค่าที่ถูกต้องสำหรับโปรเจ็กต์ของคุณ การดำเนินการนี้จะป้อนข้อมูลออบเจ็กต์เพื่อให้ใช้ได้ทุกที่ในโปรเจ็กต์ เช่น
Android Property ID: UA-XXXXXXX-1
iOS Property ID: UA-XXXXXXX-2
Other Property ID: UA-XXXXXXX-3
App Name: MyGame
Bundle ID: com.example.games
App Version: 1.0
Dispatch Period: 5
Sample Frequency: 100
Debug Mode: VERBOSE
Anonymize IP: false
Dry Run: false
- ลาก GAv3 ที่มีการป้อนข้อมูลจากมุมมองโปรเจ็กต์ไปไว้ในลำดับชั้นของออบเจ็กต์
ติดตามวัตถุ
หลังจากกำหนดค่าล่วงหน้า GAv3 แล้ว คุณก็พร้อมเริ่มติดตามออบเจ็กต์โดยใช้ Google Analytics โดยทำตามขั้นตอนต่อไปนี้
- ระบุ GameObject ที่คุณต้องการติดตาม (เช่น ออบเจ็กต์ผู้เล่น) และคลิกรายการดังกล่าวในมุมมองลำดับชั้นของออบเจ็กต์ หากยังไม่ได้แนบสคริปต์กับออบเจ็กต์ที่ต้องการติดตาม ให้สร้างสคริปต์ใหม่โดยใช้ปุ่มเพิ่มคอมโพเนนต์ในมุมมองเครื่องมือตรวจสอบ
- สร้างตัวแปรสาธารณะในคลาสเพื่อเก็บออบเจ็กต์ GoogleAnalyticsV3 ตัวอย่างเช่น
public GoogleAnalyticsV3 googleAnalytics;
- บันทึกสคริปต์แล้วกลับไปที่หน้าต่าง Unity
- ในมุมมองเครื่องมือตรวจสอบของ GameObject ที่ต้องการติดตาม คุณจะเห็นสคริปต์ที่สร้างไว้และช่องสำหรับป้อนข้อมูลที่เรียกว่า Google Analytics (หรือชื่อตัวแปรที่คุณเลือก) ลากออบเจ็กต์ GAv3 จากมุมมองลำดับชั้นของออบเจ็กต์ไปยังช่อง
- ตอนนี้คุณพร้อมที่จะเริ่มติดตาม GameObject ดังกล่าวแล้ว ทำกระบวนการนี้ซ้ำสำหรับวัตถุอื่นๆ ที่คุณต้องการติดตามโดยใช้สำเร็จรูปเดียวกัน
ขั้นตอนถัดไป
- ดูข้อมูลอ้างอิง API เพื่อดูประเภท Hit ที่คุณส่งไปยัง Google Analytics ได้
- อ่านคู่มือการใช้งานแอปบนอุปกรณ์เคลื่อนที่เพื่อเรียนรู้วิธีใช้ Google Analytics เพื่อวัดการโต้ตอบของผู้ใช้และตอบคำถามเกี่ยวกับการใช้งานเกม