ปรับแต่งข้อความ 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 แล้วเปิด ไดเรกทอรี InAppMessaging

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

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

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

ประเภท titleText bodyText textColor backgroundColor imageData actionButton 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