Class BatchProfileAttributeEditor

Implements

  • BatchProfileAttributeEditor

Constructors

constructor

Methods

addToArray addToTopicPreferences removeAttribute removeFromArray removeFromTopicPreferences save setAttribute setEmailAddress setEmailMarketingSubscription setLanguage setPhoneNumber setRegion setSMSMarketingSubscription setTopicPreferences

Constructors

constructor

Methods

addToArray

  • addToArray(key, value): this

  • Add value to an array attribute. If the array doesn't exist it will be created.

    Parameters

    • key: string

      Attribute key. Cannot be null, empty or undefined. It should be made of letters, numbers or underscores ([a-z0-9_]) and can't be longer than 30 characters.

    • value: string | string[]

      The value to add. Cannot be null, undefined or empty. Must be an array of string or a string no longer than 64 characters.

    Returns this

addToTopicPreferences

  • addToTopicPreferences(topics): this

  • Add topics to the profile topic preferences.

    Parameters

    • topics: string[]

      Topics to add. Must be a valid string array not longer than 25 items or a single string. String should be made of letters, numbers or underscores ([a-z0-9_]) and can't be longer than 300 characters.

    Returns this

removeAttribute

  • removeAttribute(key): this

  • Remove an attribute

    Parameters

    • key: string

      The key of the attribute to remove

    Returns this

removeFromArray

  • removeFromArray(key, value): this

  • Remove a value from an array attribute.

    Parameters

    • key: string

      Attribute key. Cannot be null, empty or undefined. It should be made of letters, numbers or underscores ([a-z0-9_]) and can't be longer than 30 characters.

    • value: string | string[]

      The value to remove. Can be a String or an Array of String. Cannot be null, empty or undefined.

    Returns this

removeFromTopicPreferences

  • removeFromTopicPreferences(topics): this

  • Remove topics from the profile topic preferences.

    Parameters

    • topics: string[]

      Topics to remove. Must be a valid string array not longer than 25 items or a single string. String should be made of letters, numbers or underscores ([a-z0-9_]) and can't be longer than 300 characters.

    Returns this

save

setAttribute

  • setAttribute(key, value): this

  • Set an attribute for a key

    Parameters

    • key: string

      Attribute key. Cannot be null, empty or undefined. It should be made of letters, numbers or underscores ([a-z0-9_]) and can't be longer than 30 characters.

    • value:
          | string
          | number
          | boolean
          | string[]
          | Date
          | URL

      Attribute value. Accepted types are numbers, booleans, Date objects and strings. Strings must not be empty or longer than 64 characters.

    Returns this

setEmailAddress

  • setEmailAddress(email): this

  • Set the profile email address.

    This requires to have a custom user ID registered or to call the setIdentifier method on the editor instance beforehand.

    Parameters

    • email: null | string

      A valid email address. Null to erase.

    Returns this

setEmailMarketingSubscription

  • setEmailMarketingSubscription(state): this

  • Set the profile email marketing subscription state

    Parameters

    • state: "subscribed" | "unsubscribed"

      The state of the marketing email subscription. Must be "subscribed" or "unsubscribed".

    Returns this

setLanguage

  • setLanguage(language): this

  • Set the application language. Overrides Batch's automatically detected language. Send null to let Batch autodetect it again.

    Parameters

    • language: null | string

      Language code. 2 chars minimum, or null

    Returns this

setPhoneNumber

  • setPhoneNumber(phoneNumber): this

  • Set the profile phone number.

    This requires to have a custom profile ID registered or to call the identify method beforehand.

    Parameters

    • phoneNumber: null | string

      A valid E.164 formatted string. Must start with a + and not be longer than 15 digits without special characters (eg: "+33123456789"). Null to reset.

    Returns this

setRegion

  • setRegion(region): this

  • Set the application region. Overrides Batch's automatically detected region. Send "null" to let Batch autodetect it again.

    Parameters

    • region: null | string

      Region code. 2 chars minimum, or null

    Returns this

setSMSMarketingSubscription

  • setSMSMarketingSubscription(state): this

  • Set the profile SMS marketing subscription state.

    Note that profile's subscription status is automatically set to unsubscribed when users send a STOP message.

    Parameters

    • state: "subscribed" | "unsubscribed"

      The state of the SMS marketing subscription. Must be "subscribed" or "unsubscribed".

    Returns this

setTopicPreferences

  • setTopicPreferences(topics): this

  • Set the profile topic preferences.

    Parameters

    • topics: null | string[]

      Array of topics to set. Null to reset. Must be a valid string array not longer than 25 items. String should be made of letters, numbers or underscores ([a-z0-9_]) and can't be longer than 300 characters.

    Returns this

Settings

Member Visibility

On This Page

Constructors
Methods