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

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 ก่อนที่จะรวมไลบรารีลายเซ็น หากคุณใช้ 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 Signature ได้ถูกบูรณาการอย่างถูกต้อง ให้ตรวจสอบก่อนว่าค่า zone ใน Hive SDK Settings ถูกตั้งค่าเป็น sandbox จากนั้นให้ทำตามขั้นตอนด้านล่าง

1. ถอนการติดตั้งแอปจากอุปกรณ์ทดสอบอย่างสมบูรณ์เพื่อให้แน่ใจว่าข้อมูลการติดตั้งถูกส่งไป
2. ไปที่ Adjust Dashboard Testing Console, ป้อนข้อมูลอุปกรณ์ทดสอบ และคลิก ลบอุปกรณ์ เพื่อลบอุปกรณ์ทั้งหมด
3. ติดตั้งแอปบนอุปกรณ์ทดสอบและเรียกใช้เพื่อให้แน่ใจว่าข้อมูลการติดตั้งถูกส่งไปยัง Adjust
4. ป้อน ID โฆษณาของอุปกรณ์ทดสอบหรือ IDFA ในคอนโซลทดสอบเพื่อดึงข้อมูลเหตุการณ์การติดตั้ง
   • ฟิลด์ SignatureVerificationResult ควรแสดงค่า Valid Signature
   • ตรวจสอบว่าค่าฟิลด์ 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. สำหรับ Android และ iOS ให้เพิ่มโทเค็น ชื่อแอป และการตั้งค่าเหตุการณ์อัปเดตลงใน hive_config.xml ดู ตัวอย่างโค้ด hive_config.xml ด้านล่าง.
3. สำหรับ Windows คุณต้องการการตั้งค่า Hive Console แทนการตั้งค่า hive_config.xml ดู การตั้งค่า Windows ด้านล่าง.
4. หากคุณกำลังใช้ Windows, Android และ iOS ร่วมกัน ติดต่อ Airbridge เพื่อการตั้งค่าล่วงหน้า.
5. Airbridge มี SDK Signature เพื่อป้องกันการปลอมแปลงแอป คุณต้องตรวจสอบเงื่อนไขของข้อตกลงกับ Airbridge ก่อนจึงจะใช้ฟีเจอร์นี้ได้ รับคีย์และเพิ่มเป็นค่า secretId และ secret ใน hive_config.xml สำหรับข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลความปลอดภัยของ SDK signature โปรดดูที่ คู่มือ Airbridge รองรับเฉพาะบน Android และ iOS เท่านั้น ไม่รองรับบน Windows.

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

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

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" />
                        <event name="Install" value="Install"/>
            <event name="Open" value="Open"/>
            <event name="PrePurchase" value="airbridge.initiateCheckout"/>
            <event name="PurchaseCancel" value="airbridge.ecommerce.order.canceled"/>
            <event name="Purchase" value="airbridge.ecommerce.order.completed"/>
        </events>
    </Airbridge>
</providers>

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

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

Windows¶

1. ดำเนินการตั้งค่าการติดตามการตลาด - การตั้งค่า Airbridge ในคอนโซล Hive.

   • ไม่จำเป็นต้องตั้งค่า secretId, secret ค่าคีย์ที่เกี่ยวข้องกับ Airbridge ใน hive_config.xml.

2. ตั้งค่าใน hive_config.xml ตามคำแนะนำด้านล่าง อ้างอิงถึง hive_config.xml ตัวอย่างโค้ด.
   เมื่อตั้งค่าเป็นค่าที่กำหนดใน Airbridge จะสามารถส่งเป็นเหตุการณ์มาตรฐานของ Airbridge ได้.
   ประเภทเหตุการณ์ Airbridge

   • ติดตั้ง: ต้องการการตั้งค่า.
   • เปิด: ต้องการการตั้งค่า.
   • อัปเดต: ต้องการการตั้งค่า.
   • ก่อนการซื้อ: ต้องการการตั้งค่า. คุณสามารถส่งเหตุการณ์มาตรฐานด้วย airbridge.initiateCheckout เป็นค่า.
   • ยกเลิกการซื้อ: ต้องการการตั้งค่า. คุณสามารถส่งเหตุการณ์มาตรฐานด้วย airbridge.ecommerce.order.canceled เป็นค่า.
   • ซื้อ: ต้องการการตั้งค่า. คุณสามารถส่งเหตุการณ์มาตรฐานด้วย airbridge.ecommerce.order.completed เป็นค่า

ยูนิตี้¶

เลือก 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
   • หากคุณใช้การให้เครดิต 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 จะส่งเหตุการณ์การซื้อไปยังการระบุแอปพลิเคชันมือถือของบุคคลที่สามโดยอัตโนมัติ ข้อมูลที่ส่งในแต่ละเหตุการณ์มีดังนี้