ปรับแต่งข้อความ Firebase In-App Messaging

การรับส่งข้อความในแอป Firebase มีชุดลักษณะการทำงานและประเภทข้อความที่กำหนดค่าไว้ล่วงหน้าซึ่งมีประโยชน์ โดยมีรูปลักษณ์เริ่มต้น แต่ในบางกรณี คุณอาจต้องการขยายลักษณะการทำงานและเนื้อหาข้อความ การรับส่งข้อความในแอปช่วยให้คุณเพิ่มการดำเนินการลงในข้อความและปรับแต่งรูปลักษณ์ของข้อความได้

เพิ่มการดำเนินการลงในข้อความ

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

ใช้เครื่องมือจัดการ Deep Link

Firebase In-App Messaging ใช้เครื่องมือจัดการลิงก์เพื่อประมวลผลการดำเนินการ SDK สามารถใช้แฮนเดิลได้หลายรายการ ดังนั้นหากแอปของคุณมีแฮนเดิลอยู่แล้ว Firebase In-App Messaging ก็สามารถใช้แฮนเดิลนั้นได้โดยไม่ต้องตั้งค่าเพิ่มเติม หากยังไม่มีเครื่องมือจัดการ คุณสามารถใช้ Firebase Dynamic Links ได้ ดูข้อมูลเพิ่มเติมได้ที่สร้างลิงก์แบบไดนามิกใน iOS

เพิ่มการดำเนินการลงในข้อความโดยใช้คอนโซล Firebase

เมื่อแอปมีตัวจัดการลิงก์แล้ว คุณก็พร้อมที่จะสร้างแคมเปญที่มีการดำเนินการ

1. ในคอนโซล Firebase ให้ไปที่ DevOps และการมีส่วนร่วม > การรับส่งข้อความ

2. เปิดเวิร์กโฟลว์เพื่อสร้างแคมเปญใหม่

   • หากนี่เป็นแคมเปญแรก ให้ทำดังนี้

     1. คลิกสร้างแคมเปญแรก
     2. เลือกข้อความในแอป Firebase แล้วคลิกสร้าง

   • หากคุณเคยสร้างแคมเปญไว้ก่อนหน้านี้ ให้ทำดังนี้

     1. ในแท็บแคมเปญ ให้คลิกแคมเปญใหม่
     2. เลือกการรับส่งข้อความในแอป

3. ทำตามวิธีการบนหน้าจอเพื่อตั้งค่าแคมเปญ

4. ระบุการ์ด ข้อความปุ่ม และการดำเนินการของปุ่ม การดำเนินการของรูปภาพ หรือการดำเนินการของแบนเนอร์ โดยการดำเนินการเป็น Deep Link ที่เกี่ยวข้อง

รูปแบบของการดำเนินการจะขึ้นอยู่กับเลย์เอาต์ข้อความที่คุณเลือก โมดัลจะมีปุ่มดำเนินการที่มีเนื้อหาข้อความ สีข้อความ และสีพื้นหลังของปุ่มที่ปรับแต่งได้ ในทางกลับกัน รูปภาพและแบนเนอร์ด้านบนจะกลายเป็นแบบอินเทอร์แอกทีฟและเรียกใช้การดำเนินการที่ระบุเมื่อแตะ

แก้ไขรูปลักษณ์ของข้อความ

Firebase In-App Messaging ช่วยให้คุณปรับแต่งการแสดงข้อความเพื่อเปลี่ยนวิธีที่แอปแสดงผลเลย์เอาต์ รูปแบบแบบอักษร รูปร่างปุ่ม และรายละเอียดอื่นๆ ของข้อความ คุณสามารถแก้ไขการแสดงข้อความได้ 2 วิธี ได้แก่ แก้ไขการแสดงผลFirebase In-App Messagingเริ่มต้น หรือสร้างคลังการแสดงข้อความของคุณเองตั้งแต่ต้น

แก้ไขการแสดงผลเริ่มต้น

วิธีที่ตรงไปตรงมาที่สุดในการปรับแต่งข้อความคือการสร้างโค้ดแสดงข้อความเริ่มต้นของ Firebase In-App Messaging

โคลนที่เก็บ firebase-ios-sdk

เริ่มต้นใช้งานโดยโคลนรุ่นล่าสุดของที่เก็บ firebase-ios-sdk แล้วเปิดไดเรกทอรี InAppMessaging

เลือกประเภทข้อความที่จะแก้ไข

เมื่อโคลนที่เก็บแล้ว คุณจะแก้ไขประเภทข้อความ Firebase In-App Messaging บางประเภทหรือทั้งหมดได้ ซึ่งได้แก่ Card, Modal, Banner และ ImageOnly แต่ละประเภทจะสอดคล้องกับเลย์เอาต์ข้อความในขั้นตอนการสร้างแคมเปญ Firebase In-App Messaging

ดังนั้นแต่ละประเภทจึงมีสิทธิ์เข้าถึงชุดข้อมูลที่แตกต่างกัน ซึ่งกำหนดโดยตัวเลือกการปรับแต่งแคมเปญในคอนโซล Firebase ดังนี้

แก้ไขโค้ดการแสดงผลข้อความ

คุณสามารถแก้ไขข้อความได้ตามต้องการโดยคำนึงถึงข้อจำกัดของประเภทข้อความ คุณสามารถสร้างแบนเนอร์ที่แสดงที่ด้านล่างของแอป ย้ายปุ่มดำเนินการในโมดัล ฝังข้อความในแอปในฟีดของผู้ใช้ หรือทำการแก้ไขอื่นๆ ที่จะทำให้รูปลักษณ์ของข้อความเหมาะกับแอปของคุณ

สิ่งสำคัญ 2 อย่างที่ควรคำนึงถึงเมื่อแก้ไขการแสดงข้อความมีดังนี้

• ไดเรกทอรีประเภทข้อความ: ข้อความแต่ละประเภทจะมีไดเรกทอรีแยกต่างหากพร้อมไฟล์ที่กำหนดตรรกะของประเภทนั้นๆ ดังนี้
  • Card
  • Modal
  • Banner
  • ImageOnly
• สตอรีบอร์ด: ไลบรารี InAppMessaging ยังมีไฟล์ .storyboard ที่ช่วยกำหนด UI สำหรับข้อความทั้ง 3 ประเภท ดังนี้
  • FIRInAppMessageDisplayStoryboard.storyboard

แก้ไขไฟล์ในไดเรกทอรีของประเภทข้อความที่ต้องการและส่วนที่เกี่ยวข้องของ .storyboard เพื่อสร้างการแสดงข้อความที่กำหนดเอง

อัปเดต Podfile เพื่อใช้โค้ด InAppMessaging ที่แก้ไขแล้ว

หากต้องการให้ Firebase In-App Messaging ใช้การแสดงข้อความที่แก้ไขแล้วแทนการแสดงผลเริ่มต้น ให้อัปเดต Podfile เพื่อใช้ไลบรารี InAppMessaging ที่กำหนดเอง โดยทำดังนี้

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'YourProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!

# Pods for YourProject
pod 'Firebase'

# Remove the default InAppMessaging pod:
# pod 'Firebase/InAppMessaging'

# Overwrite it with a version that points to your local copy:
pod `FirebaseInAppMessaging', :path => '~/Path/To/The/Cloned/Repo/'

end

สร้างคลังการแสดงข้อความของคุณเอง

คุณไม่จำเป็นต้องทำงานจากไลบรารี InAppMessaging เพื่อสร้าง UI สำหรับแสดงข้อความ นอกจากนี้ คุณยังเขียนโค้ดของคุณเองตั้งแต่ต้นได้ด้วย

สร้างคลาสที่ใช้โปรโตคอล InAppMessagingDisplay

Firebase In-App Messaging ใช้คลาส InAppMessaging เพื่อจัดการการสื่อสารระหว่างเซิร์ฟเวอร์ Firebase กับแอปของคุณ ซึ่งคลาสดังกล่าวจะใช้โปรโตคอล InAppMessagingDisplay เพื่อแสดงข้อความที่ได้รับ หากต้องการสร้างไลบรารีการแสดงผลของคุณเอง ให้เขียนคลาสที่ใช้โปรโตคอล

คำจำกัดความของโปรโตคอลและเอกสารประกอบเกี่ยวกับวิธีปฏิบัติตามโปรโตคอลอยู่ในไฟล์ FIRInAppMessagingDisplay.h ของไลบรารี InAppMessaging

ตั้งค่า messageDisplayComponent ให้ใช้ไลบรารีการแสดงข้อความ

InAppMessaging ใช้พร็อพเพอร์ตี้ messageDisplayComponent เพื่อกำหนดออบเจ็กต์ที่จะใช้เมื่อแสดงข้อความ ตั้งค่าพร็อพเพอร์ตี้นั้นเป็นออบเจ็กต์ของคลาสการแสดงข้อความที่กำหนดเอง เพื่อให้ Firebase In-App Messaging ทราบว่าต้องใช้ไลบรารีของคุณเพื่อแสดงผลข้อความ

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance