การติดตามเหตุการณ์ด้วยตนเอง
นอกเหนือจากการติดตั้ง, เปิด, อัปเดต, และการซื้อ (การซื้อในแอป) ซึ่งถูกติดตามโดยอัตโนมัติโดย Hive SDK, คุณสามารถติดตามเหตุการณ์ที่จำเป็นที่คุณต้องการด้วยตนเองได้ สำหรับการทำเช่นนี้, คุณต้องลงทะเบียนเหตุการณ์ในแดชบอร์ดของแต่ละการระบุ สำหรับตัวอย่าง, คุณสามารถติดตามเหตุการณ์เฉพาะเช่นการเสร็จสิ้นการสอนเกมของคุณ (TutorialComplete) หรือการเสร็จสิ้นวัตถุประสงค์ของภารกิจ (MissionClear) คุณควรดำเนินการติดตามเหตุการณ์ด้วยตนเองหลังจากเสร็จสิ้นการตั้งค่าการติดตามเหตุการณ์โดยอัตโนมัติ
การติดตามเหตุการณ์ด้วยตนเองด้วย Adjust¶
- เพื่อติดตามเหตุการณ์ที่กำหนดเองด้วยตนเอง ลงทะเบียนเหตุการณ์บนแดชบอร์ด Adjust และรับโทเค็นแอปและโทเค็นเหตุการณ์ โทเค็นแอปสามารถรับได้จากหน้าแรกของแดชบอร์ด และโทเค็นเหตุการณ์จากแดชบอร์ด > การตั้งค่าทั้งหมด > เหตุการณ์ ดูที่ คู่มือแดชบอร์ด Adjust เพื่อเรียนรู้วิธีรับโทเค็น
- เพิ่มโทเค็นแอปและโทเค็นเหตุการณ์ของแต่ละเหตุการณ์ใน hive_config.xml สำหรับรายละเอียดเพิ่มเติม ดูตัวอย่างโค้ดด้านล่าง
-
เพื่อป้องกันการปลอมแปลงแอป แดชบอร์ด Adjust มี SDK Signature ให้บริการ หากต้องการใช้ฟีเจอร์นี้ คุณต้องตรวจสอบรายละเอียดสัญญา Adjust เพื่อใช้ฟีเจอร์นี้ ให้รับคีย์ที่จำเป็นและเพิ่มลงใน hive_config.xml (
secretId
,info1
,info2
,info3
,info4
).<providers> <!-- (ข้ามไป) --> <!-- อย่าตั้งค่าฟิลด์ id ของโหนด Adjust. --> <!-- ฟิลด์ name ของโหนด Adjust ถูกกำหนดให้เป็น "Adjust." --> <!-- ฟิลด์ name ของโหนด event ถูกกำหนดโดยสตูดิโอเกม แต่เมื่อมันถูกตั้งค่าแล้ว มันควรจะเหมือนกันสำหรับฟิลด์ name ของการอ้างอิงการตลาดอื่น ๆ สำหรับคำขอ sendEvent() --> <Adjust name="Adjust" id="unused" key="APP_TOKEN" secretId="1" info1="5432112345" info2="334123" info3="555333" info4="111333"> <events> <event name="TutorialComplete" value="TutorialComplete_EVENT_TOKEN"/> <event name="MissionClear" value="MissionClear_EVENT_TOKEN"/> </events> <!-- (ข้ามไป) --> </Adjust> </providers>
-
เรียกใช้ Analytics API sendEvent() เพื่อส่งเหตุการณ์ ใช้
event name
ใน hive_config.xml เมื่อคุณส่งเหตุการณ์name
จะถูกใช้เป็นพารามิเตอร์คำขอสำหรับ sendEvent() และvalue
ที่คุณตั้งค่าจะแสดงผลบนแดชบอร์ดของแต่ละการกำหนดค่า* `Analytics.sendEvent("TutorialComplete");` * `Analytics.sendEvent("MissionClear");`
การติดตามเหตุการณ์ด้วยตนเองด้วย Airbridge¶
- รับโทเค็นที่จำเป็น สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการรับโทเค็น โปรดดูที่ คู่มือแดชบอร์ด Airbridge.
- รับ App SDK Token และ App Name จากแดชบอร์ด > การตั้งค่า > การจัดการโทเค็น.
- เพิ่มโทเค็น ชื่อแอป และการตั้งค่าเหตุการณ์ลงใน hive_config.xml ตามคำแนะนำด้านล่าง โปรดดูตัวอย่างโค้ดด้านล่าง.
- Airbridge ให้บริการ SDK Signature เพื่อป้องกันการปลอมแปลงแอป คุณต้องตรวจสอบข้อตกลงกับ Airbridge เพื่อใช้ฟังก์ชันที่เกี่ยวข้อง หากต้องการใช้ฟังก์ชันที่เกี่ยวข้อง ให้รับคีย์และเพิ่มลงใน
secretId
และsecret
ใน hive_config.xml สำหรับข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลความปลอดภัยของ SDK signature โปรดดูที่ คู่มือ Airbridge. - ส่งเหตุการณ์โดยการเรียกใช้ Analytics API sendEvent(). เมื่อส่งเหตุการณ์ ให้ใช้ `event name` ที่เพิ่มลงใน hive_config.xml. `name` จะถูกใช้เป็นพารามิเตอร์เมื่อเรียกใช้ API และ `value` สามารถตรวจสอบได้ในแดชบอร์ดของแต่ละการอ้างอิง.
Analytics.sendEvent("TutorialComplete");
Analytics.sendEvent("MissionClear");
การติดตามเหตุการณ์ด้วยตนเองด้วย Singular, Appsflyer, Firebase Analytics¶
- รับคีย์ที่จำเป็นจากแต่ละแดชบอร์ดการระบุอ้างอิง ดูคู่มือจากแต่ละแดชบอร์ดการระบุอ้างอิงเพื่อเรียนรู้วิธีการรับคีย์
- Singular: รับ SDK Key และ SDK SecretKey จากแดชบอร์ด
- Appsflyer: ไปที่การกำหนดค่า AppsFlyer > การตั้งค่าแอปเพื่อรับ Dev key
- Firebase Analytics: ไม่ต้องใช้คีย์
-
กำหนดค่า hive_config.xml ตามคู่มือด้านล่าง สำหรับรายละเอียดเพิ่มเติม ดูตัวอย่างโค้ดด้านล่าง หากคุณใช้การระบุอ้างอิงของ AppsFlyer กับ Hive SDK iOS (Native, Unity, Unreal) คุณต้องตั้งค่า
itunseConnectAppId
สำหรับ Apple AppID.<providers> <!-- กำหนดสำหรับ Singular --> <!-- ฟิลด์ชื่อของโหนด Singular ถูกกำหนดให้เป็น "Singular." --> <!-- ฟิลด์ชื่อของโหนดเหตุการณ์ถูกกำหนดโดยสตูดิโอเกม แต่เมื่อถูกตั้งค่าแล้ว มันควรจะเหมือนกันสำหรับฟิลด์ชื่อของการอ้างอิงการตลาดอื่น ๆ ทั้งหมดสำหรับคำขอ sendEvent() --> <!-- ฟิลด์ค่าของโหนดเหตุการณ์ถูกกำหนดโดยสตูดิโอเกม --> <Singular name="Singular" id="SDK_KEY" key="SDK_SECRET_KEY"> <events> <event name="TutorialComplete" value="Tutorial Complete"/> <event name="MissionClear" value="Mission Clear"/> </events> </Singular> <!-- กำหนดค่าสำหรับ AppsFlyer --> <!-- ฟิลด์ชื่อของโหนด AppsFlyer ถูกตั้งค่าเป็น "AppsFlyer." --> <!-- อย่าตั้งค่าฟิลด์ id ของโหนด AppsFlyer. --> <!-- ฟิลด์ชื่อของโหนดเหตุการณ์ถูกกำหนดโดยสตูดิโอเกม แต่เมื่อมันถูกตั้งค่าแล้ว มันควรจะเหมือนกันสำหรับฟิลด์ชื่อของการอ้างอิงการตลาดอื่น ๆ ทั้งหมดสำหรับคำขอ sendEvent() --> <!-- ฟิลด์ค่าของโหนดเหตุการณ์ถูกกำหนดโดยสตูดิโอเกม. --> <AppsFlyer name="AppsFlyer" id="unused" key="DEV_KEY" itunseConnectAppId="909923112"> <events> <event name="TutorialComplete" value="Tutorial Complete"/> <event name="MissionClear" value="Mission Clear"/> </events> </AppsFlyer> <!-- กำหนดค่าของ Firebase Analytics --> <!-- ฟิลด์ชื่อของโหนดเหตุการณ์ถูกกำหนดโดยสตูดิโอเกม แต่เมื่อมันถูกตั้งค่าแล้ว มันควรจะเหมือนกันสำหรับฟิลด์ชื่อของการอ้างอิงการตลาดอื่น ๆ สำหรับคำขอ sendEvent() --> <!-- ฟิลด์ค่าของโหนดเหตุการณ์ถูกกำหนดโดยสตูดิโอเกม --> <firebase> <events> <event name="TutorialComplete" value="TutorialComplete"/> <event name="MissionClear" value="MissionClear"/> </events> </firebase> </providers>
-
เรียกใช้ Analytics API sendEvent() เพื่อส่งเหตุการณ์ ใช้
event name
ใน hive_config.xml เมื่อคุณส่งเหตุการณ์name
จะถูกใช้เป็นพารามิเตอร์คำขอสำหรับ sendEvent() และvalue
ที่คุณตั้งค่าจะแสดงผลบนแดชบอร์ดของแต่ละการกำหนดค่าAnalytics.sendEvent("TutorialComplete");
Analytics.sendEvent("MissionClear");
ส่งเหตุการณ์ผ่าน sendEvent()¶
แนะนำให้ส่งเหตุการณ์ติดตามไปยังการระบุเฉพาะเมื่อกิจกรรมของผู้ใช้ตรงตามเงื่อนไขที่กำหนด เช่น การทำแบบฝึกหัดให้เสร็จสิ้น เรียกใช้วิธี sendEvent()
ในคลาส Analytics เพื่อส่งเหตุการณ์ติดตาม ในฐานะพารามิเตอร์แรกของ sendEvent()
ให้ป้อนค่าของคุณสมบัติ name
จากองค์ประกอบ <event>
ซึ่งกำหนดไว้ในไฟล์ hive_config.xml
ต่อไปนี้คือตัวอย่างโค้ดที่ส่งเหตุการณ์ TutorialComplete ไปยังการติดตามการตลาดเพื่อแจ้งให้ทราบว่าผู้ใช้ได้ทำการเรียนรู้เสร็จสิ้นแล้ว
API Reference: [hive.Analytics.sendEvent](http://developers.withhive.com/HTML/v4_api_reference_en/Unity3D/group___analytics.html#ga17724d232e1a72e0fd639e3f01e45bd1)
```cs
using hive;
String eventName = "TutorialComplete";
Analytics.sendEvent(eventName);
```
API Reference: [Analytics::sendEvent](http://developers.withhive.com/HTML/v4_api_reference_en/CPP/group___analytics.html#ga1bac3fa81ee5df24ddc8e592b7114c2c)
```cpp
#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace std;
using namespace hive;
string eventName = "TutorialComplete";
Analytics::sendEvent(eventName);
```
API Reference: [Analytics.sendEvent](https://developers.withhive.com/HTML/dokka/-hive%20-s-d-k%20v4/com.hive/index.html)
```kt
import com.hive.Analytics
val eventName = "TutorialComplete"
Analytics.sendEvent(eventName)
```
API Reference: [AnalyticsInterface .sendEvent](https://developers.withhive.com/documentation/hiveservice/analyticsinterface/sendevent(_:))
```java
import HIVEService
let eventName = "TutorialComplete"
AnalyticsInterface.sendEvent(eventName)
```
API Reference: [HIVEAnalytics:sendEvent](http://developers.withhive.com/HTML/v4_api_reference_en/iOS/interface_h_i_v_e_analytics.html#a952cc16b760f8f18709f0cacc715b918)
```objc
#import <HIVEService/HIVEService-Swift.h>
NSString eventName = @"TutorialComplete";
[HIVEAnalytics sendEvent: eventName];
```