ปรับแต่งข้อความ 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's โค้ดการแสดงข้อความเริ่มต้น

โคลนที่เก็บ 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
• Storyboard: ไลบรารี 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

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

คุณสามารถสร้าง UI สำหรับแสดงข้อความได้โดยไม่จำกัดเฉพาะการใช้ไลบรารี InAppMessaging นอกจากนี้ คุณยังเขียนโค้ดของคุณเองตั้งแต่ต้นได้อีกด้วย

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

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

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

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

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

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance