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

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. เพิ่มการปรับแต่งการให้เครดิตในไฟล์ build.gradle ระดับโปรเจกต์ของคุณเพื่อใช้ SDK Signature..

   dependencies {
       implementation "com.com2us.android.hive:hive-analytics-provider-adjust"
   }
   

2. ไปที่แดชบอร์ด Adjust และทำตามคำแนะนำในหน้า เพิ่มลายนิ้วมือของใบรับรองดิจิทัลของคุณไปยังรายการอนุญาตของ Adjust เพื่อตั้งค่าลายนิ้วมือของคุณ.

คุณสามารถตรวจสอบวิธีการดึงลายนิ้วมือตามวิธีการรับรองที่แต่ละแอปใช้ได้โดยการอ้างอิงไปที่ หน้าเพจการตั้งค่ารับรองใน Adjust Suite.

iOS¶

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

(omitted)
pod HiveAnalyticsProviderAdjust, $HIVE_SDK_VERSION
(omitted)

ยูนิตี้¶

หากคุณต้องการใช้ SDK Signature ในเอนจิน Unity คุณสามารถตั้งค่าได้อย่างง่ายดายในเมนูเอนจิน Unity

หากคุณเลือก Hive - Hive Dependencies (ExternalDependency) ในเมนู Inspector ด้านล่างและตรวจสอบ Adjust คุณสามารถใช้ SDK Signature โดยไม่ต้องตั้งค่าเพิ่มเติม

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

เพื่อยืนยันว่าห้องสมุดการลงนามลายเซ็น SDK ได้ถูกผสานรวมอย่างดี ให้ตรวจสอบก่อนว่าค่า 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"> -->
    <Adjust name="Adjust" key="APP_TOKEN">
        <events>
            <event name="Purchase" value="PURCHASE_EVENT_TOKEN" />
            <event name="Update" value="UPDATE_EVENT_TOKEN" />
        </events>
    </Adjust>

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

ยูนิตี้¶

Hive SDK Unity ไม่จำเป็นต้องลบการตั้งค่าเวอร์ชันลายเซ็น SDK ก่อนหน้า

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

1. รับโทเค็นที่จำเป็น สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการออกโทเค็น โปรดดูที่ คู่มือแดชบอร์ด Airbridge.
   • รับ SDK Token และชื่อแอปจาก Dashboard > การตั้งค่า > การจัดการโทเค็น。
2. สำหรับ Android และ iOS ให้เพิ่มโทเค็น ชื่อแอป และการตั้งค่าเหตุการณ์อัปเดตลงใน hive_config.xml ดู ตัวอย่างโค้ด hive_config.xml ด้านล่าง。
3. สำหรับ Windows คุณต้องการการตั้งค่าคอนโซล Hive แทนการตั้งค่า 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 SDK ของ Hive จะส่งเหตุการณ์การซื้อไปยังการอ้างอิงแอปมือถือของบุคคลที่สามโดยอัตโนมัติ ข้อมูลที่ส่งในแต่ละเหตุการณ์มีดังนี้