Tencent Cloud

Recent Pages

Multi-Package Name Push

Last updated: 2024-01-16 17:34:39

For various types of Android apps, especially Android games, it is a common practice in business operations to customize versions for different channels and use different package names; however, this will lead to excessive workload for subsequent message pushes, as each package requires separate push, which is time-consuming and laborious and makes it difficult to achieve precise push and high efficiency.
The new "multi-package name push" feature of Tencent Push Notification Service is a convenient solution to this problem. After this feature is enabled, you can easily add a multi-package name for different channels, and then one message push is enough to reach all channels.
Scenarios
For marketing promotions, a game vendor needs to publish an event announcement to all game players. The game is released in multiple app markets (such as CoolAPK, Anzhi, Wandoujia, and 360) with different package names. In this case, Multi-Package Name Push can be used to send the event announcement to all packages at a time.
Preparations
Configuring in console
1. Log in to the Tencent Push Notification Service console and go to the Product Management page.
2. Select the application for which to configure multiple package names and click Configuration Management.
﻿
﻿
3. If the application does not have a main package name, you need to enter one and then click Add another package name to enter a channel-specific package name.
﻿
﻿
4. If the application already has a main package name, click Edit to open the Package Name Management section, and click click here to add to configure a package name.
﻿
﻿
Note: 
Up to 50 package names can be configured.
Configuring vendor channel for multi-package name
If your application has multiple package names, when you need to deliver messages to package names through vendor channels, you need to apply for a vendor key for each package name and configure it in the Tencent Push Notification Service console > Message Management > Basic Config.
Taking Huawei as an example, if the application has multiple package names configured, multiple key configurations will appear after the Huawei channel is enabled, and you need to complete the configuration for each package name. Otherwise, messages to devices under a package name with incomplete configuration will be sent through the Tencent Push Notification Service channel after multi-package name push is enabled.
﻿
﻿
Integrating the SDK
After configuring a package name, get the AccessID and AccessKey, and configure as instructed in Android SDK Integration Guide or the Quick Integration process in the console.
﻿
﻿
Directions
Setting the policy in the console
After the above configuration is completed and confirmed, you can enable multi-package name push in the Tencent Push Notification Service console > Message Management > Task List > Create Push > Advanced Settings, as shown below:
﻿
﻿
After enabling Multi-Package Name Push, a push will be delivered to devices that match the push target under all package names.
Note: 
 The multi-package name push feature is available only to Android. If a vendor channel corresponding to a package name is not configured, messages to devices registered under the package name will be delivered through the Tencent Push Notification Service channel.
Setting the policy with RESTful APIs
Set multi_pkg to true in the optional parameter of the Rest API to enable multi-package name push. For more information, please see Push API Parameter Description.
Sample push:
{
    "audience_type": "token",
    "token_list": [
        "05da87c0ae5973******9e08d884aada5bb2"
    ],
    "message_type": "notify",
    "multi_pkg":true,
    "message": {
        "title": "Push title",
        "content": "Push content",
        "android": {
             "custom_content":"{\\"key\\":\\"value\\"}"
        }
    }
}
﻿