Singular, pazarlama kampanyalarından veri toplayıp sunan önde gelen Mobile Measurement Partner (MMP) platformlarından biridir. Bu sayede şirketler kampanya performanslarını takip edebilir. Adapty, mağazalardan gelen abonelik etkinliklerini tek bir yerden takip etmenizi sağlayan eksiksiz bir veri seti sunar. Adapty ile abonelerinizin davranışlarını kolayca izleyebilir, tercihlerini öğrenebilir ve bu bilgileri hedefli ve etkili bir şekilde iletişim kurmak için kullanabilirsiniz. Bu entegrasyon sayesinde Singular’da abonelik etkinliklerini takip edebilir ve kampanyalarınızın ne kadar gelir ürettiğini tam olarak analiz edebilirsiniz. Adapty, entegrasyonunuzda yapılandırılan tüm abonelik olaylarını Singular’a gönderebilir. Bu sayede söz konusu olayları Singular kontrol panelinde takip edebilirsiniz. Bu entegrasyon, reklam kampanyalarınızın etkinliğini değerlendirmek için oldukça faydalıdır.

Entegrasyonu kurma

Adapty’yi Singular’a Bağlayın

Singular entegrasyonunu kurmak için Adapty Kontrol Paneli’nde Integrations > Singular sayfasına gidin, toggle’ı açın ve alanları doldurun.

Aşağıdaki kimlik bilgileri mevcuttur:

• Singular SDK Key: Zorunlu. Singular uygulamanız için production SDK anahtarı.
• Singular SDK Key (Sandbox): İsteğe bağlı. Sandbox Singular uygulamanız için SDK anahtarı. Ayarlanmazsa sandbox olayları Singular’a gönderilmez. Her iki anahtar da Singular kontrol panelinde Developer tools -> SDK Keys -> SDK Key (not SDK Secret) altında bulunabilir:

Kimlik bilgilerinin altında, Adapty’den Singular’a gönderebileceğiniz üç grup etkinlik bulunur. Adapty’nin sunduğu etkinliklerin tam listesine buradan ulaşabilirsiniz. Adapty tarafından sağlanan varsayılan etkinlik adlarını kullanmanızı öneririz. Ancak etkinlik adlarını ihtiyaçlarınıza göre değiştirebilirsiniz. Adapty, abonelik etkinliklerini sunucudan sunucuya entegrasyon aracılığıyla Singular’a gönderecek; böylece tüm abonelik etkinliklerini Singular kontrol panelinizde görüntüleyebilir ve bunları edinim kampanyalarınızla ilişkilendirebilirsiniz.

Uygulamanızı Singular’a bağlama

Adapty ile Singular arasındaki entegrasyon sunucudan sunucuyadır. Bu nedenle uygulamanıza herhangi bir ek kod eklemeniz gerekmez.

Etkinlik yapısı

Adapty, etkinlikleri Singular’a sorgu parametreleri kullanarak GET isteğiyle gönderir. Her etkinlik şu şekilde yapılandırılmıştır:

{
  "n": "subscription_renewed",
  "a": "singular_sdk_key_123",
  "p": "iOS",
  "i": "com.example.app",
  "ip": "192.168.100.1",
  "idfa": "00000000-0000-0000-0000-000000000000",
  "idfv": "00000000-0000-0000-0000-000000000000",
  "ve": "17.0.1",
  "att_authorization_status": 3,
  "custom_user_id": "user_12345",
  "utime": 1709294400,
  "amt": 9.99,
  "cur": "USD",
  "purchase_product_id": "yearly.premium.6999",
  "purchase_transaction_id": "GPA.3383...",
  "e": "{\"is_revenue_event\":true,\"amt\":9.99,\"cur\":\"USD\",\"purchase_product_id\":\"yearly.premium.6999\",\"purchase_transaction_id\":\"GPA.3383...\"}"
}

Parametreler:

Parametre	Tür	Açıklama
n	String	Etkinlik adı (Adapty etkinliğinden eşlenir).
a	String	Singular SDK Key’iniz.
p	String	Platform (“iOS” veya “Android”).
i	String	Mağaza Uygulama Kimliği (Bundle ID).
ip	String	Kullanıcının IP adresi.
idfa	String	Yalnızca iOS. Reklamverenler için Kimlik (büyük harf).
idfv	String	Yalnızca iOS. Satıcılar için Kimlik (büyük harf).
aifa	String	Yalnızca Android. Google Reklam Kimliği (küçük harf).
andi	String	Yalnızca Android. Android Kimliği (küçük harf).
asid	String	Yalnızca Android. Uygulama Set Kimliği (küçük harf).
ve	String	İşletim sistemi sürümü.
att_authorization_status	Integer	Yalnızca iOS. ATT durumu (örn. yetkili için 3).
custom_user_id	String	Kullanıcının Müşteri Kullanıcı Kimliği.
utime	Long	Etkinliğin saniye cinsinden UNIX zaman damgası.
amt	Float	Gelir tutarı.
cur	String	Para birimi kodu (örn. “USD”).
purchase_product_id	String	Mağazadaki Ürün Kimliği.
purchase_transaction_id	String	Orijinal işlem kimliği.
e	String	Etkinlik ayrıntılarını içeren JSON dizesi (aşağıya bakın).

e parametresi (özel etkinlik verisi), şunları içeren JSON kodlu bir dizedir:

Parametre	Tür	Açıklama
is_revenue_event	Boolean	Etkinlik gelir içeriyorsa true.
amt	Float	Gelir tutarı.
cur	String	Para birimi kodu.
purchase_product_id	String	Mağazadaki Ürün Kimliği.
purchase_transaction_id	String	Orijinal işlem kimliği.