ÿÿ Nhắn tin và Thông báo trong Adapty | Tài liệu Adapty

Tích hợp dịch vụ nhắn tin

Việc thu hút ngưá»i dùng trong thị trưá»ng di động ngày càng cạnh tranh không há» dá»… dàng và cÅ©ng không rẻ. Vì vậy, việc chăm sóc khéo léo những ngưá»i dùng đã thu hút được sẽ cải thiện đáng kể kinh tế đơn vị cá»§a bạn, đặc biệt trong các lÄ©nh vá»±c cạnh tranh cao.

Adapty cung cấp thông tin theo thá»i gian thá»±c vá» các hành động thanh toán cá»§a ngưá»i dùng. Chúng tôi biết khi nào khách hàng cá»§a bạn dùng thá»­, gặp vấn đỠvá»›i thanh toán, hay đã mua gói đăng ký rồi quyết định há»§y. Tất cả những sá»± kiện này và nhiá»u sá»± kiện khác phản ánh sá»± thay đổi trong trạng thái cá»§a khách hàng. Và đây chính là thá»i Ä‘iểm tốt nhất để phản ứng — gá»­i má»™t ưu đãi, món quà cá nhân, hay bất kỳ Ä‘iá»u gì giúp giữ chân há».

Các ná»n tảng thông báo đẩy cho phép mô tả ngưá»i dùng bằng các tag tiêu chuẩn và tùy chỉnh để xây dá»±ng hệ thống giữ chân ngưá»i dùng tá»± động hiệu quả. Äể hệ thống này hoạt động, bạn chỉ cần các sá»± kiện kích hoạt để thông báo cho hệ thống biết khi nào cần gá»­i tin nhắn. Các sá»± kiện này sẽ được gá»­i đến ná»n tảng thông báo đẩy từ Adapty thông qua tích hợp đã thiết lập.

Vui lòng chá»n dịch vụ bạn muốn tích hợp bên dưới và làm theo hướng dẫn:

Không thấy nhà cung cấp attribution của bạn?

Let chúng tôi biết! Tạo yêu cầu tính năng và chúng tôi sẽ xem xét thêm vào.

Thuộc tính sự kiện

Các sá»± kiện webhook được gá»­i dưới định dạng JSON. Tất cả sá»± kiện Ä‘á»u có cùng cấu trúc, nhưng các trưá»ng cá»§a chúng sẽ khác nhau tùy thuá»™c vào loại sá»± kiện, cá»­a hàng và cấu hình cụ thể cá»§a bạn.

Adapty chuyển đổi các loại tiá»n tệ khác sang USD theo tá»· giá hối Ä‘oái từ currencylayer.com (cập nhật má»—i 8 giá»). Tá»· giá được cố định tại thá»i Ä‘iểm giao dịch — những thay đổi sau đó không ảnh hưởng đến kết quả chuyển đổi.

Thuộc tínhKiểuMô tả
profile_iduuidID ngưá»i dùng Adapty.
currencystrÄÆ¡n vị tiá»n tệ địa phương (mặc định là USD).
price_usdfloatGiá sản phẩm trước khi Apple/Google khấu trừ. Doanh thu.
proceeds_usdfloatGiá sản phẩm sau khi Apple/Google khấu trừ. Doanh thu thuần.
net_revenue_usdfloatDoanh thu thuần (thu nhập sau khi Apple/Google khấu trừ và thuế) tính bằng USD. Có thể để trống.
price_localfloatGiá sản phẩm trước khi Apple/Google khấu trừ tính bằng tiá»n tệ địa phương. Doanh thu.
proceeds_localfloatGiá sản phẩm sau khi Apple/Google khấu trừ tính bằng tiá»n tệ địa phương. Doanh thu thuần.
transaction_idstrMã định danh duy nhất cho một giao dịch như mua hàng hoặc gia hạn.
original_transaction_idstrMã định danh giao dịch của lần mua hàng gốc.
purchase_dateISO 8601 dateNgày và giỠmua sản phẩm.
original_purchase_dateISO 8601 dateNgày và giỠcủa lần mua hàng gốc.
environmentstrCó thể là Sandbox hoặc Production.
vendor_product_idstrID sản phẩm trong Apple App Store, Google Play Store, hoặc Stripe.
base_plan_idstrBase plan ID trong Google Play Store hoặc price ID trong Stripe.
event_datetimeISO 8601 dateNgày và giỠcủa sự kiện.
storestrCó thể là app_store hoặc play_store.
trial_durationstrThá»i gian dùng thá»­ tính bằng ngày. ÄÆ°á»£c gá»­i theo định dạng †daysâ€, ví dụ: “7 daysâ€.
cancellation_reasonstr

Lý do ngưá»i dùng há»§y gói đăng ký.

Có thể là

iOS & Android

voluntarily_cancelled, billing_error, refund

iOS

price_increase, product_was_not_available, unknown

Android

new_subscription_replace, cancelled_by_developer

subscription_expires_atISO 8601 dateNgày hết hạn gói đăng ký. Thưá»ng là trong tương lai.
consecutive_paymentsintSố chu kỳ mà ngưá»i dùng đã đăng ký liên tục không gián Ä‘oạn. Bao gồm chu kỳ hiện tại.
rate_after_first_yearboolBoolean cho biết gói đăng ký có đủ Ä‘iá»u kiện nhận mức hoa hồng giảm (thưá»ng là 15%) sau má»™t năm gia hạn liên tục hay không. Mức hoa hồng thay đổi tùy theo Ä‘iá»u kiện tham gia chương trình và quốc gia. Xem Hoa hồng cá»­a hàng và thuế để biết thêm chi tiết.
promotional_offer_idstrID của ưu đãi như được chỉ định trong phần Product của Adapty Dashboard
store_offer_categorystrCó thể là introductory hoặc promotional.
store_offer_discount_typestrCó thể là free_trial, pay_as_you_go hoặc pay_up_front.
paywall_namestrTên của paywall nơi giao dịch bắt nguồn.
paywall_revisionintPhiên bản của paywall nơi giao dịch bắt nguồn. Giá trị được đặt là 1.
developer_idstrID developer (SDK) của placement nơi giao dịch bắt nguồn.
ab_test_namestrTên của A/B test nơi giao dịch bắt nguồn.
ab_test_revisionintPhiên bản của A/B test nơi giao dịch bắt nguồn. Giá trị được đặt là 1.
cohort_namestrTên cá»§a đối tượng mà hồ sÆ¡ ngưá»i dùng thuá»™c vá».
profile_event_iduuidID sự kiện duy nhất có thể được dùng để loại trùng lặp.
store_countrystrQuốc gia được cửa hàng gửi cho chúng tôi.
profile_ip_addressstrIP cá»§a hồ sÆ¡ ngưá»i dùng (có thể là IPv4 hoặc IPv6, ưu tiên IPv4 khi có). ÄÆ°á»£c cập nhật má»—i khi IP cá»§a thiết bị thay đổi.
profile_countrystrÄÆ°á»£c Adapty xác định dá»±a trên IP cá»§a hồ sÆ¡ ngưá»i dùng.
profile_total_revenue_usdfloatTổng doanh thu cho hồ sÆ¡ ngưá»i dùng, bao gồm cả các khoản hoàn tiá»n.
variation_iduuidID duy nhất của paywall nơi thực hiện mua hàng.
access_level_idstrID mức độ truy cập có trả phí
is_activeboolBoolean cho biết mức độ truy cập có trả phí có Ä‘ang hoạt động cho hồ sÆ¡ ngưá»i dùng hay không.
will_renewboolBoolean cho biết mức độ truy cập có trả phí có được gia hạn hay không.
is_refundboolBoolean cho biết giao dịch có được hoàn tiá»n hay không.
is_lifetimeboolBoolean cho biết mức độ truy cập có trả phí có phải là trá»n Ä‘á»i hay không.
is_in_grace_periodboolBoolean cho biết hồ sÆ¡ ngưá»i dùng có Ä‘ang trong thá»i gian ân hạn hay không.
starts_atISO 8601 dateNgày và giá» mức độ truy cập có trả phí bắt đầu cho ngưá»i dùng.
renewed_atISO 8601 dateNgày và giỠmức độ truy cập có trả phí sẽ được gia hạn.
expires_atISO 8601 dateNgày và giỠmức độ truy cập có trả phí sẽ hết hạn.
activated_atISO 8601 dateNgày và giỠmức độ truy cập có trả phí được kích hoạt.
billing_issue_detected_atISO 8601 dateNgày và giỠxảy ra sự cố thanh toán.
profile_has_access_levelBoolBoolean cho biết hồ sÆ¡ ngưá»i dùng có mức độ truy cập Ä‘ang hoạt động hay không (chỉ dành cho Webhook).

Mỗi sự kiện có các thuộc tính sau:

transaction_id, original_transaction_id, purchase_date, original_purchase_date, environment, vendor_product_id, event_datetime, store.

Ngoài ra, má»™t số sá»± kiện có thêm các thuá»™c tính bổ sung. Äối vá»›i các sá»± kiện subscription_refunded và non_subscription_purchase_refunded, bắt buá»™c phải cung cấp giá trị cá»§a price_usd và proceeds_usd làm thuá»™c tính bổ sung.

Tên sự kiệnThuộc tính
subscription_initial_purchaseprice_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
subscription_renewedprice_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
subscription_cancelledcancellation_reason, trial_duration
trial_startedsubscription_expires_at, trial_duration
trial_convertedprice_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
trial_cancelledcancellation_reason, trial_duration
non_subscription_purchaseprice_usd, proceeds_usd
billing_issue_detectedsubscription_expires_at, trial_duration
entered_grace_periodsubscription_expires_at, trial_duration

Ví dụ sự kiện

{
    "price_usd": 9.99,
    "proceeds_usd": 6.99,
    "transaction_id": "1000000628581600",
    "original_transaction_id": "1000000628581600",
    "purchase_date": "2020-02-18T18:40:22.000000+0000",
    "original_purchase_date": "2020-02-18T18:40:22.000000+0000",
    "environment": "Sandbox",
    "vendor_product_id": "premium",
    "event_datetime": "2020-02-18T18:40:22.000000+0000",
    "store": "app_store"
}

Adapty gửi sự kiện đến máy chủ của bạn và các hệ thống phân tích bên thứ ba.

Thuá»™c tính profile_ip_address ÿÿđược đồng bá»™ vá»›i IP thiết bị hiện tại. Má»—i khi máy chá»§ Adapty nhận thông tin từ SDK, IP sẽ được cập nhật nếu khác vá»›i IP chúng tôi Ä‘ang lưu.

ÿÿÿÿ