Adjust

Adjust — одна из ведущих платформ Mobile Measurement Partner (MMP), которая собирает и представляет данные маркетинговых кампаний, помогая компаниям отслеживать их эффективность.

Adapty предоставляет полный набор данных для отслеживания событий подписок из сторов в одном месте. С Adapty вы можете легко видеть поведение подписчиков, понимать их предпочтения и использовать эту информацию для точечной и эффективной коммуникации. Интеграция позволяет отслеживать события подписок в Adjust и точно анализировать, сколько дохода приносят ваши кампании.

Интеграция Adapty и Adjust работает в двух направлениях.

Adapty получает данные атрибуции от Adjust
После настройки интеграции Adapty начнёт получать данные атрибуции от Adjust. Вы сможете просматривать их на странице профиля пользователя.

98769d9-CleanShot_2023-08-11_at_14.39.182x.webp

Adapty отправляет события подписок в Adjust
Adapty может отправлять все события подписок, настроенные в интеграции, в Adjust. Это позволяет отслеживать их в дашборде Adjust и оценивать эффективность рекламных кампаний.

Настройка интеграции

Подключение Adapty к Adjust

Откройте дашборд Adapty и перейдите в Integrations > Adjust.
Включите переключатель вверху страницы.
Заполните поля и укажите учётные данные.

5064125-CleanShot_2023-08-11_at_14.43.382x.webp

Если на платформе Adjust включена OAuth-авторизация, при интеграции необходимо указать OAuth Token для iOS и Android приложений.
Затем укажите app tokens для ваших iOS и Android приложений. Откройте дашборд Adjust — там вы увидите свои приложения.

У вас могут быть разные приложения Adjust для iOS и Android, поэтому в Adapty предусмотрены два независимых раздела. Если у вас одно приложение Adjust, просто укажите одинаковые данные в обоих разделах.

Выберите приложение из списка и скопируйте App Token. Вставьте токен в соответствующее поле на дашборде Adapty.

Настройка событий и тегов

Adjust работает иначе, чем другие платформы. Вам нужно вручную создать события в дашборде Adjust, получить токены событий и вставить их в соответствующие события в Adapty.

Для начала найдите токены событий для всех событий, которые вы хотите отправлять из Adapty. Для этого:

В дашборде Adjust откройте приложение и перейдите на вкладку Events.

Скопируйте токен события и вставьте его в Adapty. Ниже учётных данных расположены три группы событий, которые можно отправлять из Adapty в Adjust. Полный список событий Adapty доступен здесь.

Adapty будет отправлять события подписок в Adjust через интеграцию server-to-server, что позволит просматривать все события в дашборде Adjust и связывать их с вашими рекламными кампаниями.

Обратите внимание на следующее:

Adjust не поддерживает события старше 58 дней. Если событие произошло более 58 дней назад, Adapty всё равно отправит его в Adjust, но время события будет заменено текущим временем.
Adjust не поддерживает IPv6. Если вы отключите сбор IP-адресов в SDK в App settings или при активации SDK, может быть отправлен только серверный IPv6-адрес, что приведёт к сбою отслеживания — оставляйте сбор IP-адресов в SDK включённым, чтобы использовался IPv4.

Подключение приложения к Adjust

После выполнения описанных выше шагов добавьте в приложение два метода, которые обеспечат связь между приложением и Adjust:

Для отправки данных подписок в Adjust: передайте Adjust device ID в метод SDK setIntegrationIdentifier()
Для получения данных атрибуции от Adjust: обновите данные атрибуции с помощью метода SDK updateAttribution()

Для Adjust версии 5.0 и выше используйте следующий пример:

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
        }
    });
}

Структура события

Adapty отправляет выбранные события в Adjust в соответствии с настройками в разделе Events names на странице интеграции с Adjust. Каждое событие имеет следующую структуру:

{
   "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}"
}

Где

Параметр	Тип	Описание
`app_token`	String	Токен приложения Adjust из настроек интеграции.
`event_token`	String	Токен события Adjust, сопоставленный с конкретным событием Adapty.
`s2s`	Integer	Флаг события server-to-server.
`environment`	String	`sandbox` или `production`.
`created_at_unix`	Integer	Временная метка события в секундах.
`currency`	String	Код валюты (например, “USD”) для транзакции. Включается только если выручка превышает 0.001, поскольку Adjust требует, чтобы выручка и валюта передавались вместе.
`revenue`	Float	Сумма дохода от транзакции. Включается только если значение превышает 0.001. Обратите внимание, что события возврата отправляются без свойств дохода, поскольку Adjust не поддерживает отрицательные значения дохода.
`customer_user_id`	String	Customer User ID пользователя.
`external_device_id`	String	То же, что и `customer_user_id`.
`ip_address`	String	IP-адрес пользователя (только IPv4).
`user_agent`	String	Строка User Agent устройства.
`adid`	String	Adjust Device ID (если известен).
`android_id`	String	Только Android. Google Advertising ID.
`gps_adid`	String	Только Android. Google Advertising ID.
`idfa`	String	Только iOS. ID for Advertisers.
`idfv`	String	Только iOS. ID for Vendors.
`callback_params`	String	JSON-строка со всеми доступными полями события. Включаются только ненулевые поля.
`partner_params`	String	То же, что и `callback_params`.

Устранение проблем

Расхождение в данных о доходах

Если между Adapty и Adjust есть расхождение в данных о доходах, это может быть связано с тем, что не все пользователи используют версию приложения с Adapty SDK. Чтобы обеспечить согласованность данных, вы можете обязать пользователей обновить приложение до версии с Adapty SDK.