Braze
En önde gelen müşteri etkileşim çözümlerinden biri olan Braze, push bildirimleri, e-posta, SMS ve uygulama içi mesajlaşma için geniş bir araç yelpazesi sunar. Adapty’yi Braze ile entegre ederek tüm abonelik etkinliklerinize tek bir yerden kolayca erişebilir ve bu etkinliklere dayalı otomatik iletişimleri tetikleyebilirsiniz.
Adapty, tüm mağazalardan abonelik olaylarını tek bir yerden takip etmenizi sağlayan eksiksiz bir veri seti sunar ve bu veriler Braze’deki kullanıcı profillerinizi güncellemek için kullanılabilir. Adapty sayesinde abonelerinizin davranışlarını kolayca gözlemleyebilir, neleri sevdiklerini öğrenebilir ve bu bilgileri onlarla hedefli ve etkili bir şekilde iletişim kurmak için kullanabilirsiniz. Dolayısıyla bu entegrasyon, abonelik olaylarını Braze kontrol panelinizde takip etmenizi ve bunları edinme kampanyalarınızla eşleştirmenizi sağlar.
Adapty, abonelik etkinliklerini, kullanıcı özelliklerini ve satın almaları Braze’e gönderir; böylece aşağıda açıklanan kısa ve kolay entegrasyon sayesinde Braze push bildirimleri kullanarak müşterilerle hedefli iletişim kurabilirsiniz.
Braze entegrasyonunu nasıl kurarsınız
Adapty’yi Braze’e bağlamak için Adapty Kontrol Paneli’nde Integrations → Braze sayfasını açın, geçişi etkinleştirin ve kimlik bilgilerini doldurun:
- REST API key ve Braze Instance ID zorunludur.
- iOS App ID ve Android App ID isteğe bağlıdır.
- REST API anahtarını oluşturmak için Braze kontrol panelinde Settings → APIs and Identifiers bölümüne gidin ve Create API Key düğmesine tıklayın. Kullanıcı verisi izinleri altında
users.trackseçeneğini seçin. Braze, bir anahtarı oluşturduktan sonra izinlerini değiştirmenize izin vermez; bu nedenleusers.trackiçermeyen bir anahtarın yenisiyle değiştirilmesi gerekir. Ayrıntılar için Braze dokümanlarındaki REST API anahtarları oluşturma sayfasına bakın. - Braze Instance ID’sini bulmak için Braze kontrol panelinin URL’sini, Braze dokümanlarındaki instance tablosuyla karşılaştırın. Instance ID,
US-03veyaEU-01gibi bölgesel bir biçime sahiptir. Örneğin,dashboard-03.braze.comadresiUS-03’e karşılık gelir. - iOS App ID ve Android App ID değerlerini bulmak için Braze kontrol panelinde Settings → APIs and Identifiers → App Identifiers bölümüne gidin. Her uygulama için Identifier sütunundaki değeri kopyalayın. Ayrıntılar için Braze dokümanlarındaki App identifier sayfasına bakın.
Etkinlikler, kullanıcı özellikleri ve satın alımlar
Kimlik bilgilerinin altında, Adapty’den Braze’e gönderebileceğiniz üç grup etkinlik bulunur. İhtiyacınız olanları açmanız yeterli. Braze’e gönderilecek etkinliklerin adlarını da değiştirebilirsiniz. Adapty’nin sunduğu etkinliklerin tam listesine buradan ulaşabilirsiniz:
Adapty, abonelik etkinliklerini ve kullanıcı özelliklerini sunucudan sunucuya entegrasyon aracılığıyla Braze’e gönderir; böylece bunları Braze kontrol panelinizde görüntüleyebilir ve kampanyalarınızı buna göre yapılandırabilirsiniz.
Gelir içeren etkinlikler için (deneme süresi dönüşümleri ve yenilemeler gibi) Adapty bu bilgileri Braze’e satın alma olarak gönderir.
Adapty geliri Braze’e yalnızca eski satın alma etkinlikleri olarak gönderir. Braze, eski satın alma etkinliklerini bakım moduna almıştır ve yeni müşteriler için bu etkinlikleri etkinleştirmemektedir. Braze çalışma alanınız bunları kabul etmiyorsa, Braze gelir içeren her etkinliği HTTP 400 ve Legacy purchase ingestion is disabled mesajıyla reddeder. İlk satın almalar, yenilemeler, deneme süresi dönüşümleri ve iadeler gibi bu etkinlikler Braze’e hiç ulaşmaz; yalnızca gelirleri değil, etkinliklerin tamamı engellenir.
Entegrasyonu açmadan önce, Braze çalışma alanınızın eski satın alma etkinliklerini kabul ettiğinden emin olun. Ayrıntılar için Braze belgelerindeki Satın alma etkinlikleri sayfasına bakın.
Burada Braze’e gönderilen etkinlik özelliklerinin tam spesifikasyonlarını bulabilirsiniz.
Faydalı kullanıcı özellikleri
Adapty, Braze entegrasyonu için varsayılan olarak bazı kullanıcı özelliklerini gönderir. İhtiyaçlarınıza en uygun olanı belirlemek için aşağıda verilen listeye başvurabilirsiniz.
| Kullanıcı özelliği | Tür | Değer |
|---|---|---|
adapty_customer_user_id | String | Müşteri tarafından tanımlanan kullanıcının benzersiz tanımlayıcısının değerini içerir. Hem Adapty Kontrol Paneli’nde hem de Braze’de bulunabilir. |
adapty_profile_id | String | Adapty Kontrol Paneli’nde bulunabilen Adapty Kullanıcı Profili ID’sinin benzersiz tanımlayıcısının değerini içerir. |
environment | String | Kullanıcının sandbox mı yoksa production ortamında mı işlem yaptığını gösterir. Değerler |
store | String | Satın alma için kullanılan mağazanın adını içerir. Olası değerler:
|
vendor_product_id | String | Apple/Google mağazasındaki Ürün ID’sinin değerini içerir. Örn. org.locals.12345 |
subscription_expires_at | String | En son aboneliğin bitiş tarihini içerir. Değer biçimi: YYYY-MM-DDTHH:mm:ss.SSS+TZ Örn. 2023-02-15T17:22:03.000+0000 |
active_subscription | String | Herhangi bir satın alma/yenileme etkinliğinde true, abonelik sona erdiyse false olarak ayarlanır. |
period_type | String | Satın alma veya yenileme için en son dönem türünü gösterir. Olası değerler: Deneme dönemi için |
Tüm ondalıklı değerler tam sayıya yuvarlanır. String değerler değişmeden kalır.
Önceden tanımlanmış etiket listesine ek olarak, etiketleri kullanarak özel özellikler göndermek de mümkündür. Bu, etiketle birlikte gönderilebilecek veri türünde daha fazla esneklik sağlar ve bir ürün veya hizmete ilişkin belirli bilgilerin takibinde kullanışlıdır. Kullanıcı entegrasyon sayfasından Send user attributes onay kutusunu işaretlerse tüm özel kullanıcı özellikleri otomatik olarak Braze’e gönderilir.
SDK Yapılandırması
Adapty ve Braze’deki kullanıcı profillerini birbirine bağlamak için Braze SDK’yı Adapty ile aynı customer user ID ile yapılandırmanız veya .changeUser() metodunu kullanmanız gerekir:
Sorun Giderme
access_level_updated Event Feed’de başarısız olarak görünüyor
access_level_updated yalnızca webhook’a özgü bir event’tir. Adapty bu event’i bu entegrasyona hiçbir zaman göndermez. Ancak Adapty, etkinleştirilmiş her entegrasyon için bir sonuç kaydeder ve desteklenmeyen bir event başarısızlık olarak görüntülenir.