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


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

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

คุณสามารถใช้การกระทำในแอปเพื่อนำผู้ใช้ไปยัง หรือหน้าจอที่เฉพาะเจาะจงในแอปของคุณ

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

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

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

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

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

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

หมายเหตุ: ผลิตภัณฑ์นี้ไม่พร้อมใช้งานในเป้าหมาย macOS, Mac Catalyst, App Clip หรือ watchOS

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

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

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

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

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

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

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

ประเภท ข้อความชื่อ ข้อความเนื้อหา textColor backgroundColor imageData ปุ่มดำเนินการ secondaryActionButton
การ์ด
โมดัล
แบนเนอร์
ImageOnly

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

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

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

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

แก้ไขไฟล์ในประเภทข้อความที่คุณต้องการ ไดเรกทอรีและข้อมูลที่เกี่ยวข้อง ของ .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