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 olaylarını tek bir yerden takip etmenizi sağlayan eksiksiz bir veri seti sunar. Adapty ile kullanıcılarınızın davranışlarını kolayca inceleyebilir, tercihlerini öğrenebilir ve bu bilgileri onlarla hedefli ve etkili bir şekilde iletişim kurmak için kullanabilirsiniz. Bu entegrasyon sayesinde abonelik olaylarını Adjust’ta takip edebilir ve kampanyalarınızın tam olarak ne kadar gelir ürettiğini analiz edebilirsiniz.

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

1. Adapty, Adjust’tan attribution verisi alır
   Adjust entegrasyonunu kurduğunuzda 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ılan 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 “açık” konuma getirin.

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

3. Adjust platformunda OAuth yetkilendirmesini 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 bilgilerini girin. Adjust kontrol panelinizi açın; uygulamalarınızı orada göreceksiniz.

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

Olayları ve etiketleri yapılandırma

Adjust, diğer platformlardan biraz farklı çalışır. Adjust kontrol panelinde olayları manuel olarak oluşturmanız, olay token’larını almanız ve bunları Adapty’deki ilgili olaylara kopyalamanız gerekir.

Bu nedenle ilk adım, Adapty’nin göndermesini istediğiniz tüm olayların token’larını bulmaktır:

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

1. Olay token’ını kopyalayın ve Adapty’ye yapıştırın. Kimlik bilgilerinin altında, Adapty’den Adjust’a gönderebileceğiniz üç olay grubu bulunur. Adapty’nin sunduğu olayların tam listesine buradan ulaşabilirsiniz.

Adapty, abonelik olaylarını sunucudan sunucuya (server-to-server) entegrasyon yöntemiyle Adjust’a gönderir; böylece tüm abonelik olaylarını Adjust kontrol panelinizde görüntüleyebilir ve bunları edinim kampanyalarınızla ilişkilendirebilirsiniz.

Uygulamanızı Adjust’a bağlama

Yukarıdaki adımları tamamladıktan sonra uygulamanıza şu iki metodu ekleyin. Bu metotlar, uygulamanız ile Adjust arasındaki iletişimi kurar:

1. Adjust’a abonelik verisi göndermek için: Adjust cihaz kimliğini setIntegrationIdentifier() SDK metoduna aktarın
2. Adjust’tan attribution verisi almak için: updateAttribution() SDK metoduyla attribution verilerini 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.setIntegrationIdentifier(key: "adjust_device_id", value: adid)
    }
}
func updateAdjustAttribution() {
    Adjust.attribution { attribution in
        guard let attribution = attribution?.dictionary() else { 
            return
        }
        
        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
        }
    });
}

Olay yapısı

Adapty, seçilen olayları Adjust Entegrasyon sayfasındaki Events names bölümünde yapılandırıldığı şekilde Adjust’a gönderir. Her olay şu yapıdadı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}"
}

Parametreler:

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.