Firebase Uygulama İçi Mesajlaşma mesajlarının davranışını değiştirin

Firebase Uygulama İçi Mesajlaşma, çok az kodlama veya hiç kodlama yapmadan zengin kullanıcı etkileşimleri oluşturmanıza, yapılandırmanıza ve hedeflemenize olanak tanır. Bu sayede, mesajlaşma etkinliklerini gerçek kullanıcı özelliklerine, etkinliklerine ve seçimlerine bağlamak için Google Analytics'ün hazır özelliklerinden yararlanabilirsiniz. Bazı ek Firebase In-App Messaging SDK entegrasyonlarıyla, uygulama içi mesajların davranışını daha da özelleştirebilir, kullanıcılar mesajlarla etkileşime geçtiğinde yanıt verebilir, Analytics çerçevesinin dışında mesaj etkinlikleri tetikleyebilir ve kullanıcıların mesajlaşma etkileşimleriyle ilgili kişisel verilerinin paylaşımını kontrol etmelerine olanak tanıyabilirsiniz.

Kullanıcılar uygulama içi mesajlarla etkileşimde bulunduğunda yanıtlayın

İşlemlerle, kullanıcıları bir web sitesine veya uygulamanızdaki belirli bir ekrana yönlendirmek için uygulama içi mesajlarınızı kullanabilirsiniz.

Kodunuz temel etkileşimlere (tıklamalar ve kapatmalar), gösterimler (mesajlarınızın doğrulanmış görüntülemeleri) ve SDK tarafından kaydedilen ve onaylanan hataları görüntülemeye yanıt verebilir. Örneğin, mesajınız Kart modülü olarak oluşturulduğunda, kullanıcının Kart'ta iki URL'den hangisini tıkladığını izlemek ve takip etmek isteyebilirsiniz.

Kart etkileşimlerini yönetmek için bir DisplayDelegate uygulama

Uygulama içi mesajla etkileşim olduğunda çağrılacak bir uygulama içi mesaj görüntüleme temsilcisi kaydedebilirsiniz. Bunu yapmak için InAppMessagingDisplayDelegate protokolüne göre bir sınıf uygulayın ve bu sınıfı InAppMessaging örneğinde temsilci mülk olarak ayarlayın.

Bir kullanıcının kart stilindeki bir mesajda hangi bağlantıyı tıkladığını izlemek istediğinizi varsayalım. DisplayDelegate protokolüne göre messageClicked yöntemini uygulayan bir sınıf tanımlayın. Böylece, kullanıcının tıkladığı bağlantıya erişebilirsiniz.

// 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

// 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

Uygulama içi mesajları programatik olarak tetikleyin

Firebase In-App Messaging varsayılan olarak, ek entegrasyona gerek kalmadan Firebase için Google Analytics etkinlikleri ile uygulama içi mesajları tetiklemenize olanak tanır. Ayrıca, Firebase In-App Messaging SDK'sının programatik tetikleyicileriyle etkinlikleri programatik olarak manuel olarak da tetikleyebilirsiniz.

Uygulama içi mesajlaşma kampanyası derleyicisinde yeni bir kampanya oluşturun veya mevcut bir kampanyayı seçin. Derleyici iş akışının Planlama adımında, yeni oluşturulan veya mevcut bir mesajlaşma etkinliğinin etkinlik kimliğini not edin. Not ettikten sonra, uygulamanızı etkinliği kimliğine göre tetikleyecek şekilde donatın.

…
// somewhere in the app's code
InAppMessaging.inAppMessaging().triggerEvent("exampleTrigger");

…
// somewhere in the app's code
[[FIRInAppMessaging inAppMessaging] triggerEvent:@"exampleTrigger"];

Kampanya özel meta verilerini kullanma

Kampanyalarınızda bir dizi anahtar/değer çiftinde özel veriler belirtebilirsiniz. Kullanıcılar mesajlarla etkileşime geçtiğinde bu verileri kullanarak örneğin promosyon kodu gösterebilirsiniz.

class CardActionFiamDelegate : NSObject, InAppMessagingDisplayDelegate {

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

@implementation CardActionFiamDelegate

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

@end
CardActionFiamDelegate.m

Uygulama içi mesajları geçici olarak devre dışı bırakma

Varsayılan olarak Firebase In-App Messaging, bir uygulamanın mevcut durumundan bağımsız olarak, tetikleyici koşul sağlandığında mesajları oluşturur. Mesajların gösterilmesini herhangi bir nedenle engellemek istiyorsanız (ör. ödeme işleme ekranlarının sırasını kesintiye uğratmamak için) SDK'nın messageDisplaySuppressed mülkünü burada gösterildiği gibi Objective-C'te kullanın:

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

Mülkün YES olarak ayarlanması Firebase In-App Messaging'un mesaj göstermesini engellerken NO, mesaj göstermeyi yeniden etkinleştirir. SDK, uygulama yeniden başlatılırken mülkü NO olarak sıfırlar. Engellenen iletiler SDK tarafından yoksayılır. Engelleme kapalıyken Firebase In-App Messaging tarafından gösterilebilmesi için tetikleyici koşullarının tekrar karşılanması gerekir.

Mesajları devre dışı bırakma seçeneğini etkinleştirme

Varsayılan olarak Firebase In-App Messaging, mesajlaşma kampanyalarında hedeflediğiniz tüm uygulama kullanıcılarına otomatik olarak mesaj gönderir. Firebase In-App Messaging SDK, bu mesajları iletmek için her kullanıcının uygulamasını tanımlamak üzere Firebase yükleme kimliğini kullanır. Yani In-App Messaging, yükleme kimliğine bağlı istemci verilerini Firebase sunucularına göndermelidir. Kullanıcılara gönderdikleri veriler üzerinde daha fazla kontrol vermek istiyorsanız otomatik veri toplamayı devre dışı bırakın ve kullanıcılara veri paylaşımını onaylama fırsatı verin.

Bunun için Firebase In-App Messaging için otomatik başlatmayı devre dışı bırakmanız ve hizmeti etkinleştiren kullanıcılar için manuel olarak başlatmanız gerekir:

1. Info.plist dosyanızdaki yeni bir anahtarla otomatik başlatmayı kapatın:

   • Anahtar: FirebaseInAppMessagingAutomaticDataCollectionEnabled
   • Değer: NO

2. Seçili kullanıcılar için Firebase In-App Messaging'ü manuel olarak başlatın:

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

   automaticDataCollectionEnabled değerini YES olarak ayarladıktan sonra bu değer, uygulama yeniden başlatılırken devam eder ve Info.plist değerinizi geçersiz kılar. Örneğin, bir kullanıcı daha sonra veri toplamayı devre dışı bırakırsa özelliği NO olarak ayarlayarak ilk başlatmayı tekrar devre dışı bırakabilirsiniz.