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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ประเภท ข้อความชื่อ ข้อความเนื้อหา สีข้อความ backgroundColor ข้อมูลรูปภาพ ปุ่มดำเนินการ ปุ่มการทำงานรอง
การ์ด
โมดัล
แบนเนอร์
รูปภาพเท่านั้น

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

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

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

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

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

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

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

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

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

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

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance