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

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 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.
   • รับ 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

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

ยูนิตี้¶

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

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

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

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

1. รับกุญแจที่จำเป็นจากแต่ละแดชบอร์ดการให้เครดิต อ้างอิงจากคู่มือจากแต่ละแดชบอร์ดการให้เครดิตเพื่อเรียนรู้วิธีการรับกุญแจ
   • Singular: รับ SDK Key และ SDK SecretKey จากแดชบอร์ด
   • Appsflyer: ไปที่ AppsFlyer Configurations > App Settings เพื่อรับ 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 จะส่งเหตุการณ์การซื้อไปยังการกำหนดค่าแอปมือถือของบุคคลที่สามโดยอัตโนมัติ ข้อมูลที่ส่งในแต่ละเหตุการณ์มีดังนี้