Attribution entegrasyonu

Adapty, abonelik olaylarını belirli pazarlama kampanyalarına atfetmek için üçüncü taraf hizmetlerle bilgi alışverişi yapabilir. Bu alışveriş sayesinde şunları yapabilirsiniz:

• Hangi pazarlama stratejilerinin en fazla gelir getirdiğini keşfetmek
• Adapty abonelik grafiklerini attribution’a göre filtrelemek
• Adapty abonelik verilerini analiz etmek için üçüncü taraf hizmetlerin özelliklerinden yararlanmak

Bunu iki şekilde kurabilirsiniz:

• Entegre attribution, minimum kurulum gerektirir ve Adapty’nin 9 popüler platformla veri alışverişi yapmasına olanak tanır.
• Manuel attribution, Adapty’ye göndermeden önce attribution verilerini üçüncü taraf servis API’lerinden kendiniz çekmenizi gerektirir.

Entegre attribution

Adapty, 9 popüler servisle kullanıma hazır attribution entegrasyonu sunar. Bu platformlar, Adapty’den abonelik verilerini otomatik olarak alabilir, her satın almayı işleyebilir ve uygun bir attribution ile yanıt verebilir.

Her platformun iş akışı farklı olmakla birlikte adımlar benzer şekilde basittir:

1. Otomatik veri paylaşımını ayarlayın. Adapty’nin seçtiğiniz platformla iletişim kurmasına izin verin.
2. Adapty SDK’yı entegre edin. Bazı platformlar attribution verisini ayarlamak için ek kod gerektirir.
3. Diğer etkinlik paylaşım hizmetlerini ve attribution kaynaklarını devre dışı bırakın. Etkinlik tekrarını ve veri çakışmalarını önlemek için bunu yapmanız önemlidir.

Ayrıntılı entegrasyon genel bakışı için platforma özgü kılavuzu okuyun:

• Adjust
• Airbridge
• Apple Search Ads
• AppsFlyer
• Asapty
• Branch
• Facebook Ads
• Singular
• Tenjin

Adjust, AppsFlyer, Branch ve Singular ayrıca sentetik olaylar alabilir — bir deneme sürümü veya aboneliğin ilk günlerini geride bıraktığına dair bir sinyal. Meta ve TikTok kampanyaları için Adapty Attribution, bunun yerine Nitelikli denemeler sunar.

Manuel attribution

Adapty, seçtiğiniz servisle entegre attribution sunmuyorsa attribution kaynağıyla veri alışverişi yapmak için kendi kodunuzu yazmanız gerekir.

1. Attribution servisinden veri alın. Attribution verilerini istemek için servisin API’ını kullanın.

2. Aldığınız attribution verileriyle bir sözlük oluşturun.

   Sözlük aşağıdaki anahtarları içerebilir:

   • status (organic, non-organic veya unknown)
   • channel
   • campaign
   • ad_group
   • ad_set
   • creative

Örnek:

let attribution = [
    "status": "non_organic",
    "channel": "Google Ads",
    "campaign": "Christmas Sale",
    "ad_group": "ad group 1",
    "ad_set": "ad set 1",
    "creative": "creative id 1"
]

val attribution = mapOf(
    "status" to "non_organic",
    "channel" to "Google Ads",
    "campaign" to "Christmas Sale",
    "ad_group" to "ad group 1",
    "ad_set" to "ad set 1",
    "creative" to "creative id 1"
)

    const attribution = {
      status: 'non_organic',
      channel: 'Google Ads',
      campaign: 'Christmas Sale',
      ad_group: 'ad group 1',
      ad_set: 'ad set 1',
      creative: 'creative id 1',
    };

   final attribution = <String, String>{
     'status': 'non_organic',
     'channel': 'Google Ads',
     'campaign': 'Christmas Sale',
     'ad_group': 'ad group 1',
     'ad_set': 'ad set 1',
     'creative': 'creative id 1',
   };

    using System.Collections.Generic;
    using Newtonsoft.Json;

    var attribution = new Dictionary<string, object> {
        ["status"] = "non_organic",
        ["channel"] = "Google Ads",
        ["campaign"] = "Christmas Sale",
        ["ad_group"] = "ad group 1",
        ["ad_set"] = "ad set 1",
        ["creative"] = "creative id 1"
    };

    var attributionJson = JsonConvert.SerializeObject(attribution);

    val attribution = mapOf(
        "status" to "non_organic",
        "channel" to "Google Ads",
        "campaign" to "Christmas Sale",
        "ad_group" to "ad group 1",
        "ad_set" to "ad set 1",
        "creative" to "creative id 1"
    )

   const attribution = {
     status: 'non_organic',
     channel: 'Google Ads',
     campaign: 'Christmas Sale',
     ad_group: 'ad group 1',
     ad_set: 'ad set 1',
     creative: 'creative id 1',
   };

3. Attribution verisini ayarlayın:

   Attribution sözlüğünü updateExternalAttribution metoduna (SDK 4.1 öncesinde updateAttribution olarak adlandırılırdı) iletin. Adapty attribution değerini kaydettikten sonra bu değeri artık değiştiremezsiniz:

    Adapty.updateExternalAttribution(attribution, provider: .custom) { error in
        if error == nil {
            // attribution data accepted for processing
        }
    }

Wait, I need to re-read the input. The input contains two TabItems, but the second one (Android (Kotlin)) is cut off. Let me return it exactly as given:

Adapty.updateExternalAttribution(attribution, provider: .custom) { error in
    if error == nil {
        // attribution data accepted for processing
    }
}

    Adapty.updateExternalAttribution(attribution, AdaptyExternalAttributionProvider.CUSTOM) { error ->
        if (error == null) {
            // attribution data accepted for processing
        }
    }

await adapty.updateExternalAttribution(attribution, 'custom');

   await Adapty().updateExternalAttribution(attribution, provider: AdaptyExternalAttributionProvider.custom);

Adapty.UpdateExternalAttribution(
    attributionJson,
    AdaptyExternalAttributionProvider.Custom,
    (error) => {
        // handle the error
    });

    Adapty.updateExternalAttribution(
        attribution,
        AdaptyExternalAttributionProvider.CUSTOM
    ).onSuccess {
        // attribution data accepted for processing
    }.onError { error ->
        // handle the error
    }

await adapty.updateExternalAttribution({ attribution, provider: 'custom' });

Parametreler:

• attribution (required): attribution verilerini içeren sözlük.
  • provider (required; SDK 4.1 sürümünden önce source olarak adlandırılır): attribution sağlayıcısı. Attribution sağlayıcınız entegre attribution desteklemiyorsa özel değeri kullanın — iOS’ta .custom, Android ve Kotlin Multiplatform’da AdaptyExternalAttributionProvider.CUSTOM, Unity’de AdaptyExternalAttributionProvider.Custom, Flutter’da AdaptyExternalAttributionProvider.custom, Capacitor ve React Native’de ise 'custom' string’i. SDK 4.1 sürümünden önce "custom" string’ini kullanın.

4. Diğer etkinlik paylaşım hizmetlerini ve attribution kaynaklarını devre dışı bırakın — etkinlik tekrarını ve veri çakışmalarını önlemek için.

Veri sorunlarını önleyin

Tek bir attribution kaynağı seçin

Attribution entegrasyonunu birden fazla platformda aynı anda etkinleştirmeyin. Adapty yalnızca tek bir attribution kaynağını kabul edebilir ve bir profilin kayıtlı attribution bilgisini yalnızca profil oluşturulduktan sonraki ilk 15 dakika içinde güncelleyebilir.

Birden fazla attribution kaynağı etkinleştirirseniz, Adapty en fazla veriye sahip kaynağı seçer; bu, en doğru veriyi içeren kaynak olmayabilir.

Örneğin, organik olmayan Apple Search Ads attribution iOS’ta her zaman öncelikli olur. Apple Search Ads attribution’ını kapatmak için App Settings -> Apple Search Ads sekmesini açın ve Receive Apple Search Ads attribution anahtarını kapatın.

Bir profile attribution verisi eklendikten sonra, profil oluşturulduktan 15 dakika sonra Adapty’e ulaşan attribution verileri mevcut attribution’ı değiştirmez; attribution sağlayıcınız kendi tarafında kurulumu daha sonra yeniden ilişkilendirse bile bu geçerlidir. Profilin attribution verilerini eksiksiz tutmak için, attribution SDK’nız sonucu döndürür döndürmez tam attribution verilerini Adapty’e gönderin.

Etkinlik tekrarlarından kaçının

Gerçek zamanlı abonelik verilerini attribution servislerinizle paylaşmak için Adapty kullanıyorsanız aynı amaca hizmet eden diğer servisleri devre dışı bırakmanız gerekir. Facebook hesabınızı AppsFlyer, Adjust veya Branch’e bağladıysanız, vazgeçmediğiniz sürece etkinlikleriniz bu servislere otomatik olarak iletilir.

Tekrarlanan etkinlikler analizlerinizi çarpıtabilir ve verileri yorumlamayı güçleştirebilir. Adapty etkinlik paylaşımını yapılandırdıktan sonra, üçüncü taraf etkinlik iletme özelliklerini kapatın.