CRM Properties

CRM Properties are stored securely only on the Hackle server and cannot be directly queried through the SDK.

CRM Properties are managed separately and are not deleted or reset when resetUser() is called or when clearAll is called in updateUserProperties.

If a user unregisters or similar actions occur, you must separately call the provided function to delete the information.

Phone Number Collection

This feature is supported in Android SDK 2.52.0 and above.

Recommendation for Kakao / Text Messages

By mapping the User Identifier to a phone number using this feature, you can use Kakao / Text Messages via Hackle more smoothly.

setPhoneNumber

Registers the user's phone number.

The phone number is only saved if it is in the correct E.164 format. If no country code is specified, South Korea (+82) is used as the default.

If the user already has a saved phone number, calling this function replaces the existing phone number with the new value.

val myPhoneNumber = '[phone]';
Hackle.app.setPhoneNumber(myPhoneNumber);

unsetPhoneNumber

Deletes the phone number registered for the user.

hackleApp.unsetPhoneNumber();

CRM Marketing Subscription Consent

This feature is supported in Android SDK 2.55.0 and above.

For details on subscription consent status, refer to the CRM Marketing Subscription Consent Management documentation.

Subscription Consent Properties

You can consent to or reject subscriptions by message purpose.

Use HackleSubscriptionOperations.Builder to configure the consent status for the desired properties, then finalize the update using a method like updatePushSubscriptions().

You can update the consent status per message channel.

import io.hackle.sdk.common.subscription.HackleSubscriptionOperations
import io.hackle.sdk.common.subscription.HackleSubscriptionStatus

val subscriptions = HackleSubscriptionOperations.builder()
  .marketing(HackleSubscriptionStatus.SUBSCRIBED)
  .information(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackle.app.updatePushSubscriptions(subscriptions)

Promotional Messages

Sets the promotional message subscription consent property.

import io.hackle.sdk.common.subscription.HackleSubscriptionOperations
import io.hackle.sdk.common.subscription.HackleSubscriptionStatus

val subscriptions = HackleSubscriptionOperations.builder()
  .marketing(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackle.app.updatePushSubscriptions(subscriptions)

Informational Messages

Sets the informational message subscription consent property.

import io.hackle.sdk.common.subscription.HackleSubscriptionOperations
import io.hackle.sdk.common.subscription.HackleSubscriptionStatus

val subscriptions = HackleSubscriptionOperations.builder()
  .information(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackle.app.updatePushSubscriptions(subscriptions)

HackleSubscriptionStatus

HackleSubscriptionStatus	Description
UNKNOWN	Subscription Consent has not been given or denied (default)
SUBSCRIPTION	Explicitly opted in to receive messages
UNSUBSCRIPTION	Explicitly opted out of receiving messages

Update Push Subscription Consent Status

Updates the user's Push Message subscription consent status.

val subscriptions = HackleSubscriptionOperations.builder()
  .marketing(HackleSubscriptionStatus.SUBSCRIBED)
  .information(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackle.app.updatePushSubscriptions(subscriptions)

Update Kakao Message Subscription Consent Status

Updates the user's Kakao Message subscription consent status.

val subscriptions = HackleSubscriptionOperations.builder()
  .marketing(HackleSubscriptionStatus.SUBSCRIBED)
  .information(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackle.app.updateKakaoSubscriptions(subscriptions)

Update Text Message Subscription Consent Status

Updates the user's Text Message subscription consent status.

val subscriptions = HackleSubscriptionOperations.builder()
  .marketing(HackleSubscriptionStatus.SUBSCRIBED)
  .information(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackle.app.updateSmsSubscriptions(subscriptions)