ปรับเปลี่ยนลักษณะการทำงานของข้อความการรับส่งข้อความในแอป Firebase


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

ตอบสนองเมื่อผู้ใช้โต้ตอบกับข้อความในแอป

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

โค้ดของคุณสามารถตอบสนองต่อการโต้ตอบพื้นฐาน (การคลิกและการปิด) การแสดงผล (ยอดดูที่ยืนยันแล้วของข้อความ) และแสดงข้อผิดพลาดที่บันทึกไว้และ SDK ยืนยัน ตัวอย่างเช่น เมื่อข้อความของคุณเขียนขึ้นในรูปแบบโมดัลการ์ด คุณอาจต้องการติดตามและติดตามผลว่าผู้ใช้คลิก URL ใดใน 2 รายการบนการ์ด

ใช้ DisplayDelegate เพื่อจัดการการโต้ตอบกับการ์ด

คุณสามารถลงทะเบียนผู้รับมอบสิทธิ์การแสดงข้อความในแอปที่จะเรียกใช้ทุกครั้งที่มีการโต้ตอบกับข้อความในแอป ในการดำเนินการ ให้ใช้คลาสตามโปรโตคอล InAppMessagingDisplayDelegate และตั้งค่าเป็นพร็อพเพอร์ตี้การมอบสิทธิ์ในอินสแตนซ์ InAppMessaging

สมมติอีกครั้งว่าคุณต้องการติดตามลิงก์ที่ผู้ใช้คลิกในข้อความสไตล์การ์ด ให้กําหนดคลาสที่ใช้เมธอด messageClicked ตามโปรโตคอล DisplayDelegate ซึ่งจะช่วยให้คุณเข้าถึงลิงก์ที่ผู้ใช้คลิกได้

Swift

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

โปรดดูข้อมูลอ้างอิงเกี่ยวกับตัวรับมอบสิทธิ์การแสดงผลของ Swift สำหรับชุดเมธอดการเรียกกลับที่ติดตั้งใช้งานได้และพารามิเตอร์ รวมถึง InAppMessagingAction


// In CardActionFiamDelegate.swift
class CardActionFiamDelegate : NSObject, InAppMessagingDisplayDelegate {

    func messageClicked(_ inAppMessage: InAppMessagingDisplayMessage) {
        // ...
    }

    func messageDismissed(_ inAppMessage: InAppMessagingDisplayMessage,
                          dismissType: FIRInAppMessagingDismissType) {
        // ...
    }

    func impressionDetected(for inAppMessage: InAppMessagingDisplayMessage) {
        // ...
    }

    func displayError(for inAppMessage: InAppMessagingDisplayMessage, error: Error) {
        // ...
    }

}
CardActionFiamDelegate.swift


// In AppDelegate.swift
// Register the delegate with the InAppMessaging instance
let myFiamDelegate = CardActionFiamDelegate()
InAppMessaging.inAppMessaging().delegate = myFiamDelegate;
AppDelegate.swift

Objective-C

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

โปรดดูการอ้างอิงผู้รับมอบสิทธิ์ Display ของ Objective-C เพื่อดูชุดเมธอด Callback ที่สามารถใช้ได้และพารามิเตอร์ของเมธอดดังกล่าว ซึ่งรวมถึง FIRInAppMessagingDisplayMessage


// In CardActionFiamDelegate.h
@interface CardActionFiamDelegate : NSObject <FIRInAppMessagingDisplayDelegate>
@end

// In CardActionFiamDelegate.m
@implementation CardActionFiamDelegate

- (void)displayErrorForMessage:(nonnull FIRInAppMessagingDisplayMessage *)inAppMessage
                         error:(nonnull NSError *)error {
    // ...
}

- (void)impressionDetectedForMessage:(nonnull FIRInAppMessagingDisplayMessage *)inAppMessage {
    // ...
}

- (void)messageClicked:(nonnull FIRInAppMessagingDisplayMessage *)inAppMessage {
    // ...
}

- (void)messageDismissed:(nonnull FIRInAppMessagingDisplayMessage *)inAppMessage
             dismissType:(FIRInAppMessagingDismissType)dismissType {
    // ...
}

@end
CardActionFiamDelegate.m


// In AppDelegate.m
CardActionFiamDelegate *myFiamDelegate = [CardActionFiamDelegate new];
[FIRInAppMessaging inAppMessaging].delegate = myFiamDelegate;
AppDelegate.m

ทริกเกอร์ข้อความในแอปแบบเป็นโปรแกรม

Firebase In-App Messaging โดยค่าเริ่มต้นจะให้คุณเรียกใช้ข้อความในแอปด้วยเหตุการณ์ Google Analytics สําหรับ Firebase ได้โดยไม่ต้องผสานรวมเพิ่มเติม นอกจากนี้ คุณยังทริกเกอร์เหตุการณ์ด้วยโปรแกรมด้วยตนเองได้ด้วยทริกเกอร์แบบเป็นโปรแกรมของ Firebase In-App Messaging SDK

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

Swift

หมายเหตุ: ผลิตภัณฑ์นี้ไม่พร้อมใช้งานในเป้าหมาย macOS, Mac Catalyst, App Clip หรือ watchOS 
…
// somewhere in the app's code
InAppMessaging.inAppMessaging().triggerEvent("exampleTrigger");

Objective-C

หมายเหตุ: ผลิตภัณฑ์นี้ใช้ไม่ได้ในเป้าหมาย macOS, Mac Catalyst, App Clip หรือ watchOS 
…
// somewhere in the app's code
[[FIRInAppMessaging inAppMessaging] triggerEvent:@"exampleTrigger"];

ใช้ข้อมูลเมตาที่กำหนดเองของแคมเปญ

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

Swift

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

    func messageClicked(_ inAppMessage: InAppMessagingDisplayMessage) {
	// Get data bundle from the inapp message
	let appData = inAppMessage.appData
	// ...
    }
}
CardActionFiamDelegate.swift

Objective-C

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

- (void)messageClicked:(nonnull FIRInAppMessagingDisplayMessage *)inAppMessage {
	appData = inAppMessage.appData
	// ...
}

@end
CardActionFiamDelegate.m

ปิดใช้ข้อความในแอปชั่วคราว

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

  [FIRInAppMessaging inAppMessaging].messageDisplaySuppressed = YES;
ViewController.m

การตั้งค่าพร็อพเพอร์ตี้เป็น YES จะป้องกันไม่ให้ Firebase In-App Messaging แสดงข้อความ ส่วน NO จะเปิดใช้การแสดงข้อความอีกครั้ง SDK จะรีเซ็ตพร็อพเพอร์ตี้เป็น NO เมื่อแอปรีสตาร์ท SDK จะไม่สนใจข้อความที่ถูกระงับ ต้องเป็นไปตามเงื่อนไขทริกเกอร์อีกครั้งเมื่อการระงับปิดอยู่ ก่อนที่ Firebase In-App Messaging จะแสดงได้

เปิดใช้การนำส่งข้อความเพื่อเลือกไม่รับ

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

โดยคุณต้องปิดใช้การเริ่มต้นอัตโนมัติสําหรับ Firebase In-App Messaging และเริ่มต้นบริการด้วยตนเองสําหรับผู้ใช้ที่เลือกใช้ โดยทําดังนี้

  1. ปิดการเริ่มต้นอัตโนมัติด้วยคีย์ใหม่ในไฟล์ Info.plist โดยทำดังนี้

    • แป้น: FirebaseInAppMessagingAutomaticDataCollectionEnabled
    • ค่า: NO

  2. เริ่มต้น Firebase In-App Messaging สำหรับผู้ใช้ที่เลือกด้วยตนเอง:

    // Only needed if FirebaseInAppMessagingAutomaticDataCollectionEnabled is set to NO
// in Info.plist
[FIRInAppMessaging inAppMessaging].automaticDataCollectionEnabled = YES;
    ViewController.m

    เมื่อตั้งค่า automaticDataCollectionEnabled เป็น YES ค่าจะยังคงอยู่ผ่านแอปรีสตาร์ทโดยลบล้างค่าใน Info.plist หากต้องการปิดใช้การเริ่มต้นอีกครั้ง เช่น ในกรณีที่ผู้ใช้เลือกไม่ใช้การเก็บรวบรวมในภายหลัง ให้ตั้งค่าพร็อพเพอร์ตี้เป็น NO