การติดตามเหตุการณ์อัตโนมัติ

Hive SDK สามารถติดตามเหตุการณ์ 4 รายการต่อไปนี้โดยอัตโนมัติและส่งไปยังการอ้างอิงแต่ละรายการ: ติดตั้ง, เปิด, อัปเดต, ซื้อ (การซื้อในแอป) สตูดิโอเกมไม่จำเป็นต้องเขียนโค้ดเพื่อติดตามเหตุการณ์ 4 รายการนี้

การติดตามเหตุการณ์อัตโนมัติกับ Adjust¶

1. รับโทเค็นที่จำเป็นจากแต่ละการให้เครดิต ดูที่ คู่มือแดชบอร์ด Adjust เพื่อเรียนรู้วิธีการรับโทเค็น

   • เพื่อติดตามการซื้อและเหตุการณ์การอัปเดตโดยอัตโนมัติ ลงทะเบียนเหตุการณ์เหล่านี้ในแดชบอร์ด Adjust และรับโทเค็นแอปและโทเค็นเหตุการณ์ โทเค็นแอปสามารถรับได้จากหน้าแรกของแดชบอร์ด และโทเค็นเหตุการณ์จากแดชบอร์ด > การตั้งค่าทั้งหมด > เหตุการณ์
   • สำหรับการติดตามการติดตั้งและเหตุการณ์เปิดโดยอัตโนมัติ ไม่ต้องใช้โทเค็น

2. เพิ่มโทเค็นใน hive_config.xml.

   • เพิ่มโทเค็นแอป โทเค็นเหตุการณ์ของการซื้อ และโทเค็นเหตุการณ์ของการอัปเดตใน hive_config.xml สำหรับรายละเอียดเพิ่มเติม ดูตัวอย่างโค้ดด้านล่าง
   • สำหรับการติดตามเหตุการณ์การติดตั้งและเปิดโดยอัตโนมัติ การกำหนดค่า hive_config.xml ไม่จำเป็น
3. แดชบอร์ด Adjust ให้ SDK Signature V3 เพื่อป้องกันการปลอมแปลงแอป เพื่อใช้ SDK Signature คุณต้องตรวจสอบเงื่อนไขสัญญากับ Adjust.

การรวมลายเซ็น SDK¶

หากคุณเคยใช้เวอร์ชันเก่าของ SDK Signature โปรดตรวจสอบที่ SDK Signature Migration ก่อนที่จะรวมไลบรารีลายเซ็น หากคุณใช้ SDK Signature เป็นครั้งแรก โปรดทำตามคำแนะนำด้านล่าง

แอนดรอยด์¶

ในการใช้ SDK Signature ในสภาพแวดล้อม Android ให้ทำตามคำแนะนำเหล่านี้

1. คัดลอกไลบรารี adjust-android-signature-xxxxxx.aar ที่รวมอยู่ในโฟลเดอร์ SDK/External และเพิ่มลงในโฟลเดอร์ libs ของโปรเจกต์ของคุณ
2. ไปที่แดชบอร์ด Adjust และทำตามคำแนะนำในหน้า เพิ่มลายนิ้วมือของใบรับรองดิจิทัลของคุณไปยังรายการอนุญาตของ Adjust เพื่อกำหนดค่าลายนิ้วมือของคุณ คุณสามารถตรวจสอบลายนิ้วมือได้โดยอ้างอิงจาก หน้า ตั้งค่าใบรับรองใน Adjust Suite เพื่อทำตามวิธีการใบรับรองที่ใช้ในแอปของคุณ.

iOS¶

ในการใช้ SDK Signature ในสภาพแวดล้อม iOS ให้เพิ่ม ProviderAdjust subspec ลงใน Podfile ของคุณ

(omitted)
pod 'HiveAnalyticsProviderAdjust', $HIVE_SDK_VERSION
pod 'HiveAnalyticsProviderAdjust/SignatureV3', $HIVE_SDK_VERSION
(omitted)

ยูนิตี้¶

เลือก Hive - Hive Dependencies(ExternalDependency) จากเมนูและเปิดใช้งาน Adjust Signature V3.

ตรวจสอบสถานะการรวมลายเซ็น SDK¶

เพื่อยืนยันว่าห้องสมุดการลงนามลายเซ็น SDK ได้ถูกติดตั้งอย่างถูกต้อง ให้ตรวจสอบก่อนว่าค่า zone ใน Hive SDK Settings ถูกตั้งค่าเป็น sandbox จากนั้นให้ทำตามขั้นตอนด้านล่าง

สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ [Adjust Documentation](https://dev.adjust.com/ko/sdk/android/integrations/signature-library?version=v4#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist).

1. ลบแอปออกจากอุปกรณ์ทดสอบโดยสมบูรณ์เพื่อให้แน่ใจว่าข้อมูลการติดตั้งถูกส่ง
2. ไปที่ Adjust Dashboard Testing Console, ป้อนข้อมูลอุปกรณ์ทดสอบ และคลิก ลบอุปกรณ์ เพื่อเอาอุปกรณ์ทั้งหมดออก
3. ติดตั้งแอปบนอุปกรณ์ทดสอบและเรียกใช้เพื่อให้แน่ใจว่าข้อมูลการติดตั้งถูกส่งไปยัง Adjust

4. ป้อน ID โฆษณาของอุปกรณ์ทดสอบหรือ IDFA ในคอนโซลการทดสอบเพื่อดึงข้อมูลเหตุการณ์การติดตั้ง

5. ฟิลด์ SignatureVerificationResult ควรแสดงค่า Valid Signature

6. ตรวจสอบว่าค่าฟิลด์ SignatureVersion เป็น 3

การย้ายลายเซ็น SDK¶

ในการใช้ SDK Signature เวอร์ชันล่าสุด คุณต้องลบการตั้งค่าเวอร์ชัน SDK Signature ก่อนหน้านี้

แอนดรอยด์, iOS¶

ลบคีย์และค่าทั้งหมดที่ตั้งไว้สำหรับ secretId, info1, info2, info3, และ info4 ในการตั้งค่าเกี่ยวกับ Adjust ใน hive_config.xml.

<providers>
        <!-- (code omitted) -->

        <!-- Do not set the Adjust node id field. -->
        <!-- The Adjust node name field is fixed as "Adjust". -->
        <!-- The event node name field is set arbitrarily by the game company. -->

        <!-- Remove secretId="1" info1="5432112345" info2="334123" info3="555333" info4="111333" below -->
        <Adjust name="Adjust" id="unused" key="APP_TOKEN" secretId="1" info1="5432112345" info2="334123" info3="555333" info4="111333">
                <events>
                        <event name="Purchase" value="PURCHASE_EVENT_TOKEN" />
                        <event name="Update" value="UPDATE_EVENT_TOKEN" />
                </events>
        </Adjust>

        <!-- (code omitted) -->
</providers>

ยูนิตี้¶

เลือก Hive - แก้ไขการตั้งค่า จากเมนูและเปิดใช้งานแท็บ Android หรือ iOS จากนั้นลบค่าทั้งหมดที่ตั้งค่าใน Adjust > App Secret Value สำหรับ secretid, info1 ~ info4 .

ติดตามเหตุการณ์โดยอัตโนมัติกับ Airbridge¶

1. รับโทเค็นที่จำเป็น สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการออกโทเค็น โปรดดูที่ คู่มือแดชบอร์ด Airbridge.
   • รับ App SDK Token และชื่อแอปจาก Dashboard > การตั้งค่า > การจัดการโทเค็น.
2. เพิ่มโทเค็น, ชื่อแอป, และการตั้งค่าเหตุการณ์อัปเดตลงใน hive_config.xml ดูตัวอย่างโค้ดด้านล่าง.
3. Airbridge ให้บริการ SDK Signature เพื่อป้องกันการปลอมแปลงแอป สำหรับการใช้ฟีเจอร์ที่เกี่ยวข้อง คุณต้องตรวจสอบข้อตกลงกับ Airbridge เพื่อใช้ฟีเจอร์ที่เกี่ยวข้อง ต้องขอคีย์และเพิ่มลงใน secretId และ secret ใน hive_config.xml สำหรับข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลความปลอดภัยของ SDK signature โปรดดูที่ คู่มือ Airbridge.

การรวมลายเซ็น SDK¶

หากคุณกำลังใช้ SDK Signature เป็นครั้งแรก โปรดทำตามคำแนะนำด้านล่าง

แอนดรอยด์, iOS¶

ตั้งค่าค่าต่าง ๆ ในคีย์ secretId และ secret ในการตั้งค่าที่เกี่ยวข้องกับ Airbridge ใน hive_config.xml.

<providers>
        <Airbridge name="Airbridge" key="APP_SDK_TOKEN" appName="APP_NAME" secretId="SECRET_ID" secret="SECRET">
                <events>
                        <event name="Update" value="Update" />
                </events>
        </Airbridge>
</providers>

ยูนิตี้¶

เลือก Hive - แก้ไขการตั้งค่า จากเมนูและเปิดใช้งานแท็บ Android หรือ iOS จากนั้นตั้งค่าค่าที่ส่งใน secretId, secret ใน Airbridge .

ข้อมูลที่ส่งเมื่อเกิดเหตุการณ์อัตโนมัติ¶

เมื่อมีการดำเนินการเหตุการณ์เฉพาะ เหตุการณ์จะถูกส่งไปยังการระบุแอป Airbridge โดยอัตโนมัติ ข้อมูลที่ส่งในขณะนี้มีดังต่อไปนี้

การติดตามเหตุการณ์อัตโนมัติกับ Singular, Appsflyer, Firebase Analytics¶

1. รับคีย์ที่จำเป็นจากแต่ละแดชบอร์ดการให้เครดิต อ้างอิงจากคู่มือจากแต่ละแดชบอร์ดการให้เครดิตเพื่อเรียนรู้วิธีการรับคีย์
   • Singular: รับ SDK Key และ SDK SecretKey จากแดชบอร์ด
   • Appsflyer: ไปที่การตั้งค่า AppsFlyer > การตั้งค่าแอปเพื่อรับ Dev key
   • Firebase Analytics: ไม่จำเป็นต้องใช้คีย์
2. กำหนดค่า hive_config.xml ตามคู่มือด้านล่าง สำหรับรายละเอียดเพิ่มเติม โปรดดูตัวอย่างโค้ดด้านล่าง
   • ติดตั้ง: ไม่จำเป็นต้องกำหนดค่า
   • เปิด: คุณต้องกำหนดค่าสำหรับ Firebase Analytics เท่านั้น
   • อัปเดต: คุณต้องกำหนดค่าสำหรับการให้เครดิตทั้งหมด: Singular, Appsflyer, Firebase Analytics
   • ซื้อ: คุณต้องกำหนดค่าสำหรับ Singular และ Firebase Analytics

3. หากคุณใช้การให้เครดิต AppsFlyer กับ Hive SDK iOS (Native, Unity, Unreal) คุณต้องตั้งค่า itunseConnectAppId สำหรับ Apple AppID.

   <providers>
           <!-- กำหนดสำหรับ Singular -->
           <!-- ฟิลด์ชื่อของโหนด Singular ถูกตั้งค่าเป็น "Singular." -->
           <!-- ฟิลด์ชื่อและฟิลด์ค่าของโหนดเหตุการณ์ถูกกำหนดโดยแต่ละสตูดิโอเกม. -->
           <Singular name="Singular" id="SDK_KEY" key="SDK_SECRET_KEY">
                   <events>
                           <event name="Purchase" value="purchase"/>
                           <event name="Update" value="update"/>
                   </events>
           </Singular>
   
           <!-- กำหนดค่าสำหรับ AppsFlyer -->
           <!-- ฟิลด์ชื่อของโหนด AppsFlyer ถูกกำหนดให้เป็น "AppsFlyer." -->
           <!-- อย่าตั้งค่าฟิลด์ id ของโหนด AppsFlyer. -->
           <!-- ฟิลด์ชื่อและฟิลด์ค่า ของโหนดเหตุการณ์ถูกกำหนดโดยแต่ละสตูดิโอเกม. -->
           <AppsFlyer name="AppsFlyer" id="unused" key="DEV_KEY" itunseConnectAppId="909923112">
                   <events>
                           <event name="Update" value="Update"/>
                   </events>
           </AppsFlyer>
   
           <!-- กำหนดค่าสำหรับ Firebase Analytics -->
           <!-- ชื่อและค่าของโหนดเหตุการณ์ถูกกำหนดโดยแต่ละสตูดิโอเกม -->
           <firebase>
                   <events>
                           <event name="Purchase" value="purchase"/>
                           <event name="Open" value="open"/>
                           <event name="Update" value="update"/>
                   </events>
           </firebase>
   </providers>
   

ข้อมูลที่ส่งในเหตุการณ์การซื้อ¶

หากคุณดำเนินการเรียกเก็บเงินสำหรับเกมของคุณด้วย Hive IAP, Hive SDK จะส่งเหตุการณ์การซื้อไปยังการกำหนดแอปมือถือของบุคคลที่สามโดยอัตโนมัติ ข้อมูลที่ส่งในแต่ละเหตุการณ์มีดังนี้