การติดตามเหตุการณ์ด้วยตนเอง
นอกจากการติดตั้ง, เปิด, อัปเดต, และการซื้อ (การซื้อภายในแอป) ซึ่งถูกติดตามโดยอัตโนมัติโดย Hive SDK คุณสามารถติดตามเหตุการณ์ที่จำเป็นที่คุณต้องการได้ด้วยตนเอง เพื่อทำเช่นนี้ คุณต้องลงทะเบียนเหตุการณ์ไปยังแดชบอร์ดของแต่ละการอ้างอิง ตัวอย่างเช่น คุณสามารถติดตามเหตุการณ์เฉพาะเช่นการเสร็จสิ้นการสอนเกมของคุณ (TutorialComplete) หรือการเสร็จสิ้นวัตถุประสงค์ของภารกิจ (MissionClear) คุณควรดำเนินการติดตามเหตุการณ์ด้วยตนเองหลังจากเสร็จสิ้นการตั้งค่าการติดตามเหตุการณ์อัตโนมัติ
การติดตามเหตุการณ์ด้วยตนเองด้วย Adjust¶
- เพื่อติดตามเหตุการณ์ที่กำหนดเองด้วยตนเอง ให้ลงทะเบียนเหตุการณ์ในแดชบอร์ด Adjust และรับโทเค็นแอปและโทเค็นเหตุการณ์ โทเค็นแอปสามารถรับได้จากหน้าแรกของแดชบอร์ด และโทเค็นเหตุการณ์จากแดชบอร์ด > การตั้งค่าทั้งหมด > เหตุการณ์ ดู คู่มือแดชบอร์ด Adjust เพื่อเรียนรู้วิธีการรับโทเค็น
- เพิ่มโทเค็นแอปและโทเค็นเหตุการณ์ของแต่ละเหตุการณ์ใน hive_config.xml สำหรับรายละเอียดเพิ่มเติม ดูตัวอย่างโค้ดด้านล่าง
-
แดชบอร์ด Adjust มี SDK Signature V3 เพื่อป้องกันการปลอมแปลงแอป เพื่อใช้ SDK Signature คุณต้องตรวจสอบเงื่อนไขสัญญากับ Adjust.
<providers> <!-- (skipped) --> <!-- อย่าตั้งค่าฟิลด์ id ของโหนด Adjust. --> <!-- ฟิลด์ name ของโหนด Adjust ถูกกำหนดให้เป็น "Adjust." --> <!-- ฟิลด์ name ของโหนด event ถูกกำหนดโดยสตูดิโอเกม แต่เมื่อมันถูกตั้งค่าแล้ว มันควรจะเหมือนกันสำหรับฟิลด์ name ของการอ้างอิงการตลาดอื่น ๆ สำหรับคำขอ sendEvent() --> <!-- ตั้งแต่ Hive SDK v4 25.0.0, id, secretId, info1~4 จะไม่ถูกใช้ตั้งแต่การประยุกต์ใช้ Adjust v5 --> <Adjust name="Adjust" key="APP_TOKEN"> <events> <event name="TutorialComplete" value="TutorialComplete_EVENT_TOKEN"/> <event name="MissionClear" value="MissionClear_EVENT_TOKEN"/> </events> <!-- (skipped) --> </Adjust> </providers>
-
ส่งเหตุการณ์โดยเรียกใช้ Analytics API sendEvent() เมื่อส่งเหตุการณ์ ให้ใช้แท็ก
<event>
ที่เพิ่มเข้าไปใน hive_config.xml ในค่าของแท็ก<event>
name
จะถูกใช้เป็นพารามิเตอร์เมื่อเรียกใช้ API และvalue
สามารถตรวจสอบได้ในแดชบอร์ดของการระบุที่เกี่ยวข้องAnalytics.sendEvent("TutorialComplete");
Analytics.sendEvent("MissionClear");
การติดตามเหตุการณ์ด้วยตนเองด้วย Airbridge¶
- รับโทเค็นที่จำเป็น สำหรับข้อมูลเกี่ยวกับวิธีการรับโทเค็น โปรดดูที่ คู่มือแดชบอร์ด Airbridge.
- รับโทเค็น SDK ของแอปและชื่อแอปจากแดชบอร์ด > การตั้งค่า > การจัดการโทเค็น.
- เพิ่มโทเค็น ชื่อแอป และการตั้งค่าเหตุการณ์ลงใน hive_config.xml โปรดดูที่ ตัวอย่างโค้ด hive_config.xml ด้านล่าง ใน Windows การตั้งค่าโทเค็นและชื่อแอปไม่จำเป็น แต่การตั้งค่าคอนโซล Hive เป็นสิ่งที่จำเป็น.
- Airbridge มี ลายเซ็น SDK เพื่อป้องกันการปลอมแปลงแอป สำหรับการใช้ฟังก์ชันที่เกี่ยวข้อง คุณต้องตรวจสอบเงื่อนไขสัญญากับ Airbridge ก่อน รับคีย์และเพิ่มเป็น
secretId
และsecret
ใน hive_config.xml. สำหรับข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลความปลอดภัยของลายเซ็น SDK โปรดดูที่ คู่มือ Airbridge. รองรับเฉพาะบน Android และ iOS ไม่รองรับบน Windows. - หากคุณกำลังใช้ Windows, Android และ iOS ร่วมกัน ติดต่อ Airbridge สำหรับการตั้งค่าล่วงหน้า.
- ส่งเหตุการณ์โดยเรียกใช้ API การวิเคราะห์ sendEvent(). เมื่อส่งเหตุการณ์ ให้ใช้แท็ก
<event>
ที่เพิ่มลงใน hive_config.xml ในค่าของแท็ก<event>
name
จะถูกใช้เป็นพารามิเตอร์เมื่อเรียก API และvalue
สามารถตรวจสอบได้ในแดชบอร์ดของการอ้างอิงที่เกี่ยวข้อง.Analytics.sendEvent("TutorialComplete");
Analytics.sendEvent("MissionClear");
hive_config.xml ตัวอย่างโค้ด¶
<providers>
<Airbridge name="Airbridge" key="APP_SDK_TOKEN" appName="APP_NAME" secretId="SECRET_ID" secret="SECRET">
<events>
<event name="TutorialComplete" value="Tutorial Complete" />
<event name="MissionClear" value="Mission Clear" />
</events>
</Airbridge>
</providers>
ติดตามเหตุการณ์ด้วยตนเองด้วย Singular, Appsflyer และ Firebase Analytics¶
ส่วนนี้อธิบายวิธีการติดตามเหตุการณ์ด้วยตนเองโดยใช้ Singular, Appsflyer และ Firebase Analytics attribution.
- คุณจะได้รับคีย์ที่จำเป็นจากแดชบอร์ดของแต่ละการแจกแจงตามที่แสดงด้านล่าง โปรดดูคู่มือแดชบอร์ดที่แต่ละการแจกแจงจัดเตรียมไว้สำหรับวิธีการออกคีย์
- Singular: รับ SDK Key และ SDK SecretKey จากแดชบอร์ด
- Appsflyer: รับ Dev Key จากแดชบอร์ด > การตั้งค่าแอป
- Firebase Analytics: ไม่จำเป็นต้องออกคีย์
- แก้ไขไฟล์ hive_config.xml ตามตัวอย่างด้านล่างนี้. โดยเฉพาะอย่างยิ่ง เมื่อใช้ Appsflyer Attribution ใน Hive SDK Native iOS หรือ Unity Android & iOS และ Unreal Engine Android & iOS จะต้องตั้งค่า
itunseConnectAppId
สำหรับการตั้งค่า Apple AppID<providers> <!-- ตั้งค่า Singular --> <!-- ฟิลด์ name ของโหนด Singular ต้องเป็นค่าคงที่ "Singular" --> <!-- ฟิลด์ name ของโหนด event ถูกตั้งค่าโดยบริษัทเกมเอง อย่างไรก็ตาม ต้องใช้ค่าที่เหมือนกันในแอตทริบิวชันอื่น ๆ เพื่อเรียกใช้ sendEvent() --> <!-- ฟิลด์ value ของโหนด event ถูกตั้งค่าโดยบริษัทเกมเอง --> <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 ไม่ต้องตั้งค่า --> <!-- ฟิลด์ชื่อของโหนด event ตั้งค่าโดยผู้พัฒนาเกมตามต้องการ อย่างไรก็ตาม ต้องใช้ค่าที่เหมือนกันในแอตทริบิวชันอื่นเพื่อเรียกใช้ sendEvent() --> <!-- ฟิลด์ค่าของโหนด event ตั้งค่าโดยผู้พัฒนาเกมตามต้องการ --> <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 --> <!-- ฟิลด์ name ของโหนด event ถูกตั้งค่าโดยผู้พัฒนาเกมตามต้องการ อย่างไรก็ตาม ต้องใช้ค่าที่เหมือนกันในแอตทริบิวชันอื่นเพื่อเรียกใช้ sendEvent() --> <!-- ฟิลด์ value ของโหนด event ถูกตั้งค่าโดยผู้พัฒนาเกมตามต้องการ --> <firebase> <events> <event name="TutorialComplete" value="TutorialComplete" /> <event name="MissionClear" value="MissionClear" /> </events> </firebase> </providers>
- เรียกใช้ Analytics API sendEvent() เพื่อส่งเหตุการณ์ เมื่อส่งเหตุการณ์ ให้ใช้ค่าของแท็ก hive_config.xml ที่เพิ่มเข้าไปใน
<event>
เป็นพารามิเตอร์ในการส่งเหตุการณ์ ค่าของแท็ก<event>
ที่ใช้name
จะถูกใช้เป็นพารามิเตอร์ในขณะเรียก API และvalue
สามารถตรวจสอบได้ในแดชบอร์ดของแอตทริบิวชันนั้นAnalytics.sendEvent("TutorialComplete");
Analytics.sendEvent("MissionClear");
sendEvent()ส่งอีเวนต์¶
อธิบายวิธีการส่งอีเวนต์เพื่อติดตามพฤติกรรมของผู้ใช้ในแอททริบิวชัน
เมื่อส่งเหตุการณ์ติดตามในการให้เครดิต แนะนำให้ส่งเมื่อพฤติกรรมของผู้ใช้ตรงตามเงื่อนไขเฉพาะ เช่น 'เสร็จสิ้นการสอน' แทนที่จะติดตามพฤติกรรมทั้งหมดของผู้ใช้
เพื่อส่งเหตุการณ์ติดตามพฤติกรรมผู้ใช้ ให้เรียกใช้ฟังก์ชัน Analytics API sendEvent()
ค่าอาร์กิวเมนต์แรกของฟังก์ชัน sendEvent()
จะต้องป้อนเป็นค่าของแอตทริบิวต์ name
ขององค์ประกอบ <event>
ที่กำหนดในไฟล์การตั้งค่า hive_config.xml
เมื่อผู้ใช้ทำการเสร็จสิ้นการสอน ตัวอย่างโค้ดที่จะส่งเหตุการณ์ TutorialComplete ไปยังการติดตามการตลาดมีดังนี้
API Reference: hive.Analytics.sendEvent
API Reference: Analytics::sendEvent
API Reference: Analytics.sendEvent
API Reference: AnalyticsInterface .sendEvent
API Reference: HIVEAnalytics:sendEvent
API Reference: AnalyticsInterface.sendEvent
ส่งอีเวนต์พร้อมแอตทริบิวต์เพิ่มเติมด้วย sendEventWithAttributes()¶
เมื่อเรียกใช้ฟังก์ชัน sendEventWithAttributes()
แทนที่จะเป็น sendEvent()
คุณสามารถส่งแอตทริบิวต์ที่ผู้ใช้กำหนดได้
sendEventWithAttributes()
ฟังก์ชันพารามิเตอร์แรกคือค่าที่ป้อนจากคุณสมบัติ name
ขององค์ประกอบ <event>
ที่กำหนดในไฟล์การตั้งค่า hive_config.xml
เพิ่มแอตทริบิวต์ที่กำหนดเอง¶
คุณสามารถเรียกใช้ addCustomAttribute()
เพื่อเพิ่มแอตทริบิวต์ที่กำหนดเองไปยังการติดตามการตลาดทั้งหมดที่สนับสนุนโดย Hive SDK (Airbridge, Adjust, Appsflyer, Singular, Firebase Analytics) และส่งข้อมูลเหล่านั้นได้
Note
Custom Attribute คือคุณสมบัติที่ผู้ใช้กำหนดซึ่งรองรับรูปแบบข้อมูล String, Int, Float, Double, Boolean อย่างไรก็ตาม เมื่อส่งไปยัง Adjust รูปแบบข้อมูลทั้งหมดจะถูกแปลงเป็น String ก่อนส่ง
ตัวอย่างโค้ดในการส่งข้อมูลโดยเพิ่มแอตทริบิวต์แบบกำหนดเองมีดังนี้
API Reference: hive.Analytics.sendEventWithAttributes
using hive;
// สร้าง AnalyticsAttributes
var analyticsAttributes = new AnalyticsAttributes();
// เพิ่มคุณสมบัติที่กำหนดเอง
analyticsAttributes.AddCustomAttribute("key1", "value1");
analyticsAttributes.AddCustomAttribute("key2", "value2");
Analytics.sendEventWithAttributes("Quest Complete", analyticsAttributes);
#include "HiveAnalytics.h"
// สร้าง AnalyticsAttributes
FHiveAnalyticsAttributes AnalyticsAttributes;
// เพิ่มคุณสมบัติที่กำหนดเอง
TSharedPtr<FJsonValue> CustomJsonValue1 = MakeShareable(new FJsonValueString("value1"));
AnalyticsAttributes.AddCustomAttribute(TEXT("key1"), CustomJsonValue1);
TSharedPtr<FJsonValue> CustomJsonValue2 = MakeShareable(new FJsonValueString("value2"));
AnalyticsAttributes.AddCustomAttribute(TEXT("key2"), CustomJsonValue2);
FHiveAnalytics::SendEventWithAttributes(strEventName, AnalyticsAttributes);
API Reference: Analytics::sendEventWithAttributes
#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace std;
using namespace hive;
// สร้าง AnalyticsAttributes
AnalyticsAttributes analyticsAttributes;
// เพิ่มคุณสมบัติที่กำหนดเอง
analyticsAttributes.addCustomAttribute("key1", picojson::value("value1"));
analyticsAttributes.addCustomAttribute("key2", picojson::value("value2"));
std::string eventName = "Quest Complete";
Analytics::sendEventWithAttributes(eventName, analyticsAttributes);
API Reference: Analytics.sendEventWithAttributes
import com.hive.Analytics;
import com.hive.analytics.provider.attributes.AirbridgeSpecific;
import com.hive.analytics.provider.attributes.AnalyticsAttributes;
// สร้าง AnalyticsAttributes
val analyticsAttributes = AnalyticsAttributes()
// เพิ่มคุณสมบัติที่กำหนดเอง
analyticsAttributes.addCustomAttribute("key1", "value1")
analyticsAttributes.addCustomAttribute("key2", "value2")
Analytics.sendEventWithAttributes("Quest Complete", analyticsAttributes)
API Reference: Analytics.sendEventWithAttributes
import com.hive.Analytics;
import com.hive.analytics.provider.attributes.AirbridgeSpecific;
import com.hive.analytics.provider.attributes.AnalyticsAttributes;
// สร้าง AnalyticsAttributes
AnalyticsAttributes analyticsAttributes = new AnalyticsAttributes();
// เพิ่มคุณสมบัติที่กำหนดเอง
analyticsAttributes.addCustomAttribute("key1", "value1");
analyticsAttributes.addCustomAttribute("key2", "value2");
Analytics.sendEventWithAttributes("Quest Complete", analyticsAttributes);
API Reference: HIVEAnalytics:sendEventWithAttributes
#import <HIVEService/HIVEService-Swift.h>
HiveAnalyticsAttributes* analyticsAttributes = [[HiveAnalyticsAttributes alloc] init];
[analyticsAttributes addModuleSpecificAttribute: airbridgeSpecific];
[analyticsAttributes addCustomAttribute: @"key1" value: @"value1"];
[analyticsAttributes addCustomAttribute: @"key2" value: @"value2"];
[HIVEAnalytics sendEventWithAttributes: @"Quest Complete" attributes: analyticsAttributes];
API Reference: HIVEAnalytics:sendEventWithAttributes
import HIVEService
// สร้าง AnalyticsAttributes
let analyticsAttributes = AnalyticsAttributes()
// เพิ่มคุณสมบัติที่กำหนดเอง
analyticsAttributes.addCustomAttribute("key1", value: "value1")
analyticsAttributes.addCustomAttribute("key2", value: "value2")
AnalyticsInterface.sendEventWithAttributes("Quest Complete", attributes: analyticsAttributes)
ส่งข้อมูลแอตทริบิวต์เชิงความหมายไปยัง Airbridge¶
เมื่อส่งแอตทริบิวต์เพิ่มเติมไปยัง Airbridge นอกจากแอตทริบิวต์ที่กำหนดเองแล้ว ยังสามารถเพิ่มแอตทริบิวต์เชิงความหมายดังต่อไปนี้ได้
- การกระทำ (Action), ป้ายกำกับ (Label): รวบรวมข้อมูลที่สามารถใช้ในการจัดกลุ่มในรายงาน Airbridge
- ค่า: รวบรวมข้อมูลที่ใช้สำหรับการวิเคราะห์รายได้
- คุณลักษณะเชิงความหมาย (Semantic Attribute): คุณลักษณะที่กำหนดไว้ล่วงหน้าใน Airbridge ที่กำหนดไว้ล่วงหน้า
- หากคุณป้อนสตริงคุณลักษณะที่ไม่ตรงกับคุณลักษณะที่กำหนดไว้ล่วงหน้า ข้อมูลอาจไม่ถูกเก็บรวบรวม
- เหตุการณ์ที่มีข้อมูลที่ไม่ตรงกับรูปแบบข้อมูลของคุณลักษณะเชิงความหมายจะไม่ถูกเก็บรวบรวม เนื่องจากรูปแบบข้อมูลแตกต่างกันไปตามแต่ละคุณลักษณะเชิงความหมาย ต้องระมัดระวัง
- คุณลักษณะเชิงความหมายที่มีรูปแบบข้อมูลเป็นสตริงอนุญาตให้มีความยาวสูงสุด 1024 ตัวอักษร คุณลักษณะเชิงความหมายที่มีรูปแบบข้อมูลเป็น int หรือ float อนุญาตให้มีความยาวสูงสุด 64 บิต
API Reference: hive.Analytics.sendEventWithAttributes
using hive;
// สร้าง AnalyticsAttributes
var analyticsAttributes = new AnalyticsAttributes();
// คุณสมบัติเฉพาะสำหรับ Airbridge
var airbridgeSpecific = new AirbridgeSpecific();
// การกระทำ
airbridgeSpecific.SetSemanticAction("Tool");
// ป้ายชื่อ
airbridgeSpecific.SetSemanticLabel("Hammer");
// ค่า
airbridgeSpecific.SetSemanticValue(10);
// คุณลักษณะเชิงความหมาย
airbridgeSpecific.AddSemanticAttribute("type", "Warrior");
airbridgeSpecific.AddSemanticAttribute("score", 20);
// เพิ่มคุณสมบัติเฉพาะของ Airbridge
analyticsAttributes.AddModuleSpecificAttributes(airbridgeSpecific);
// เพิ่มคุณสมบัติที่กำหนดเอง
analyticsAttributes.AddCustomAttribute("key1", "value1");
analyticsAttributes.AddCustomAttribute("key2", "value2");
Analytics.sendEventWithAttributes("Quest Complete", analyticsAttributes);
#include "HiveAnalytics.h"
// สร้าง AnalyticsAttributes
FHiveAnalyticsAttributes AnalyticsAttributes;
// คุณสมบัติเฉพาะสำหรับ Airbridge
FHiveAirbridgeSpecific AirbridgeSpecific;
// การกระทำ
AirbridgeSpecific.SetSemanticAction(TEXT("เครื่องมือ"));
// ป้าย
AirbridgeSpecific.SetSemanticLabel(TEXT("ค้อน"));
// ค่า
AirbridgeSpecific.SetSemanticValue(10.0);
// คุณสมบัติทางความหมาย
TSharedPtr<FJsonValue> SemanticJsonValue1 = MakeShared<FJsonValueString>(TEXT("Warrior"));
AirbridgeSpecific.AddSemanticAttribute(TEXT("type"), SemanticJsonValue1);
TSharedPtr<FJsonValue> SemanticJsonValue2 = MakeShared<FJsonValueNumber>(20);
AirbridgeSpecific.AddSemanticAttribute(TEXT("score"), SemanticJsonValue2);
// เพิ่มคุณสมบัติเฉพาะของ Airbridge
AnalyticsAttributes.AddModuleSpecificAttribute(AirbridgeSpecific);
// เพิ่มคุณสมบัติที่กำหนดเอง
TSharedPtr<FJsonValue> CustomJsonValue1 = MakeShareable(new FJsonValueString("value1"));
AnalyticsAttributes.AddCustomAttribute(TEXT("key1"), CustomJsonValue1);
TSharedPtr<FJsonValue> CustomJsonValue2 = MakeShareable(new FJsonValueString("value2"));
AnalyticsAttributes.AddCustomAttribute(TEXT("key2"), CustomJsonValue2);
FHiveAnalytics::SendEventWithAttributes(strEventName, AnalyticsAttributes);
API Reference: Analytics::sendEventWithAttributes
#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace std;
using namespace hive;
// สร้าง AnalyticsAttributes
AnalyticsAttributes analyticsAttributes;
// คุณสมบัติพิเศษสำหรับ Airbridge
AirbridgeSpecific airbridgeSpecific;
std::string semanticAction = "Tool";
std::string semanticLabel = "Hammer";
double semanticValue = 10.0;
// การกระทำ
airbridgeSpecific.setSemanticAction(semanticAction);
// ป้ายชื่อ
airbridgeSpecific.setSemanticLabel(semanticLabel);
// ค่า
airbridgeSpecific.setSemanticValue(semanticValue);
// คุณลักษณะเชิงความหมาย
airbridgeSpecific.addSemanticAttribute("type", picojson::value("Warrior"));
airbridgeSpecific.addSemanticAttribute("score", picojson::value(20.0f));
// เพิ่มคุณสมบัติเฉพาะของ Airbridge
analyticsAttributes.addModuleSpecificAttribute(airbridgeSpecific);
// เพิ่มคุณสมบัติที่กำหนดเอง
analyticsAttributes.addCustomAttribute("key1", picojson::value("value1"));
analyticsAttributes.addCustomAttribute("key2", picojson::value("value2"));
std::string eventName = "Quest Complete";
Analytics::sendEventWithAttributes(eventName, analyticsAttributes);
API Reference: Analytics.sendEventWithAttributes
import com.hive.Analytics
import com.hive.analytics.provider.attributes.AirbridgeSpecific
import com.hive.analytics.provider.attributes.AnalyticsAttributes
// สร้าง AnalyticsAttributes
val analyticsAttributes = AnalyticsAttributes()
// คุณลักษณะเฉพาะสำหรับ Airbridge
val airbridgeSpecific = AirbridgeSpecific().apply {
setSemanticAction("Tool") // การกระทำ
setSemanticLabel("Hammer") // ป้ายชื่อ
setSemanticValue(10.0) // ค่า
addSemanticAttribute("type", "Warrior") // คุณลักษณะเชิงความหมาย
addSemanticAttribute("score", 20.0f) // คุณลักษณะเชิงความหมาย
}
// เพิ่มคุณสมบัติเฉพาะของ Airbridge
analyticsAttributes.addModuleSpecificAttribute(airbridgeSpecific)
// เพิ่มคุณสมบัติที่กำหนดเอง
analyticsAttributes.addCustomAttribute("key1", "value1")
analyticsAttributes.addCustomAttribute("key2", "value2")
Analytics.sendEventWithAttributes("Quest Complete", analyticsAttributes)
API Reference: Analytics.sendEventWithAttributes
import com.hive.Analytics;
import com.hive.analytics.provider.attributes.AirbridgeSpecific;
import com.hive.analytics.provider.attributes.AnalyticsAttributes;
// สร้าง AnalyticsAttributes
AnalyticsAttributes analyticsAttributes = new AnalyticsAttributes();
// คุณลักษณะเฉพาะสำหรับ Airbridge
AirbridgeSpecific airbridgeSpecific = new AirbridgeSpecific();
airbridgeSpecific.setSemanticAction("Tool"); // การดำเนินการ
airbridgeSpecific.setSemanticLabel("Hammer"); // ป้ายกำกับ
airbridgeSpecific.setSemanticValue(10.0); // ค่า
airbridgeSpecific.addSemanticAttribute("type", "Warrior"); // คุณลักษณะเชิงความหมาย
airbridgeSpecific.addSemanticAttribute("score", 20.0f); // คุณลักษณะเชิงความหมาย
// เพิ่มคุณสมบัติเฉพาะของ Airbridge
analyticsAttributes.addModuleSpecificAttribute(airbridgeSpecific);
// เพิ่มคุณลักษณะกำหนดเอง
analyticsAttributes.addCustomAttribute("key1", "value1");
analyticsAttributes.addCustomAttribute("key2", "value2");
Analytics.sendEventWithAttributes("Quest Complete", analyticsAttributes);
API Reference: HIVEAnalytics:sendEventWithAttributes
#import <HIVEService/HIVEService-Swift.h>
HiveAnalyticsAttributes* analyticsAttributes = [[HiveAnalyticsAttributes alloc] init];
HiveAirbridgeSpecific* airbridgeSpecific = [[HiveAirbridgeSpecific alloc] init];
[airbridgeSpecific setSemanticAction: @"Tool"];
[airbridgeSpecific setSemanticAction: @"Hammer"];
[airbridgeSpecific setSemanticValue: 10.0];
[airbridgeSpecific addSemanticAttribute: @"type" value: @"Warrior"];
[airbridgeSpecific addSemanticAttribute: @"score" value: @20.0f];
[analyticsAttributes addModuleSpecificAttribute: airbridgeSpecific];
[analyticsAttributes addCustomAttribute: @"key1" value: @"value1"];
[analyticsAttributes addCustomAttribute: @"key2" value: @"value2"];
[HIVEAnalytics sendEventWithAttributes: @"Quest Complete" attributes: analyticsAttributes];
API Reference: HIVEAnalytics:sendEventWithAttributes
#import HIVEService
// สร้าง AnalyticsAttributes
let analyticsAttributes = AnalyticsAttributes()
// คุณสมบัติเฉพาะสำหรับ Airbridge
let airbridgeSpecific = AirbridgeSpecific()
airbridgeSpecific.setSemanticAction("Tool")
airbridgeSpecific.setSemanticLabel("Hammer")
airbridgeSpecific.setSemanticValue(10.0)
airbridgeSpecific.addSemanticAttribute("type", value: "Warrior")
airbridgeSpecific.addSemanticAttribute("score", value: 20.0)
// เพิ่มคุณสมบัติเฉพาะของ Airbridge
analyticsAttributes.addModuleSpecificAttribute(airbridgeSpecific)
// เพิ่มคุณสมบัติที่กำหนดเอง
analyticsAttributes.addCustomAttribute("key1", value: "value1")
analyticsAttributes.addCustomAttribute("key2", value: "value2")
AnalyticsInterface.sendEventWithAttributes("Quest Complete", attributes: analyticsAttributes)
การใช้การวัดอุปกรณ์ Google Ads ในสภาพแวดล้อม Firebase¶
ในการวัดการแปลงบนอุปกรณ์ที่จัดทำโดย Google Ads ในสภาพแวดล้อม Firebase คุณต้องดำเนินการตาม Firebase Google ODM Solution โซลูชันนี้ต้องการที่อยู่อีเมลหรือหมายเลขโทรศัพท์ที่ผู้ใช้ได้ให้ความยินยอมในการให้ ในระหว่างการดำเนินการโซลูชันนี้ หากมีการใช้ Firebase Authentication หรือสภาพแวดล้อมการตรวจสอบสิทธิ์แยกต่างหากที่นักพัฒนานำเสนอ SDK Hive จะไม่เก็บที่อยู่อีเมลและจะส่งผ่านที่อยู่อีเมลใด ๆ ที่ได้รับในคำตอบหลังการตรวจสอบสิทธิ์ไปยัง Firebase API โดยตรง
Note
คู่มือนี้มีไว้สำหรับแอป iOS เท่านั้น แอป Android ไม่จำเป็นต้องมีขั้นตอนแยกต่างหากในการวัดการแปลงบนอุปกรณ์ในสภาพแวดล้อม Firebase.
วิธีการดำเนินการ¶
ตลอดทั้งกระบวนการด้านล่างนี้ คุณต้องมั่นใจว่าข้อมูลส่วนบุคคลสำหรับการระบุตัวตนจะต้องไม่รั่วไหลจากอุปกรณ์ของผู้ใช้ไปยังภายนอก
- ดาวน์โหลด Google Firebase ODM Unity Plugin และเพิ่มลงในโปรเจกต์ Unity ของคุณ
- นำไปใช้การตรวจสอบสิทธิ์เพื่อให้ได้ที่อยู่อีเมล IdP หรือหมายเลขโทรศัพท์หลังจากเข้าสู่ระบบ
- ทำให้ที่อยู่อีเมลหรือหมายเลขโทรศัพท์เป็นมาตรฐาน ตามวิธีที่กำหนดโดย Firebase.
- นำไปใช้การส่งที่อยู่อีเมล/หมายเลขโทรศัพท์ที่เป็นมาตรฐานไปยัง Firebase หรือใช้การส่งค่าที่ถูกแฮชของที่อยู่อีเมล/หมายเลขโทรศัพท์ที่เป็นมาตรฐานไปยัง Firebase แนะนำให้ดู ตัวอย่างโค้ด ด้านล่าง
Note
API ของปลั๊กอินสามารถเรียกใช้ได้ตามลำดับ แต่ การเรียกใช้ครั้งถัดไปจะถูกเพิกเฉยหลังจากถูกเรียกใช้เพียงครั้งเดียวต่อผู้ใช้
ตัวอย่างโค้ด¶
ด้านล่างคือตัวอย่างโค้ดเมื่อใช้ปลั๊กอิน Unity.