Adjust

Adjust, pazarlama kampanyalarından veri toplayıp sunan önde gelen Mobil Ölçüm Ortağı (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 sayesinde abonelerinizin davranışlarını kolayca görebilir, neyi sevdiklerini öğrenebilir ve bu bilgileri hedefli ve etkili bir şekilde iletişim kurmak için kullanabilirsiniz. Bu entegrasyon, abonelik etkinliklerini Adjust’ta takip etmenize ve kampanyalarınızın tam olarak ne kadar gelir ürettiğini analiz etmenize olanak tanır.

Adapty ile Adjust arasındaki entegrasyon iki temel şekilde çalışır.

1. Adapty, Adjust’tan attribution verisi alır Adjust entegrasyonunu kurduktan sonra Adapty, Adjust’tan attribution verisi almaya başlar. Bu verilere kullanıcının profil sayfasından kolayca erişebilir ve görüntüleyebilirsiniz.

2. Adapty, abonelik olaylarını Adjust’a gönderir Adapty, entegrasyonunuzda yapılandırılmış tüm abonelik olaylarını Adjust’a gönderebilir. Böylece bu olayları Adjust 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 Adjust’a Bağlama

1. Adapty Kontrol Paneli’ni açın ve Integrations > Adjust sayfasına gidin.

2. Sayfanın üstündeki geçiş düğmesini “on” konumuna getirin.

3. Alanları doldurun ve erişim kimlik bilgilerinizi girin.

3. Adjust platformunda OAuth yetkilendirmeyi etkinleştirdiyseniz, iOS ve Android uygulamalarınız için entegrasyon sürecinde OAuth Token sağlamanız zorunludur.
4. Ardından iOS ve Android uygulamalarınız için app token’larını girin. Adjust kontrol panelinizi açtığınızda uygulamalarınızı göreceksiniz.

5. Listeden uygulamanızı seçin ve App Token’ı kopyalayın. Token’ı Adapty kontrol panelindeki ilgili alana yapıştırın.

Etkinlikleri ve etiketleri yapılandırma

Adjust, diğer platformlardan biraz farklı çalışır. Adjust kontrol panelinde etkinlikleri manuel olarak oluşturmanız, etkinlik token’larını almanız ve bunları Adapty’deki ilgili etkinliklere kopyalayıp yapıştırmanız gerekir.

Dolayısıyla buradaki ilk adım, Adapty’nin göndermesini istediğiniz tüm etkinlikler için etkinlik token’larını bulmaktır. Bunun için:

1. Adjust kontrol panelinde uygulamanızı açın ve Events sekmesine geçin.

1. Etkinlik token’ını kopyalayın ve Adapty’ye yapıştırın. Kimlik bilgilerinin altında, Adapty’den Adjust’a gönderebileceğiniz üç grup etkinlik bulunmaktadır. Adapty’nin sunduğu etkinliklerin tam listesine buradan ulaşabilirsiniz.

Adapty, sunucular arası entegrasyon aracılığıyla abonelik etkinliklerini Adjust’a gönderir. Bu sayede tüm abonelik etkinliklerini Adjust kontrol panelinizde görüntüleyebilir ve bunları edinim kampanyalarınızla ilişkilendirebilirsiniz.

Uygulamanızı Adjust ile bağlayın

Yukarıda açıklanan adımları tamamladıktan sonra, uygulamanıza aşağıdaki iki metodu ekleyin. Bu metodlar, uygulamanız ile Adjust arasındaki iletişimi sağlayacaktır:

1. Abonelik verilerini Adjust’a göndermek için: Adjust cihaz ID’sini setIntegrationIdentifier() SDK metoduna aktarın
2. Adjust’tan attribution verisi almak için: updateAttribution() SDK metoduyla attribution verisini güncelleyin

Adjust 5.0 veya sonraki sürümler için aşağıdaki örneği kullanın:

class AdjustModuleImplementation {
    func updateAdjustAdid() {
        Adjust.adid { adid in
            guard let adid else { return }
            // Adapty SDK 4.x
            Adapty.setIntegrationIdentifier(.adjustDeviceId(adid))
            // Adapty SDK 3.x
            Adapty.setIntegrationIdentifier(key: "adjust_device_id", value: adid)
        }
    }

    func updateAdjustAttribution() {
        Adjust.attribution { attribution in
            guard let attribution = attribution?.dictionary() else { return }
            // Adapty SDK 4.x
            Adapty.updateAttribution(attribution, source: .adjust)
            // Adapty SDK 3.x
            Adapty.updateAttribution(attribution, source: "adjust")
        }
    }
}

Adjust.getAdid { adid ->
    if (adid == null) return@getAdid

    Adapty.setIntegrationIdentifier("adjust_device_id", adid) { error ->
        if (error != null) {
            // handle the error
        }
    }
}

Adjust.getAttribution { attribution ->
    if (attribution == null) return@getAttribution

    Adapty.updateAttribution(attribution, "adjust") { error ->
        // handle the error
    }
}

Adjust.getAdid(adid -> {
    if (adid == null) return;

    Adapty.setIntegrationIdentifier("adjust_device_id", adid, error -> {
        if (error != null) {
            // handle the error
        }
    });
});

Adjust.getAttribution(attribution -> {
    if (attribution == null) return;

    Adapty.updateAttribution(attribution, "adjust", error -> {
        // handle the error
    });
});

var adjustConfig = new AdjustConfig(appToken, environment);

// Before submiting Adjust config...
adjustConfig.setAttributionCallbackListener(attribution => {
  // Make sure Adapty SDK is activated at this point
  // You may want to lock this thread awaiting of `activate`
  adapty.updateAttribution(attribution, "adjust");
});

// ...
Adjust.create(adjustConfig);

Adjust.getAdid((adid) => {
  if (adid)
    adapty.setIntegrationIdentifier("adjust_device_id", adid);
});

try {
  final adid = await Adjust.getAdid();

  if (adid == null) {
    // handle the error
  }
  
  await Adapty().setIntegrationIdentifier(
    key: "adjust_device_id", 
    value: adid,
  );
    
  final attributionData = await Adjust.getAttribution();

  var attribution = Map<String, String>();

  if (attributionData.trackerToken != null) attribution['trackerToken'] = attributionData.trackerToken!;
  if (attributionData.trackerName != null) attribution['trackerName'] = attributionData.trackerName!;
  if (attributionData.network != null) attribution['network'] = attributionData.network!;
  if (attributionData.adgroup != null) attribution['adgroup'] = attributionData.adgroup!;
  if (attributionData.creative != null) attribution['creative'] = attributionData.creative!;
  if (attributionData.clickLabel != null) attribution['clickLabel'] = attributionData.clickLabel!;
  if (attributionData.costType != null) attribution['costType'] = attributionData.costType!;
  if (attributionData.costAmount != null) attribution['costAmount'] = attributionData.costAmount!.toString();
  if (attributionData.costCurrency != null) attribution['costCurrency'] = attributionData.costCurrency!;
  if (attributionData.fbInstallReferrer != null) attribution['fbInstallReferrer'] = attributionData.fbInstallReferrer!;

  await Adapty().updateAttribution(attribution, source: "adjust");
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

// 1. To update ADID
Adjust.GetAdid((adid) => {
    if (adid == null) {
        // handle the error
        return;
    }

    Adapty.SetIntegrationIdentifier("adjust_device_id", adid, (error) => {
        if (error != null) {
            // handle the error
            return;
        }

    });
});

// 2. To update Attribution

// in your adjust configuration scope:
adjustConfig.AttributionChangedDelegate = AttributionChangedCallback;

public void AttributionChangedCallback(AdjustAttribution attributionData) {
    var attribution = new Dictionary<string, string>();

    if (attributionData.TrackerToken != null) attribution["trackerToken"] = attributionData.TrackerToken;
    if (attributionData.TrackerName != null) attribution["trackerName"] = attributionData.TrackerName;
    if (attributionData.Network != null) attribution["network"] = attributionData.Network;
    if (attributionData.Adgroup != null) attribution["adgroup"] = attributionData.Adgroup;
    if (attributionData.Creative != null) attribution["creative"] = attributionData.Creative;
    if (attributionData.ClickLabel != null) attribution["clickLabel"] = attributionData.ClickLabel;
    if (attributionData.CostType != null) attribution["costType"] = attributionData.CostType;
    if (attributionData.CostAmount != null) attribution["costAmount"] = attributionData.CostAmount.ToString();
    if (attributionData.CostCurrency != null) attribution["costCurrency"] = attributionData.CostCurrency;
    if (attributionData.FbInstallReferrer != null) attribution["fbInstallReferrer"] = attributionData.FbInstallReferrer;

    // you will probably need to install Newtonsoft.Json package, if not yet
    var attributionJsonString = Newtonsoft.Json.JsonConvert.SerializeObject(attribution);

    Adapty.UpdateAttribution(attributionJsonString, "adjust", (error) => {
        if (error != null) {
            // handle the error
        }
    });
}

Etkinlik yapısı

Adapty, seçilen etkinlikleri Adjust Entegrasyon sayfasında Events names bölümünde yapılandırıldığı şekilde Adjust’a gönderir. Her etkinlik şu şekilde yapılandırılmıştır:

{
   "event_token": "EVENT_TOKEN_FROM_CONFIG",
   "app_token": "APP_TOKEN_FROM_CONFIG",
   "s2s": 1,
   "environment": "production",
   "created_at_unix": 1709294400,
   "currency": "USD",
   "revenue": 9.99,
   "customer_user_id": "user_12345",
   "external_device_id": "user_12345",
   "ip_address": "192.168.100.1",
   "user_agent": "Mozilla/5.0 (Linux; Android 14; SM-S901B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36",
   "android_id": "875646c2-4a56-4211-8931-168532479006",
   "gps_adid": "875646c2-4a56-4211-8931-168532479006",
   "callback_params": "{\"integration_event_id\":\"550e8400-e29b-41d4-a716-446655440000\",\"customer_user_id\":\"user_12345\",\"vendor_product_id\":\"com.example.app.yearly.premium\",\"transaction_id\":\"GPA.3312-4512-1100-55923\",\"original_transaction_id\":\"GPA.3312-4512-1100-55923\",\"store\":\"play_store\",\"store_country\":\"US\",\"price_usd\":9.99,\"proceeds_usd\":8.49,\"price_local\":9.99,\"proceeds_local\":8.49,\"net_revenue_usd\":8.49,\"net_revenue_local\":8.49,\"tax_amount_usd\":0.0,\"tax_amount_local\":0.0,\"consecutive_payments\":3,\"rate_after_first_year\":false}",
   "partner_params": "{\"integration_event_id\":\"550e8400-e29b-41d4-a716-446655440000\",\"customer_user_id\":\"user_12345\",\"vendor_product_id\":\"com.example.app.yearly.premium\",\"transaction_id\":\"GPA.3312-4512-1100-55923\",\"original_transaction_id\":\"GPA.3312-4512-1100-55923\",\"store\":\"play_store\",\"store_country\":\"US\",\"price_usd\":9.99,\"proceeds_usd\":8.49,\"price_local\":9.99,\"proceeds_local\":8.49,\"net_revenue_usd\":8.49,\"net_revenue_local\":8.49,\"tax_amount_usd\":0.0,\"tax_amount_local\":0.0,\"consecutive_payments\":3,\"rate_after_first_year\":false}"
}

Where

Sorun giderme

Gelir tutarsızlığı

Adapty ile Adjust arasında gelir tutarsızlığı varsa, bunun nedeni muhtemelen tüm kullanıcılarınızın Adapty SDK’sını içeren uygulama sürümünü kullanmamasıdır. Veri tutarlılığını sağlamak için kullanıcılarınızı Adapty SDK’sının bulunduğu uygulama sürümüne güncellemeye zorlayabilirsiniz.