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

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

เพิ่มการดำเนินการให้กับข้อความของคุณ

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

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

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

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

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

ปรับเปลี่ยนรูปลักษณ์ของข้อความ

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

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

ปรับเปลี่ยนการแสดงผลเริ่มต้น

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

โคลน repo ของ firebase-ios-sdk

ในการเริ่มต้น ให้โคลน repo firebase-ios-sdk รุ่นล่าสุด และเปิด ไดเรกทอรี InAppMessaging

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

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

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

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

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

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

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

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

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