iOS

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

การใช้ลิงก์สากล¶

Universal Links ช่วยให้ผู้ใช้ติดตั้งและเปิดแอปผ่านหน้าการเชิญและเปิดใช้งานรางวัลสำหรับผู้เชิญ SDK สำหรับ 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 project navigator ให้เลือกโปรเจกต์ของคุณ
2. เลือกแอปของคุณจากรายการ TARGETS
3. คลิกที่แท็บ Signing & Capabilities
4. คลิกที่ปุ่ม + Capability ที่มุมซ้ายบนของแท็บ Signing & Capabilities
5. เพิ่ม Associated Domains จากรายการ
   • ตัวอย่างโดเมน: applinks:hive-ota.withhive.com
     
6. เปิดใช้งาน Associated Domains ใน Capabilities ของแอปใน Apple Developer Console

การใช้ลิงก์เชื่อมโยงลึกแบบ UA Deferred¶

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

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

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

1. เลือก TARGETS หลักในโปรเจกต์ Xcode ของคุณ

2. ในแท็บ Signing & Capabilities ให้เพิ่มโดเมนต่อไปนี้ภายใต้ Associated Domains:

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

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

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

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

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

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

ที่อยู่ปลายทางที่ผู้ใช้ไปยังผ่านลิงก์โดยตรงถูกตั้งค่าใน Hive Console > การจัดการลิงก์โดยตรง และปลายทางต่างๆ เช่น ตลาด, สถานที่เฉพาะภายในแอปเกม (ลิงก์ลึก), และมุมมองเว็บเฉพาะสามารถกำหนดค่าได้อย่างยืดหยุ่นตามสภาพแวดล้อมของระบบปฏิบัติการของผู้ใช้

ลำดับการดำเนินงานเมื่อใช้ลิงก์โดยตรงร่วมกับแอปเกมมีดังนี้:

1. แชร์ลิงก์ตรงเป็นลิงก์ปลายทางต่างๆ (ลิงก์ตลาด, ลิงก์ลึก, URL เว็บ)
2. เมื่อผู้ใช้คลิกที่ลิงก์ตรง จะทำงานตามที่กำหนดใน การจัดการลิงก์ตรงใน Hive Console: - การนำทางตลาด: ไม่คำนึงถึงสถานะการติดตั้งแอปเกมของผู้ใช้ ให้นำทางไปยังลิงก์ตลาดที่ตั้งค่าใน Hive Console > การจัดการลิงก์ตรง - การนำทางในแอป (ลิงก์ลึก) - หากแอปเกมติดตั้งในสภาพแวดล้อมของผู้ใช้: นำทางไปยังตำแหน่งที่กำหนดภายในแอปเกม (ลิงก์ลึกแบบสคีม) - หากแอปเกมไม่ได้ติดตั้งในสภาพแวดล้อมของผู้ใช้: นำทางไปยัง ตำแหน่งการติดตั้งแอปเกมในตลาด ที่รองรับโดยแต่ละสภาพแวดล้อมของ OS หรือ URL เปลี่ยนเส้นทางผู้ใช้ที่ไม่ได้ติดตั้ง ที่ตั้งค่าเมื่อสร้างลิงก์ลึก - URL เว็บ: ไม่คำนึงถึงสถานะการติดตั้งแอปเกมของผู้ใช้ ให้นำทางไปยังมุมมองเว็บเฉพาะนอกเกม
3. เมื่อผู้ใช้ดำเนินการตามลำดับ 'การเปิดแอปเกม > การเข้าสู่ระบบ > การมีส่วนร่วมของผู้ใช้ (UE) การดำเนินการ SetReady' เหตุการณ์ที่รวมอยู่ในข้อมูลลิงก์จะถูกดำเนินการในแอปเกม (ทำฟังก์ชันที่เกี่ยวข้องหรือการแสดง UI, ทำฟังก์ชันที่กำหนดใน UE เป็นต้น)

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

ในการใช้ฟังก์ชันลิงก์ตรงใน Hive SDK สำหรับ iOS ให้ตั้งค่า โปรเจกต์ Xcode ของคุณตามลำดับดังต่อไปนี้:

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

   * <i>applinks:sandbox-direct-link.withhive.com</i>: โดเมนลิงก์สากลสำหรับฟังก์ชันลิงก์ตรงที่ทำงานในสภาพแวดล้อมเซิร์ฟเวอร์แซนด์บ็อกซ์
   * <i>applinks:direct-link.withhive.com</i>: โดเมนลิงก์สากลสำหรับฟังก์ชันลิงก์ตรงที่ทำงานในสภาพแวดล้อมเซิร์ฟเวอร์การผลิต