Android

นี่คือคำแนะนำสำหรับ SDK Android ของแบรนด์ Hive สำหรับการตั้งค่าโปรโมชั่น

การเพิ่มไลบรารีเพื่อใช้งาน¶

เพิ่มไลบรารีภายนอกเพื่อใช้ Hive SDK Promotion ในไฟล์ระดับโมดูล build.gradle ด้านล่างนี้คือตัวอย่างของ build.gradle .

dependencies {
   // Promotion
   implementation "com.com2us.android.hive:hive-promotion"
   // Promotion Google In-App Review
   implementation "com.com2us.android.hive:hive-promotion-google-inappreview"
   // Add this if you want to use Promotion video function.
   implementation "com.com2us.android.hive:youtube-helper"
}

การใช้ Deep Links¶

ลิงก์ลึกคือ ลิงก์ที่นำผู้ใช้ไปยังตำแหน่งเฉพาะในแอปหลังจากเปิดแอป การส่งเสริมการมีส่วนร่วมของผู้ใช้ รองรับการประมวลผลสำหรับแผนลิงก์ลึก เพื่อใช้ลิงก์ลึก ให้เพิ่มสิ่งต่อไปนี้ใน AndroidManifest.xml。

<manifest>
  <activity android:name="YOUR_MAIN_ACTIVITY">
    <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="${applicationId}" />
    </intent-filter>
  </activity>
</manifest>

การใช้ลิงก์ลึกที่เลื่อนเวลา¶

ลิงก์ลึกที่เลื่อนออกไปจะถูกจัดเตรียมเป็น URL เดียวและทำงานในสองวิธีหลัก:

• หากผู้ใช้ยังไม่ได้ติดตั้งแอป พวกเขาจะถูกเปลี่ยนเส้นทางไปยังตลาดแอปเพื่อทำการติดตั้ง หลังจากติดตั้งและเปิดแอป ผู้ใช้จะถูกนำไปยังตำแหน่งเฉพาะภายในแอป
• หากผู้ใช้ได้ติดตั้งแอปแล้ว การเปิดแอปผ่านลิงก์จะนำพวกเขาไปยังตำแหน่งเฉพาะภายในแอปโดยตรง

ในการใช้ลิงก์ลึกที่เลื่อนออกไป ให้เพิ่มสิ่งต่อไปนี้ลงในไฟล์ AndroidManifest.xml ของคุณ

<activity
    android:name="com.hive.userengagement.DeferredDeeplinkActivity"
    android:exported="true">

    <!-- Add this when using the sandbox server -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data
            android:scheme="https"
            android:host="sandbox-promotion.qpyou.cn"
            android:pathPattern="/deeplink/${applicationId}/vid/.*" />
    </intent-filter>

    <!-- Add this when using the production server -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data
            android:scheme="https"
            android:host="promotion.qpyou.cn"
            android:pathPattern="/deeplink/${applicationId}/vid/.*" />
    </intent-filter>
</activity>

ลิงก์เชิงลึกแบบเลื่อนลอยสนับสนุนเฉพาะ Google Play Store บน Android เท่านั้น โปรดกำหนดค่าหากคุณต้องการแชร์ลิงก์เชิญเพื่อนผ่าน Hive การเข้าซื้อผู้ใช้ (UA) คุณสามารถใช้วิธีที่มีอยู่หรือวิธีลิงก์เชิงลึกแบบเลื่อนลอยได้อย่างอิสระ

ลำดับการดำเนินการสำหรับ Hive การได้มาซึ่งผู้ใช้ (UA) โดยใช้ลิงก์ลึกที่เลื่อนออกไปมีดังนี้:

1. ผู้ใช้ A แบ่งปันลิงก์เชื่อมโยงลึกที่เลื่อนเวลาได้ผ่านลิงก์เชิญ UA
2. เมื่อผู้ใช้ B ได้รับและเข้าถึงแอปผ่านลิงก์เชิญ เซิร์ฟเวอร์จะวิเคราะห์ข้อมูลลิงก์เพื่อยืนยันว่า B เล่นเกมตามคำเชิญของ A: การรับข้อมูลสำหรับรางวัล
3. หากแอปไม่ได้ติดตั้งบนอุปกรณ์ของผู้ใช้ B ลิงก์จะนำทางพวกเขาไปติดตั้งแอป หากติดตั้งแล้ว แอปจะถูกเปิดใช้งานและข้อมูลของทั้ง A และ B จะถูกส่งไปยังเซิร์ฟเวอร์ส่งเสริมการขาย

การใช้ลิงก์โดยตรง¶

ลิงก์ตรงจะถูกจัดเตรียมเป็น URL เดียวและสามารถใช้สำหรับลิงก์เชิญชวนการเข้าถึงผู้ใช้ (UA) และฟีเจอร์การมีส่วนร่วมของผู้ใช้ (UE, deep link) ได้

ในการใช้ลิงก์โดยตรง ให้เพิ่มสิ่งต่อไปนี้ลงใน AndroidManifest.xml ของคุณใน SDK:

<manifest>
    <activity android:name="YOUR_MAIN_ACTIVITY">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="${applicationId}.directlink" />
    </intent-filter>
    </activity>
</manifest>

นอกจากนี้ โปรดดูที่ การตั้งค่าโปรโมชั่น ในคู่มือคอนโซลเพื่อกำหนดค่าลิงก์ตรงในคอนโซล

ลำดับการดำเนินการสำหรับ Hive การได้มาซึ่งผู้ใช้ (UA) และ Hive การมีส่วนร่วมของผู้ใช้ (UE) โดยใช้ลิงก์ตรงมีดังนี้:

1. ผู้ใช้ A แชร์ลิงก์โดยตรงผ่านลิงก์เชิญ UA
2. เมื่อผู้ใช้ B เข้าถึงแอปผ่านลิงก์ที่แชร์ เซิร์ฟเวอร์จะวิเคราะห์ข้อมูลลิงก์เพื่อยืนยันว่า B เล่นเกมตามคำเชิญของ A: การรับข้อมูลสำหรับรางวัล
3. ทันทีที่ B เข้าถึงแอป การกระทำ UE ที่รวมอยู่ในข้อมูลลิงก์จะถูกดำเนินการ (เช่น การดำเนินการฟีเจอร์ที่เกี่ยวข้องกับ Hive การแสดง UI หรือการเรียกใช้ฟีเจอร์ที่กำหนดเองโดยแอปเกมสำหรับ UE)
4. หากแอปไม่ได้ติดตั้งบนอุปกรณ์ของผู้ใช้ B ลิงก์จะนำทางพวกเขาไปติดตั้งแอป หากติดตั้งแล้ว แอปจะถูกเปิดและข้อมูลของทั้ง A และ B จะถูกส่งไปยังเซิร์ฟเวอร์โปรโมชัน