Adjust

Adjust là một trong những nền tảng Mobile Measurement Partner (MMP) hàng đầu, thu thập và trình bày dữ liệu từ các chiến dịch marketing. Điều này giúp các công ty theo dõi hiệu quả chiến dịch của mình.

Adapty cung cấp đầy đủ dữ liệu giúp bạn theo dõi các sự kiện gói đăng ký từ các cửa hàng tại một nơi. Với Adapty, bạn có thể dễ dàng hiểu hành vi của người dùng, biết họ thích gì, và dùng thông tin đó để tiếp cận họ một cách có mục tiêu và hiệu quả. Nhờ đó, tích hợp này cho phép bạn theo dõi các sự kiện gói đăng ký trong Adjust và phân tích chính xác doanh thu mà các chiến dịch của bạn tạo ra.

Tích hợp giữa Adapty và Adjust hoạt động theo hai hướng chính.

1. Adapty nhận dữ liệu attribution từ Adjust Sau khi thiết lập tích hợp Adjust, Adapty sẽ bắt đầu nhận dữ liệu attribution từ Adjust. Bạn có thể dễ dàng xem dữ liệu này trên trang hồ sơ người dùng.

2. Adapty gửi các sự kiện gói đăng ký đến Adjust Adapty có thể gửi tất cả các sự kiện gói đăng ký đã được cấu hình trong tích hợp của bạn đến Adjust. Nhờ đó, bạn có thể theo dõi các sự kiện này trong Adjust dashboard. Tích hợp này rất hữu ích để đánh giá hiệu quả của các chiến dịch quảng cáo.

Thiết lập tích hợp

Kết nối Adapty với Adjust

1. Mở Adapty Dashboard và điều hướng đến Integrations > Adjust.

2. Bật toggle ở đầu trang.

3. Điền vào các trường và thiết lập thông tin xác thực.

3. Nếu bạn đã bật xác thực OAuth trên nền tảng Adjust, bạn bắt buộc phải cung cấp OAuth Token trong quá trình tích hợp cho ứng dụng iOS và Android của mình.
4. Tiếp theo, cung cấp app tokens cho ứng dụng iOS và Android. Mở Adjust dashboard và bạn sẽ thấy danh sách ứng dụng của mình.

5. Chọn ứng dụng từ danh sách và sao chép App Token. Dán token vào trường tương ứng trên Adapty dashboard.

Cấu hình sự kiện và tags

Adjust hoạt động hơi khác so với các nền tảng khác. Bạn cần tạo sự kiện thủ công trong Adjust dashboard, lấy token sự kiện, rồi sao chép-dán chúng vào các sự kiện tương ứng trong Adapty.

Vì vậy, bước đầu tiên là tìm token sự kiện cho tất cả các sự kiện bạn muốn Adapty gửi. Để làm điều đó:

1. Trong Adjust dashboard, mở ứng dụng của bạn và chuyển sang tab Events.

1. Sao chép token sự kiện và dán vào Adapty. Phía dưới thông tin xác thực, có ba nhóm sự kiện bạn có thể gửi đến Adjust từ Adapty. Xem danh sách đầy đủ các sự kiện mà Adapty cung cấp tại đây.

Adapty sẽ gửi sự kiện gói đăng ký đến Adjust thông qua tích hợp server-to-server, cho phép bạn xem tất cả sự kiện gói đăng ký trong Adjust dashboard và liên kết chúng với các chiến dịch thu hút người dùng.

Kết nối ứng dụng của bạn với Adjust

Sau khi hoàn thành các bước mô tả ở trên, thêm hai phương thức sau vào ứng dụng của bạn. Chúng sẽ thiết lập kết nối giữa ứng dụng và Adjust:

1. Để gửi dữ liệu gói đăng ký đến Adjust: Truyền Adjust device ID vào phương thức SDK setIntegrationIdentifier()
2. Để nhận dữ liệu attribution từ Adjust: Cập nhật dữ liệu attribution bằng phương thức SDK updateExternalAttribution() (đặt tên là updateAttribution() trước SDK phiên bản 4.1)

Đối với Adjust phiên bản 5.0 trở lên, hãy dùng ví dụ sau:

class AdjustModuleImplementation {
    func updateAdjustAdid() {
        Adjust.adid { adid in
            guard let adid else { return }
            Adapty.setIntegrationIdentifier(.adjustDeviceId(adid))
        }
    }

    func updateAdjustAttribution() {
        Adjust.attribution { attribution in
            guard let attribution = attribution?.dictionary() else { return }
            Adapty.updateExternalAttribution(attribution, provider: .adjust)
        }
    }
}

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

    Adapty.setIntegrationIdentifier(AdaptyIntegrationIdentifier.adjustDeviceId(adid)) { error ->
        if (error != null) {
            // handle the error
        }
    }
}

Adjust.getAttribution { attribution ->
    val attributionJson = attribution?.jsonResponse ?: return@getAttribution

    Adapty.updateExternalAttribution(attributionJson, AdaptyExternalAttributionProvider.ADJUST) { error ->
        // handle the error
    }
}

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

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

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

    Adapty.updateExternalAttribution(attribution.jsonResponse, AdaptyExternalAttributionProvider.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.updateExternalAttribution(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().updateExternalAttribution(attribution, provider: AdaptyExternalAttributionProvider.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.UpdateExternalAttribution(attributionJsonString, AdaptyExternalAttributionProvider.Adjust, (error) => {
        if (error != null) {
            // handle the error
        }
    });
}

Mua hàng trên Web (Stripe và Paddle)

Adjust nhận dữ liệu mua hàng từ Stripe và Paddle cùng với các giao dịch mua hàng từ App Store và Google Play. Giao dịch mua hàng trên web diễn ra bên ngoài ứng dụng, nên không gắn với nền tảng di động nào. Adapty sẽ dùng nền tảng của người mua thay thế. Khi hồ sơ người dùng Adapty của họ được tạo trên App Store hoặc Google Play, giao dịch mua hàng trên web sẽ được gửi đến Adjust như thể nó đến từ cửa hàng đó:

Giao dịch mua được gửi đến Adjust gắn với cùng thiết bị đã cài đặt ứng dụng, nhờ đó Adjust có thể ghi nhận giao dịch đó cho chiến dịch đã thu hút người dùng.

Trang tích hợp Adjust không có trường riêng cho Stripe hay Paddle. Các giao dịch mua trên web sử dụng lại thông tin xác thực iOS và Android từ phần Kết nối Adapty với Adjust.

Người mua chưa từng mở ứng dụng di động của bạn sẽ không có Adjust device ID, và hồ sơ người dùng của họ được tạo trên Stripe hoặc Paddle. Adapty gửi giao dịch mua của họ đến Adjust cùng với App Token iOS của bạn nhưng không có advertising ID. Khi đó, Adjust không có định danh nào để liên kết giao dịch mua với một lượt cài đặt.

Cấu trúc sự kiện

Adapty gửi các sự kiện đã chọn đến Adjust theo cấu hình trong mục Events names trên trang tích hợp Adjust. Mỗi sự kiện có cấu trúc như sau:

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

Trong đó

Khắc phục sự cố

Chênh lệch doanh thu

Nếu có sự chênh lệch doanh thu giữa Adapty và Adjust, nguyên nhân có thể là không phải tất cả người dùng của bạn đều sử dụng phiên bản ứng dụng có Adapty SDK. Để đảm bảo tính nhất quán của dữ liệu, bạn có thể yêu cầu người dùng cập nhật ứng dụng lên phiên bản có Adapty SDK.

access_level_updated hiển thị là thất bại trong Event Feed

access_level_updated là một sự kiện chỉ dành cho webhook. Adapty không bao giờ gửi sự kiện này đến tích hợp này. Tuy nhiên, Adapty ghi lại kết quả cho mọi tích hợp đã bật, và một sự kiện không được hỗ trợ sẽ được hiển thị là thất bại.