Overview

After you get a batch of user accounts from a third-party data platform or business backend, when launching a marketing campaign for such users, you can use the push to accounts feature to push messages to a single or multiple accounts at a time.

Note：

The abovementioned accounts must be bound with a TPNS token. For detailed directions, please see Binding an account (Android) or Adding account (iOS).

Directions

Using the console

1. Log in to the TPNS console.
2. Find the application for which to configure batch push and select Create Push in its Operation column to enter the Create Push page.
3. In the Push Target configuration item, select Account. You can choose to upload an account package file or manually enter accounts, as shown in the following figure:

Note：

Requirements for the uploaded account package are as follows:

• Account package filename: [1, 100] characters
• Account package format and size: .zip, .txt, or .csv file within 100 MB
• .zip file requirements: can contain a single .txt or .csv file but not folders
• .txt file requirements: encoded in UTF-8; one account ([2, 100] characters) per row
• .csv file requirements: one column only; one account ([2, 100] characters) per row

4. Select the account type. You can obtain the account type from service developers. If no account type is specified, the default type is used.

5. Click Preview. After confirming that the push configuration is correct, click Confirm.

Using RESTful APIs

Push to a single or multiple accounts

1. When you call the push API, set audience_type (push target) to account (single account) or account_list (a list of accounts).
2. Set account_type. For account type details, see Account Type Value Table.
3. Set account_push_type to specify whether to push to the recent or all devices bound to each account.

   Sample push

   {
   "audience_type": "account",
     "account_list": [
      "12345"
    ]
   "account_type":"991",
   "account_push_type":0,
   "message_type": "notify",
   "message": {
       "title": "Push to a QQ account number",
       "content":"Get online to claim your prize!"        
   },
   }
   

Push via file upload

Step 1. Call the account package upload API

Upload your account package file as instructed in Account Package Upload API. After the call succeeds, an upload_id will be returned, such as 11231.

Step 2. Call the push API

1. When you call the push API, set audience_type (push target) to package_account_push (account package push), enter the upload_id, for example, 11231, obtained in Step 1.
2. Set account_type. For account type details, see Account Type Value Table.
3. Set account_push_type to specify whether to push to the recent or all devices bound to each account.

Sample push

The following sample pushes a message to users who have won prizes in a marketing campaign:

{
  "audience_type": "package_account_push",
  "upload_id": 11231,
  "account_push_type":0,
  "message_type": "notify",
  "message": {
      "title": "Congrats on winning in the campaign",
      "content":"Get online to claim your prize!"        
  }
}

Account Type Value Table