After you connect to a vendor channel, some vendor applications require additional receipt configuration. Without this configuration, you cannot confirm the delivery status of push notifications or identify the specific reason for a push failure. Therefore, you must configure receipts for these vendor applications.
After you configure receipts, you can:
Confirm the delivery status of push messages and improve the push success rate.
View detailed reasons for push failures in the troubleshooting tool and receipt logs in the EMAS console.
Optimize your push policy based on failure reasons to reduce push costs.
This topic provides best practices for configuring application receipts for each vendor channel to help you manage your push service more effectively.
Receipt information for each vendor
Vendor channel |
Supports delivery receipts |
Are click receipts supported? |
Requires extra configuration |
Notes |
|
Xiaomi |
✅ |
✅ |
❌ |
/ |
|
Huawei |
✅ |
❌ |
✅ |
See details for configuration. |
|
Honor |
✅ |
✅ |
✅ |
See details for configuration. |
|
vivo |
Old receipt |
✅ |
❌ |
❌ |
|
New receipt |
✅ |
❌ |
✅ |
||
OPPO |
✅ |
❌ |
❌ |
/ |
|
Meizu |
✅ |
✅ |
✅ |
See details for configuration. |
|
Google FCM |
❌ |
❌ |
❌ |
/ |
|
HarmonyOS |
✅ |
✅ |
✅ |
See details for configuration. |
|
Apple APNs |
✅ |
✅ |
✅ |
|
|
On Android, only some vendor channels provide a click receipt feature. To accurately monitor click data and handle click-to-redirect events for all vendor channels, you can integrate with the auxiliary pop-up window.
Vendors outside China, such as Google and Apple, do not provide a delivery receipt feature. Therefore, you cannot monitor whether a push is actually received on the client. By default, a successful delivery is considered a successful push.
After a receipt is successfully configured, it takes effect within 15 minutes.
Configuration steps for each vendor
Huawei
After you integrate the Huawei channel software development kit (SDK), you must perform the following steps to configure message receipts. This configuration ensures that the Huawei channel works correctly and sends receipt information to the EMAS platform.
Configure on the Huawei platform
Log on to Huawei AppGallery Connect.
Click My projects. In the project list, find your project. Navigate to the Configuration tab by choosing Grow > Push Kit > Configuration.
On this page, you can configure project-level receipts or app-level receipts. Note that the webhook URL for project-level receipts applies to all applications in the project. If you configure both project-level and app-level receipt addresses, the app-level address takes precedence.
This example uses app-level receipts. Select the application for which you want to configure receipts and click Enable to change the app receipt status.
In the Select receipt dialog box, click New receipt.
On the Receipt configuration page, set the following parameters. Click Test receipt to test the webhook address. Click Submit to create the receipt.
Webhook address: https://amspush-ack.aliyuncs.com/hw/
Supported version: Select V2.
If you have multiple receipts, select the receipt for the EMAS platform as the default receipt and obtain the receipt configuration ID. Click OK to enable app receipts.
Configure in the EMAS console
Go to the EMAS console. In the navigation pane, choose User Growth > Mobile Push > Configuration Management > Application Configuration > Vendor Channels. Select the Android application, enter the Default Receipt ID for the Huawei vendor application, and then click Save.
FAQ
Q: The Huawei vendor channel in Mobile Push supports multiple receipt addresses. If I configure multiple addresses, can EMAS receive the receipts?
A: There are two solutions:
In the Huawei vendor channel's receipt settings, set the receipt for EMAS Mobile Push as the default receipt.
When you send a push, set the
AndroidHuaweiReceiptIdparameter to the receipt ID obtained from the Huawei vendor channel.
Honor
After you integrate the Honor channel SDK, you must perform additional configuration to ensure that the message receipt feature works correctly. Follow these steps to send Honor receipt information to the EMAS platform.
Configure on the Honor platform
Log on to the HONOR Developers console and go to the Management Center.
Under App services, choose Develop > Push Service to go to the Push Service page.
In the push service list, select the application for which you want to configure receipts, and then click App receipt to go to the app receipt page.
On the app receipt page, click New receipt to go to the Receipt configuration page.
On the Receipt configuration page, enter the Receipt name and Webhook address, select the Receipt scope, and click Submit.
Webhook address: https://amspush-ack.aliyuncs.com/ho/
Receipt scope: Select both Delivery receipt and Click receipt.
vivo
After you integrate the vivo channel SDK, you must perform additional configuration to ensure that the message receipt feature works correctly. Follow these steps to send vivo receipt information to the EMAS platform.
vivo channel receipt details
The vivo vendor provides two sets of receipt APIs: new and old. The new receipt feature collects more data metrics than the old APIs. We recommend that you use the new receipt feature. For more information about the data metrics, see vivo Message Receipt. To use the new vivo receipt feature, you must enable and configure message receipts on the vivo Open Platform. This step is not required for the old APIs. This configuration allows vivo to send receipt data to the EMAS platform.
After you enable the new receipt feature, the old receipt feature becomes invalid.
If you do not enable the app receipt address, Mobile Push can only count deliveries. It cannot detect push failures or their reasons. Therefore, you must enable the app receipt address.
After you add the webhook address, it takes effect within one hour. If you configure a webhook address for an existing app that did not have one, statistics may not be collected during an intermediate period. Keep this in mind before you make the switch.
After you configure the webhook address, record the receipt ID that is displayed on the interface and configure it in the EMAS console.
Configure on the vivo platform
Log on to the vivo Open Platform.
On the Application List page, find your application and click Application Information in the Operations column for the application:
On the Application Information page, click the Enable button next to APP Receipt Address.
In the dialog box that appears, click OK.
On the Select receipt page, click New receipt.
Enter the Receipt Address and click OK.
Webhook address: https://amspush-ack.aliyuncs.com/vivo/
Click OK to save the receipt address.
Obtain the Receipt ID and click Back.
The status of APP Receipt Address changes to Enabled, which indicates that the receipt configuration is complete.
Configure in the EMAS console
Go to the EMAS console. In the navigation pane, choose User Growth > Mobile Push > Configuration Management > Application Configuration > Vendor Channels. Select the Android application, enter the Message Receipt ID for the vivo vendor application, and then click Save.
Meizu
After you integrate the Meizu channel SDK, you must perform additional configuration to ensure that the message receipt feature works correctly. Follow these steps to send Meizu receipt information to the EMAS platform.
Configure on the Meizu platform
Log on to the Meizu Flyme Push Platform, select the application for which you want to enable push receipts, and click Open Application.
Choose Configuration Management > Receipt Management to go to the receipt management page. On the Receipt Management page, add the following two receipts. If you do not set message receipts, push notifications will not be sent through the Meizu channel.
Webhook address: You must configure both http://amspush-ack.aliyuncs.com/mz/ and https://amspush-ack.aliyuncs.com/mz/.
HarmonyOS
After you integrate the HarmonyOS channel SDK, you must perform additional configuration to ensure that the message receipt feature works correctly. Follow these steps to send HarmonyOS receipt information to the EMAS platform.
Configure the HarmonyOS application
Log on to Huawei AppGallery Connect.
Click My projects. In the project list, find your HarmonyOS project. Navigate to the Configuration tab by choosing Grow > Push Kit > Configuration.
On this page, you can configure project-level receipts or app-level receipts. Note that the webhook URL for project-level receipts applies to all applications in the project. If you configure both project-level and app-level receipt addresses, the app-level address takes precedence.
This example uses app-level receipts. Select the application for which you want to configure receipts and click Enable to change the app receipt status.
In the Select receipt dialog box, click New receipt.
On the Receipt configuration page, set the following parameters. Click Test receipt to test the webhook address. Click Submit to create the receipt.
Webhook address: https://amspush-ack.aliyuncs.com/hm/
Supported version: Select V2.
If you have multiple receipts, select the receipt for the EMAS platform as the default receipt and obtain the receipt configuration ID. Click OK to enable app receipts.
Configure in the EMAS console
Go to the EMAS console. In the navigation pane, choose User Growth > Mobile Push > Configuration Management > Application Configuration > Vendor Channels. Select the HarmonyOS application, enter the Message Receipt ID for the HarmonyOS vendor application, and then click Save.
Apple APNs
APNs does not officially provide a receipt feature. You can obtain a similar notification receipt capability by integrating the iOS Extension SDK.
Integrate the SDK on the client
Complete the iOS Extension SDK integration.
Send pushes from the server-side
When you send notifications using the Push API or the PushV2 - Advanced Push API, set the iOSMutableContent parameter to true. For PushV2, set PushTask.Notification.Ios.Mutable to true.