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

iOS

Hive SDK สำหรับ iOS มีฟีเจอร์การส่งเสริมการขาย เอกสารนี้อธิบายวิธีการกำหนดค่าแอป iOS เพื่อใช้ฟีเจอร์การส่งเสริมการขาย

การใช้ Universal Links

Universal Links ช่วยให้ผู้ใช้สามารถติดตั้งและเปิดแอปผ่านหน้าการเชิญและเปิดใช้งานรางวัลสำหรับผู้เชิญ SDK Hive สำหรับ iOS รองรับทั้งลิงก์ลึกที่ใช้ URI Scheme และลิงก์ลึกที่ใช้ Universal Link

การตั้งค่าทั่วไป

ในการใช้ Universal Links ให้ทำตามขั้นตอนการตั้งค่าทั่วไปเหล่านี้

การตั้งค่าเซิร์ฟเวอร์

  1. เตรียมค่าต่อไปนี้สำหรับสภาพแวดล้อมของคุณและบันทึกในไฟล์ apple-app-site-association:
    • TEAM ID: TEAM ID ของคุณจาก Apple Developer Console
    • Bundle Identifier: รหัส Bundle ของแอปที่ใช้ Universal Links
    • URL Path: เส้นทาง URL HTTP เพื่อสนับสนุน Universal Links
  2. อัปโหลดไฟล์ apple-app-site-association ไปยังรากของเว็บเซิร์ฟเวอร์ของคุณหรือไปยังไดเรกทอรีย่อย .well-known ไฟล์ต้องอยู่ในรูปแบบ JSON และไม่ควรมี นามสกุล.

    ไฟล์ apple-app-site-association ตัวอย่าง:

    {
        "applinks": {
            "apps": [],
            "details": [
                {
                    "appID": "--TEAM ID.--Bundle Identifier",
                    "paths": ["--URL Path"]
                }
            ]
        }
    }
    

    ตัวอย่างจาก Apple:

    {
        "applinks": {
            "apps": [],
            "details": [
                {
                    "appID": "9JA89QQLNQ.com.apple.wwdc",
                    "paths": ["/wwdc/news/", "/videos/wwdc/2015/*"]
                }, {
                    "appID": "ABCD1234.com.apple.wwdc",
                    "paths": ["*"]
                }
            ]
        }
    }
    

การตั้งค่าแอป iOS

ตั้งค่าแอป iOS ของคุณใน Xcode ดังนี้:

  1. ในตัวจัดการโปรเจกต์ Xcode ให้เลือกโปรเจกต์ของคุณ
  2. เลือกแอปของคุณจากรายการ TARGETS
  3. คลิกที่แท็บ Signing & Capabilities
  4. คลิกที่ปุ่ม + Capability ที่มุมซ้ายบนของแท็บ Signing & Capabilities
  5. เพิ่ม Associated Domains จากรายการ
    • ตัวอย่างโดเมน: applinks:hive-ota.withhive.com
  6. เปิดใช้งาน Associated Domains ในความสามารถของแอปใน Apple Developer Console

การใช้ลิงก์ลึกที่รอการประมวลผล

ลิงก์ลึกที่เลื่อนเวลาอนุญาตให้ผู้ใช้เปิดแอปผ่านลิงก์เชิญ Universal Link และเปิดใช้งานรางวัลสำหรับผู้เชิญ ต้องมีการอนุญาต UIPasteboard สำหรับลิงก์ลึกที่เลื่อนเวลา เมื่อผู้ใช้ติดตั้งและเปิดแอปเป็นครั้งแรกโดยใช้ลิงก์เชิญ อาจมีป๊อปอัป toast ปรากฏขึ้นในเวอร์ชัน iOS ที่ต่ำกว่า 16.1 และอาจมีป๊อปอัปคำขออนุญาตของระบบปรากฏขึ้นใน iOS 16.1 ขึ้นไป เพื่อปิดการใช้งานป๊อปอัปคำขออนุญาตของระบบ โปรดดูที่ คู่มือการดำเนินการส่งเสริมการขาย และตั้งค่าลิงก์ลึกที่เลื่อนเวลาเป็น "ปิดการใช้งาน"

iOS ต่ำกว่า 16.1

iOS 16.1 ขึ้นไป
Note

สำหรับคำแนะนำเพิ่มเติมในการตั้งค่าคอนโซลเพื่อสร้างลิงก์เชิญชวนแบบ Universal Link โปรดดูที่ คู่มือการดำเนินการส่งเสริมการขาย.
ข้อความป๊อปอัปคำขอสิทธิ์ของระบบไม่สามารถปรับแต่งโดยนักพัฒนาได้.

การตั้งค่าโครงการ Xcode

ในการใช้ลิงก์ลึกที่เลื่อนออกไป ให้กำหนดค่าโปรเจ็กต์ Xcode ของคุณดังนี้:

  1. เลือก TARGETS หลักในโปรเจกต์ Xcode ของคุณ
  2. ในแท็บ Signing & Capabilities ให้เพิ่มโดเมนต่อไปนี้ภายใต้ Associated Domains:

    • applinks:sandbox-promotion.qpyou.cn: โดเมน Universal Link สำหรับสภาพแวดล้อมเซิร์ฟเวอร์ sandbox ของ Hive
    • applinks:promotion.qpyou.cn: โดเมน Universal Link สำหรับสภาพแวดล้อมเซิร์ฟเวอร์ production ของ Hive

hive_config.xml การตั้งค่า

เพิ่มโค้ดต่อไปนี้ลงในไฟล์ hive_config.xml ใน SDK ของคุณ:

<universalLink>Universal link address (Domain/Path)</universalLink>

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

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

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

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

ถ้าแอปไม่ได้ติดตั้ง โปรดทราบสิ่งต่อไปนี้เมื่อใช้ลิงก์ตรง:

  • ลิงก์ตรงจะกระตุ้นการติดตั้งแอป แต่ถ้าแอปถูกเปิดใช้งานทันทีหลังการติดตั้ง ข้อมูลลิงก์ตรงจะไม่ถูกส่งมอบ
  • หลังการติดตั้ง ผู้ใช้ต้องคลิกที่ลิงก์ตรงอีกครั้งเพื่อส่งมอบข้อมูลลิงก์เมื่อเปิดแอป

ในการใช้ลิงก์ตรง โปรดดูที่ คู่มือการตั้งค่าการส่งเสริมการขาย และกำหนดค่าลิงก์ตรงในคอนโซล การตั้งค่าโครงการ Xcode ก็จำเป็นเช่นกัน

การตั้งค่าโปรเจกต์ Xcode

ในการใช้ลิงก์ตรง ให้กำหนดค่าโครงการ Xcode ของคุณดังนี้:

  1. เลือก TARGETS หลักในโปรเจกต์ Xcode ของคุณ
  2. ในแท็บ Signing & Capabilities ให้เพิ่มโดเมนต่อไปนี้ภายใต้ Associated Domains:

    • applinks:sandbox-direct-link.withhive.com: โดเมน Universal Link สำหรับสภาพแวดล้อมเซิร์ฟเวอร์ Hive sandbox (ฟีเจอร์ลิงก์ตรง)
    • applinks:direct-link.withhive.com: โดเมน Universal Link สำหรับสภาพแวดล้อมเซิร์ฟเวอร์ Hive production (ฟีเจอร์ลิงก์ตรง)