ปลั๊กอิน Google Analytics สำหรับ Unity - คู่มือนักพัฒนาซอฟต์แวร์

เอกสารนี้อธิบายแนวคิดที่สำคัญเกี่ยวกับการใช้ปลั๊กอิน Google Analytics สำหรับ Unity

ก่อนเริ่มต้น

ก่อนเริ่มดำเนินการ โปรดตรวจสอบว่าคุณได้ดำเนินการตามรายการต่อไปนี้เรียบร้อยแล้ว

การตั้งค่าและการกำหนดค่า

เลือกแพลตฟอร์มเพื่อดูรายละเอียดการกำหนดค่า ดังนี้

Android
  1. หากโปรเจ็กต์ยังไม่มีไฟล์ชื่อ AndroidManifest.xml ในไดเรกทอรี <YOUR PROJECT ROOT>/Assets/Plugins/Android/ ให้สร้างโปรเจ็กต์สำหรับ Android จากนั้นคัดลอก AndroidManifest.xml จากไดเรกทอรี Temp/StagingArea/ (ไฟล์จะอยู่ในไดเรกทอรีที่คุณเลือกสร้างไว้) วางลงใน<รูทโปรเจ็กต์>/Assets/Plugins/Android/
  2. เพิ่มสิทธิ์ต่อไปนี้ลงใน 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" />
  3. หากต้องการเปิดใช้การติดตามแคมเปญ ให้เพิ่มบริการดังนี้ 
    <service android:name="com.google.android.gms.analytics.CampaignTrackingService" />
<receiver android:name="com.google.android.gms.analytics.CampaignTrackingReceiver"
          android:exported="true" >
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>
iOS
  1. เพิ่มไลบรารีต่อไปนี้ลงในโปรเจ็กต์ Xcode
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. หากคุณต้องการให้เพิ่มไลบรารีโดยอัตโนมัติเมื่อสร้างสำหรับ iOS ให้คัดลอกไฟล์ PostProcessBuildPlayer_GA จากไดเรกทอรี iOS Extras แล้ววางไว้ในไดเรกทอรี <YOUR PROJECT ROOT>/Assets/Editor
  3. ดาวน์โหลดสคริปต์ mod_pbxproj.py แล้วคัดลอกลงในไดเรกทอรี Editor ตอนนี้ระบบจะเพิ่มไลบรารีโดยอัตโนมัติระหว่างบิลด์

กําหนดค่าล่วงหน้าสำหรับ GAv4

วิธีกําหนดค่าล่วงหน้าของ GAv4

  1. คลิกออบเจ็กต์สำเร็จรูป GAv4.prefab ซึ่งอยู่ใน Assets/Plugins/GoogleAnalyticsV4 ในมุมมองโปรเจ็กต์ ลากสิ่งนี้ไปยังลำดับชั้นของเกม
  2. มุมมองตัวตรวจสอบจะแสดงคอมโพเนนต์สคริปต์ที่แนบอยู่กับสำเร็จรูปที่มีพร็อพเพอร์ตี้หลายรายการ ป้อนพร็อพเพอร์ตี้เหล่านี้ด้วยค่าที่ถูกต้องสำหรับโปรเจ็กต์ของคุณ การดำเนินการนี้จะป้อนข้อมูลออบเจ็กต์เพื่อให้ใช้ได้ทุกที่ในโปรเจ็กต์ เช่น
    • Android Tracking Code: UA-XXXXXXX-1
    • iOS Tracking Code: UA-XXXXXXX-2
    • Other Tracking Code: UA-XXXXXXX-3
    • Product Name: MyGame
    • Bundle Identifier: com.example.games
    • Bundle Version: 1.0
    • Dispatch Period: 5
    • Sample Frequency: 100
    • Log Level: VERBOSE
    • Anonymize IP: false
    • Uncaught Exception Reporting: false
    • Send Launch Event: false
    • Session Timeout: 1800
    • Dry Run: false
    • Advertiser Id Support - Send IDFA/AdID: false

ติดตามวัตถุ

หลังจากกำหนดค่าล่วงหน้า GAv4 แล้ว หากต้องการติดตามออบเจ็กต์ด้วย Google Analytics ให้ทำดังนี้

  1. ระบุ GameObject ที่คุณต้องการติดตาม (เช่น ออบเจ็กต์ผู้เล่น) และคลิกรายการดังกล่าวในมุมมองลำดับชั้นของออบเจ็กต์ หากยังไม่ได้แนบสคริปต์กับออบเจ็กต์ที่ต้องการติดตาม ให้สร้างสคริปต์ใหม่โดยใช้ปุ่มเพิ่มคอมโพเนนต์ในมุมมองเครื่องมือตรวจสอบ
  2. สร้างตัวแปรสาธารณะในคลาสเพื่อเก็บออบเจ็กต์ GoogleAnalyticsV4 ตัวอย่างเช่น 
    public GoogleAnalyticsV4 googleAnalytics;
  3. บันทึกสคริปต์แล้วกลับไปที่หน้าต่าง Unity
  4. ในมุมมองเครื่องมือตรวจสอบของ GameObject ที่ต้องการติดตาม คุณจะเห็นสคริปต์ที่สร้างไว้และช่องสำหรับป้อนข้อมูลที่เรียกว่า Google Analytics (หรือชื่อตัวแปรที่คุณเลือก) ลากออบเจ็กต์ GAv4 จากมุมมองลำดับชั้นของออบเจ็กต์ไปยังช่อง
  5. ตอนนี้คุณพร้อมที่จะเริ่มติดตาม GameObject ดังกล่าวแล้ว ทำกระบวนการนี้ซ้ำสำหรับวัตถุอื่นๆ ที่คุณต้องการติดตามโดยใช้สำเร็จรูปเดียวกัน

ขั้นตอนถัดไป

แหล่งข้อมูล