Skip to main content

Integrate Contacts from Multiple Sources

As an important tool for player relationship management, SmartLink provides you with a platform to manage contacts. You can integrate any project-related contacts into SmartLink, and manage contacts through tags and user segments to personalize your campaigns.

SmartLink provides the following 4 methods to import contacts:

Method 1: Upload offline files​

This method is applicable to the contact information obtained from other platforms, and the CSV file uploaded should not exceed 20MB. For more information, see Import Contacts.

Method 2: Import contacts via APIs​

This method is applicable when the contacts are generated and changed in other systems and need to be synchronized to SmartLink in real time.

Prerequisites​

  1. Create a tag for contact management in SmartLink in advance. Otherwise, when you call the API to import contacts, the import will fail and return an error message saying that the corresponding tag cannot be found in the project. SmartLink supports up to 100 tags for a single contact. For information about the creation and use of tags, see Manage Contacts by Tags.

  2. Add the subscription status, region, and language for the contacts you are importing as these are mandatory attributes for SmartLink to import contacts through API. For more information, see the SyncUserByEmail API.

Procedures​

  1. At the bottom of the SmartLink sidebar, click your account name, then select Project settings.

  2. In the Project settings page, click API key to obtain the API key for authentication when calling SyncUserByEmail.
    For the API call method, see API Reference.

    UploadContacts1

  3. If you need to distinguish contacts from multiple sources, you can use the from attribute of the API to identify the data sources.
    SmartLink support using this identifier in the user segmentation module to separate contacts from different sources.

  4. If you need to add other properties to better distinguish contacts, SmartLink supports up to 20 custom attributes in the attributes attribute of the API. These attributes make it more convenient to distinguish users and create campaigns for different user segments.

    Type of supported custom attributes:

    Attribute typeExampleApplicable scenario (segmentation method)
    NumberAge, such as key=age, value=20Separate into distinct segments of users whose ages are greater than, less than, or equal to a specific number.
    DateBirthday, such as key=birthday, value=2022-10-15Separate into distinct segments of users whose birthdays are earlier than, later than, or equal to a specific date.
    StringUsername/nickname, such as key=name, value=MikeSeparate into distinct segments of users equal or not equal to a specific string.
    Drop downFavorite characters, such as key=Player Characters, Option1=Player1, Option2=Player2, Option3=Player3Separate into distinct segments of users containing or not containing a specific drop down option.

  5. If you need to view the contact information imported via the API, you can view the real-time data in All contacts and distinguish the data sources through the values specified in the from attribute of the API.

    UploadContacts2

Method 3: Add subscribers​

This method is applicable for uploading a single contact.

  1. In the SmartLink sidebar, select Contacts under Contacts.

  2. Click Add a subscriber, then select Import individual contact.

    UploadContacts6

  3. Enter contact information and select the relevant tags, then click Submit.

    UploadContacts7

Method 4: Import contacts via LEVEL INFINITE PASS​

This method is applicable when data from LEVEL INFINITE PASS needs to be synchronized with SmartLink in real time, for easy management of player information.

  1. In the SmartLink sidebar, select Contacts under Contacts.

  2. Click Import contact(s), then select LEVEL INFINITE PASS to sync contacts from LEVEL INFINITE PASS.

    UploadContacts8

  3. From Player Network Console, configure LEVEL INFINITE PASS to allow player information to be imported into SmartLink.
    For more information, see Standard Login from the Player Network Documentation.

  4. After syncing all the data, view the contacts by filtering the LEVEL INFINITE PASS source in the Contacts page.

    UploadContacts5

Method 5: Import contacts via LEVEL INFINITE PASS newsletter sign-ups​

This method is applicable when subscription data from the LEVEL INFINITE PASS official website needs to be synchronized with SmartLink, for easy management and integration of subscriber information.

  1. In the SmartLink sidebar, select Contacts under Contacts.

  2. Click Import contact(s), then select Newsletter sign-up to sync contacts from the LEVEL INFINITE PASS subscription list.

    UploadContacts9

  3. Edit the relevant settings from the Newsletter sign-up settings page, then click Save.

    • Enable / Disable: Whether to allow subscriber information from the LEVEL INFINITE PASS official website to be synchronized with SmartLink. UploadContacts10

    • Welcome email settings: Whether subscribers on the LEVEL INFINITE PASS official website will receive a welcome email after subscribing. Details regarding the welcome email can be configured from the bottom of the page.

      note

      The welcome email does not support using static value placeholders. For more information on using placeholders, see Customize Email Content.

      UploadContacts11