ข้ามไปที่เนื้อหา

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

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.
Note

แนะนำให้ติดตามเหตุการณ์ทั้ง 4 เหตุการณ์โดยอัตโนมัติสำหรับการดำเนินงานเกมของคุณ

การรวมลายเซ็น 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 จากนั้นให้ทำตามขั้นตอนด้านล่าง

Note
สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ [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 โดยอัตโนมัติ ข้อมูลที่ส่งในขณะนี้มีดังต่อไปนี้

out
ชื่อเหตุการณ์ พารามิเตอร์ หมายเหตุ
เข้าสู่ระบบ ลงชื่อเข้าใช้
  • user.externalUserID: playerId
ออกจากระบบ ลงชื่อออก
เริ่มการชำระเงิน เริ่มการชำระเงิน
  • totalQuantity
  • currency
  • originalCurrency
  • products
  • products.name: ชื่อผลิตภัณฑ์
  • originalCurrency: สกุลเงินที่ส่งจาก SDK
  • currency: สกุลเงินหลักที่ลงทะเบียนเมื่อตั้งค่าแอป Airbridge
การซื้อเสร็จสมบูรณ์ การสั่งซื้อเสร็จสมบูรณ์
  • totalQuantity
  • currency
  • originalCurrency
  • value
  • transactionID
  • inAppPurchased
  • products
  • products.name: ชื่อผลิตภัณฑ์
  • value: ผลรวมของ products.price
  • originalCurrency: สกุลเงินที่ส่งจาก SDK
  • currency: สกุลเงินหลักที่ลงทะเบียนเมื่อตั้งค่า Airbridge
การยกเลิกการซื้อ การยกเลิกการสั่งซื้อ
  • transactionType
  • totalQuantity
  • currency
  • originalCurrency
  • value
  • inAppPurchased
  • products
  • transactionType: "cancel"
  • products.name: ชื่อผลิตภัณฑ์
  • value: ผลรวมของ products.price
  • originalCurrency: สกุลเงินที่ส่งจาก SDK
  • currency: สกุลเงินหลักที่ลงทะเบียนเมื่อตั้งค่าแอป Airbridge
การสมัครสมาชิก สมัครสมาชิก
  • totalQuantity
  • currency
  • originalCurrency
  • value
  • isRenewal
  • products
  • products.name: ชื่อผลิตภัณฑ์
  • value: ผลรวมของ products.price
  • originalCurrency: สกุลเงินที่ส่งจาก SDK
  • currency: สกุลเงินหลักที่ลงทะเบียนเมื่อตั้งค่าแอป Airbridge
การแสดงโฆษณา การแสดงโฆษณา
  • ad_placement
  • ad_platform
  • ad_type
  • ad_unit_id
  • currency
  • eventType
  • revenue
  • การติดตามอัตโนมัติเมื่อ Adiz, Adkit
    • การอัปเดตที่วางแผนไว้
การคลิกโฆษณา การคลิกโฆษณา
  • ad_placement
  • ad_platform
  • ad_type
  • ad_unit_id
  • currency
  • eventType
  • revenue
  • การติดตามอัตโนมัติเมื่อ Adiz, Adkit
    • การอัปเดตที่วางแผนไว้
การประเมิน การให้คะแนน
  • buttontype
  • category
  • orient
  • หมวดหมู่:
    • hive_review_click: UI รีวิว Hive
    • hive_native_review_request: ป๊อปอัพรีวิวตลาดพื้นเมือง
  • ทิศทาง:
    • แนวตั้ง: "1"
    • แนวนอน: "2"
แชร์ แชร์

การติดตามเหตุการณ์อัตโนมัติกับ 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>
    
Note

แนะนำให้ติดตามเหตุการณ์ทั้ง 4 อย่างโดยอัตโนมัติสำหรับการดำเนินการเกมของคุณ.

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

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

ชื่อเหตุการณ์ พารามิเตอร์ หมายเหตุ
ปรับ การซื้อ
  • ราคา
  • สกุลเงิน
  • orderId
  • pid
  • ชื่อเรื่อง
  • serverId
  • จำนวน
  • รายได้
  • pid: รหัสผลิตภัณฑ์
  • รายได้: ราคา * จำนวน
Airbridge การสั่งซื้อเสร็จสมบูรณ์
  • totalQuantity
  • สกุลเงิน
  • สกุลเงินเดิม
  • ค่า
  • transactionID
  • inAppPurchased
  • ผลิตภัณฑ์
  • products.name: ชื่อผลิตภัณฑ์
  • ค่า: ผลรวมของ products.price
  • สกุลเงินเดิม: สกุลเงินที่ส่งจาก SDK
  • สกุลเงิน: สกุลเงินหลักที่ลงทะเบียนเมื่อกำหนดค่าแอป Airbridge
Singular __iap__
  • r
  • pk
  • pcc
  • pn
  • pc
  • pq
  • pp
  • ตลาด
  • เซิร์ฟเวอร์
  • psku
  • pvid
  • haid
  • r: รายได้ (ราคา * จำนวน)
  • pk: รหัสคำสั่งซื้อ
  • pcc: สกุลเงิน
  • pn: ชื่อเรื่อง
  • pc: Inapp_Item
  • pq: จำนวน
  • pp: ราคา
  • ตลาด: google
  • เซิร์ฟเวอร์: serverId
  • psku: รหัสผลิตภัณฑ์
  • pvid: Hive PlayerID
  • haid: Hive Analytics ID
AppsFlyer การซื้อ
  • af_price
  • af_currency
  • af_quantity
  • af_content
  • af_receipt_id
  • custsom_product_id
  • af_content_type
  • af_revenue
  • custsom_product_id: รหัสผลิตภัณฑ์
  • af_content: คำอธิบายผลิตภัณฑ์
  • af_content_type: ชื่อเรื่อง
  • af_revenue: ราคา * จำนวน
Firebase Analytics การซื้อ
  • ราคา
  • สกุลเงิน
  • orderId
  • pid
  • ชื่อเรื่อง
  • serverId
  • จำนวน
  • รายได้
  • pid: รหัสผลิตภัณฑ์
  • รายได้: ราคา * จำนวน