BD-1887: Deliverability for Chinese Android devices

_docs/_user_guide/message_building_by_channel/push/best_practices.md

@@ -4,7 +4,7 @@ nav_title: Best Practices
 article_title: Push Best Practices
 layout: featured
 guide_top_header: "Push Best Practices"
-guide_top_text: "Before sending out your push messagea, refer to the following articles for things you should know and check for."
+guide_top_text: "Before sending out your push message, refer to the following articles for things you should know and check for."
 page_type: landing
 description: "This landing page is home to best practices and use cases to make sure your push messages inspire engagement rather than annoyance."
 channel: push

_docs/_user_guide/message_building_by_channel/push/best_practices/chinese_push_deliverability..md

@@ -0,0 +1,29 @@
+---
+nav_title: Deliverability for Chinese Android Devices
+article_title: Push deliverability for Chinese Android Devices
+page_order: 10
+
+page_type: reference
+description: "This article covers push deliverability nuances you should be aware of when targeting users on Android devices manufactured by Chinese OEMs."
+channel: push
+
+---
+
+# Push deliverability for Chinese Android devices
+
+Some Android devices manufactured by Chinese Original Equipment Manufacturers (OEMs), such as Xiaomi, OPPO, and Vivo, optimize for longer battery lives through aggressive app lifecycle management. This optimization may have the unintended consequence of shutting down background app processing, which can reduce the deliverability of your push notifications. To make sure that your app's messaging performance works as expected on these devices, your marketing and engineering teams should collaborate and follow the steps outlined in this article.
+
+## Steps for developers
+These OEMs perform their optimizations through aggressive killing of background applications and blocking them from self starting to run background tasks. As a developer, you'll need to configure your app to ask the user to ease these restrictions whenever possible.
+
+This can be achieved by having your app automatically start on your end user's device, which gives your app permission to run in the background and listen for messages from Braze. Unfortunately, since this is an OEM-specific problem and not an Android problem, there are no documented APIs for bringing up the auto-start permission prompt for each OEM.
+
+To solve for this, integrate a library like [AutoStarter](https://github.com/judemanutd/AutoStarter) into your application. AutoStarter supports multiple manufacturers, giving you an easy way to call the startup permission manager on a wide array of devices. After you have integrated AutoStarter, call `AutoStartPermissionHelper.getInstance().getAutoStartPermission(context)` to bring up the startup permission manager on your end user's device. Couple this action with a prompt encouraging the end user to enable "auto-start" for your app. Your marketing team will craft this message—see the next section!
+
+## Steps for marketers
+After your users opt in to receive push notifications, there are additional steps they can take on their end to improve message delivery for these devices. We recommend you follow up your [push primer message]({{site.baseurl}}/user_guide/message_building_by_channel/push/push_primer_messages/) with an in-app message targeted to users on Chinese OEM devices with these additional steps:
+
+- Enable “auto-start” for the app
+- Disable battery optimization for the app
+
+To further amplify your message, add other channels to resurface information from unopened push notifications through out-of-app channels such as SMS, WhatsApp, and LINE and in-app channels like in-app messages and Content Cards. Your users will be able to see anything they might have missed the next time they open the app.