Tích hợp Tenjin

Tenjin là nền tảng attribution và phân tích dành cho các nhà phát triển ứng dụng và nhà tiếp thị. Nền tảng này cung cấp các công cụ để đo lường và tối ưu hóa các chiến dịch thu hút người dùng, mang lại cái nhìn chi tiết về hiệu suất ứng dụng và hành vi người dùng. Với cách tiếp cận minh bạch và linh hoạt, Tenjin tổng hợp dữ liệu từ các mạng quảng cáo và cửa hàng ứng dụng, giúp các nhóm phân tích ROI, theo dõi chuyển đổi và giám sát các chỉ số hiệu suất quan trọng.

Bằng cách chuyển tiếp các sự kiện gói đăng ký đến Tenjin, bạn có thể xem chính xác nguồn gốc của các lượt chuyển đổi và chiến dịch nào mang lại giá trị cao nhất trên tất cả các kênh, nền tảng và thiết bị. Về cơ bản, các dashboard của Tenjin cung cấp phân tích nâng cao cho các chiến dịch marketing.

Bằng cách chuyển tiếp attribution của Tenjin sang Adapty, bạn làm phong phú thêm dữ liệu phân tích của Adapty với các tiêu chí lọc bổ sung mà bạn có thể sử dụng trong phân tích cohort và chuyển đổi.

Tích hợp này hoạt động theo hai cách chính:

Nhận dữ liệu attribution từ Tenjin Sau khi tích hợp, Adapty sẽ thu thập dữ liệu attribution từ Tenjin. Bạn có thể xem thông tin này trên trang hồ sơ người dùng trong Adapty Dashboard.
Gửi sự kiện gói đăng ký đến Tenjin Adapty gửi các sự kiện mua hàng đến Tenjin theo thời gian thực. Những sự kiện này giúp đánh giá hiệu quả của các chiến dịch quảng cáo trực tiếp trong dashboard của Tenjin.

Đặc điểm tích hợp	Mô tả
Lịch trình	Thời gian thực
Hướng dữ liệu	Truyền dữ liệu hai chiều: Sự kiện Adapty: Từ máy chủ Adapty đến máy chủ Tenjin Attribution Tenjin: Từ Tenjin SDK đến máy chủ Adapty
Điểm tích hợp Adapty	Tenjin và Adapty SDK trong code ứng dụng di động Máy chủ Adapty

Đặc điểm tích hợp

Mô tả

Lịch trình

Thời gian thực

Hướng dữ liệu

Truyền dữ liệu hai chiều:

Sự kiện Adapty: Từ máy chủ Adapty đến máy chủ Tenjin
Attribution Tenjin: Từ Tenjin SDK đến máy chủ Adapty

Điểm tích hợp Adapty

Tenjin và Adapty SDK trong code ứng dụng di động
Máy chủ Adapty

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

Kết nối Adapty với Tenjin

Mở trang Integrations -> Tenjin trong Adapty Dashboard.
Bật toggle để kích hoạt tích hợp.
Đăng nhập vào Tenjin Dashboard.
Vào Configuration -> Apps trong menu điều hướng.
Chọn ứng dụng cho nền tảng của bạn (iOS hoặc Android) và chuyển đến tab App and SDK.
Trong tab App and SDK, nhấn Copy ở cột SDK Key. Nếu bạn chưa có SDK key, nhấn nút Generate SDK Key để tạo một cái.
Quay lại Adapty Dashboard và dán SDK Key vừa sao chép vào trường tương ứng:
- Với ứng dụng iOS: dán vào trường iOS SDK Key hoặc iOS Sandbox SDK Key
- Với ứng dụng Android: dán vào trường Android SDK Key hoặc Android Sandbox SDK Key
Info

Tenjin không có chế độ Sandbox riêng cho tích hợp server-to-server. Hãy dùng một ứng dụng Tenjin riêng biệt hoặc dùng cùng một key cho cả sự kiện production lẫn sandbox.
Nếu bạn có ứng dụng trên cả hai nền tảng, lặp lại bước 5-7 cho nền tảng còn lại.
(Tùy chọn) Điều chỉnh phần How the revenue data should be sent nếu cần. Để biết giải thích chi tiết về các cài đặt, tham khảo Integration settings.
Nhấn Save để hoàn tất thiết lập.

Adapty sẽ bắt đầu gửi sự kiện mua hàng đến Tenjin và nhận dữ liệu attribution. Bạn có thể điều chỉnh việc chia sẻ sự kiện trong phần Events names.

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

Tenjin chỉ chấp nhận các sự kiện mua hàng và Trial started. Trong phần Events names, chọn những sự kiện cần chia sẻ với Tenjin để phù hợp với mục tiêu theo dõi của bạn.

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

Sử dụng phương thức SDK Adapty.updateExternalAttribution() (tên là updateAttribution() trước SDK phiên bản 4.1) để lấy dữ liệu attribution từ Tenjin và chuyển tiếp cho Adapty.


func updateTenjinId() {
    guard let tenjinId = TenjinSDK.getAnalyticsInstallationId() else { return }

    do {
        try await Adapty.setIntegrationIdentifier(.tenjinAnalyticsInstallationId(tenjinId))
    } catch {
        // handle the error
    }
}

func updateTenjinAttribution() {
    let instance = TenjinSDK.getInstance("<YOUR_TENJIN_API_TOKEN>")
        
    instance?.getAttributionInfo { info, _ in
        guard let info else { return }

        Task {
            do {
                try await Adapty.updateExternalAttribution(info, provider: .tenjin)
            } catch {
                // handle the error
            }
        }
    }
}

Adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", tenjinSdk.analyticsInstallationId) { error ->
    if (error != null) {
        // handle the error
    }
}

tenjinSdk.getAttributionInfo { attribution ->
    if (attribution == null) return@getAttributionInfo

    Adapty.updateAttribution(attribution, "tenjin") { error ->
        if (error != null) {
            // handle the error
        }
    }
}

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

tenjinSdk.getAttributionInfo(attribution -> {
    if (attribution == null) return;

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

try {
    final tenjinId = await TenjinSDK.instance.getAnalyticsInstallationId();
    
    if (tenjinId != null) {
        await Adapty().setIntegrationIdentifier(
            key: 'tenjin_analytics_installation_id', 
            value: tenjinId,
        );
    }

    final attribution = await TenjinSDK.instance.getAttributionInfo();
    if (attribution != null) {
        await Adapty().updateAttribution(attribution, source: 'tenjin');
    }
} catch (e) {
    // handle the error
}

using AdaptySDK;
using System.Linq;

BaseTenjin instance = Tenjin.getInstance("<SDK_KEY>");
var tenjinId = instance.GetAnalyticsInstallationId();

Adapty.SetIntegrationIdentifier(
    "tenjin_analytics_installation_id",
    tenjinId,
    (error) => {
        // handle the error
    });

instance.GetAttributionInfo((attribution) => {
    var dynamicAttribution = attribution.ToDictionary(
        kvp => kvp.Key,
        kvp => (dynamic)kvp.Value
    );
                
Adapty.UpdateAttribution(
    dynamicAttribution,
    "tenjin",
    (error) => {
        // handle the error
    });
});


// ...
const posthog = usePostHog()

// ...
try {
  await adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", await Tenjin.getAnalyticsInstallationId());
} catch (error) {
  // handle `AdaptyError`
}

Cấu trúc sự kiện

Adapty gửi các sự kiện đã chọn đến Tenjin theo cấu hình trong phần Events names trên trang Tenjin Integration. Mỗi sự kiện có cấu trúc như sau:

{
  "price": 99.0,
  "locale": "en-US",
  "country": "ME",
  "postcut": "false",
  "currency": "USD",
  "platform": "ios",
  "quantity": 1,
  "bundle_id": "com.adapty.adaptydemoapp",
  "ip_address": "127.0.0.1",
  "os_version": "18.1.1",
  "product_id": "month.premium.99",
  "app_version": "3.2.0",
  "sdk_version": "server",
  "device_model": "iPhone 13 Mini",
  "advertising_id": "00000000-0000-0000-0000-000000000000",
  "os_version_release": "18.1.1",
  "developer_device_id": "00000000-0000-0000-0000-000000000000",
  "analytics_installation_id": "00000000-0000-0000-0000-000000000000"
}

Trong đó:

Tham số	Kiểu	Mô tả
price	Float	Đơn giá của mặt hàng đã mua theo đơn vị tiền tệ chuẩn (ví dụ: USD được tính bằng đô la).
locale	String	Ngôn ngữ/vùng của thiết bị. Trên Android: `Locale.getDefault().toString()`. Trên iOS: `[[NSLocale currentLocale] localeIdentifier]`.
country	String	Mã quốc gia theo chuẩn ISO locale (ví dụ: US cho Hoa Kỳ).
postcut	String (Boolean)	Cho biết liệu giao dịch mua có được gửi sau khi trừ phí nền tảng hay không. 1 là true, 0 là false.
currency	String	Mã tiền tệ ISO (ví dụ: USD cho đô la Mỹ).
platform	String	Nền tảng của thiết bị (ví dụ: ios, android, windows, amazon).
quantity	Integer	Số lượng đơn vị đã mua.
bundle_id	String	Bundle identifier của ứng dụng (ví dụ: `com.example.app`).
ip_address	String (IPv4)	Địa chỉ IP của người dùng. Dùng để tra cứu quốc gia.
os_version	String	Phiên bản hệ điều hành của thiết bị. Trên Android: `String.valueOf(Build.VERSION.SDK_INT)`. Trên iOS: `[[UIDevice currentDevice] systemVersion]`.
product_id	String	Mã định danh duy nhất cho sản phẩm đã mua.
app_version	Float, Decimal	Phiên bản của ứng dụng. Trên Android: `context.getPackageManager().getPackageInfo()`. Trên iOS: `[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"]`.
sdk_version	String	Phiên bản SDK đang sử dụng, luôn được đặt là `server`.
device_model	String	Model của thiết bị. Trên Android: `Build.MODEL`. Trên iOS: `sysctl("hw.machine")`.
advertising_id	UUID	ID quảng cáo của thiết bị. Bắt buộc trên Android. Trên iOS, có thể để trống hoặc toàn số không.
os_version_release	String	Phiên bản phát hành của hệ điều hành. Trên Android: `String.valueOf(Build.VERSION.RELEASE)`. Trên iOS: `[[UIDevice currentDevice] systemVersion]`.
developer_device_id	UUID	Mã định danh nhà cung cấp (chỉ dành cho iOS).
analytics_installation_id	UUID	ID cài đặt analytics. Để biết thêm chi tiết, tham khảo tài liệu tại `https://docs.tenjin.com`.

Khắc phục sự cố

Một số sự kiện hiển thị là thất bại trong Event Feed

Tenjin chỉ chấp nhận các sự kiện được liệt kê trong Cấu hình sự kiện và thẻ. Mọi sự kiện khác vẫn xuất hiện dưới dạng một hàng trong Event Feed, được đánh dấu là giao hàng thất bại với tooltip “The event type is not supported for integration.” Điều này bao gồm access_level_updated, vốn không có trong phần Events names, vì nó chỉ dành riêng cho tích hợp webhook.