SDK-5238 Delayed init android docs

_docs/_developer_guide/platform_integration_guides/android/advanced_use_cases/delayed_initialization.md

@@ -0,0 +1,111 @@
+---
+nav_title: Delayed Initialization
+article_title: Delayed Initialization for Android and FireOS
+platform: 
+  - Android
+  - FireOS
+page_order: 10
+description: "This article covers how to implement delayed initialization on the Android SDK and optionally preserve push notification analytics when delayed initialization is enabled."
+
+---
+
+# Delayed initialization for the Braze Android SDK
+
+> Learn how to enable delayed initialization and opt in to preserve push notification analytics when it is enabled. This can be useful when you need to set up other services before initializing the SDK, such as fetching configuration data from a server or waiting for user consent.
+
+While delayed initialization is enabled, all network connections will be canceled, and the Braze SDK will not pass any data to Braze servers.
+
+{% alert important %}
+Delayed initialization is available starting in Android SDK version xxxx.
+{% endalert %}
+
+## Enabling Delayed Initialization
+
+Delayed initialization is disabled by default. In order to delay initialization, update your `braze.xml` file to include `com_braze_enable_delayed_initialization` and confirm its value is set to `true`:
+
+```xml
+<bool name="com_braze_enable_delayed_initialization">true</bool>
+```
+
+This can additionally be done at runtime via:
+
+{% tabs %}
+{% tab JAVA %}
+
+```java
+Braze.enableDelayedInitialization(context);
+```
+
+{% endtab %}
+{% tab KOTLIN %}
+
+```kotlin
+Braze.enableDelayedInitialization(context)
+```
+
+{% endtab %}
+{% endtabs %}
+
+## Setting Delayed Initialization Push Analytics Behavior
+
+When delayed initialization is enabled, you have the option to queue or drop push analytics. If push analytics are queued, these events will be logged once delayed initialization is disabled. 
+
+By default, push analytics are queued when delayed initialization is enabled. In order to drop push analytics, update your `braze.xml` file to include `com_braze_delayed_initialization_analytics_behavior` as follows: 
+
+```xml
+<string name="com_braze_delayed_initialization_analytics_behavior">DROP</string>
+```
+
+To explicitly queue push analytics, update your `braze.xml` file to include `com_braze_delayed_initialization_analytics_behavior` as follows:
+
+```xml
+<string name="com_braze_delayed_initialization_analytics_behavior">QUEUE</string>
+```
+
+Additionaly, the push analytics behavior can be set during runtime in the [`Braze.enableDelayedInitialization()`](set link after release) method by using one of the following code snippets:
+
+{% tabs %}
+{% tab JAVA %}
+
+```java
+// Drop all push analytics
+Braze.enableDelayedInitialization(context, DelayedInitializationAnalyticsBehavior.DROP);
+
+// Queue push analytics
+Braze.enableDelayedInitialization(context, DelayedInitializationAnalyticsBehavior.QUEUE);
+```
+
+{% endtab %}
+{% tab KOTLIN %}
+
+```kotlin
+// Drop all push analytics
+Braze.enableDelayedInitialization(context, DelayedInitializationAnalyticsBehavior.DROP)
+
+// Queue push analytics
+Braze.enableDelayedInitialization(context, DelayedInitializationAnalyticsBehavior.QUEUE)
+```
+
+{% endtab %}
+{% endtabs %}
+
+## Initializing After Delay
+
+To initialize the SDK once the delay period is over, use the [`Braze.disableDelayedInitialization()`](set link after release) method:
+
+{% tabs %}
+{% tab JAVA %}
+
+```java
+Braze.disableDelayedInitialization(context);
+```
+
+{% endtab %}
+{% tab KOTLIN %}
+
+```kotlin
+Braze.disableDelayedInitialization(context)
+```
+
+{% endtab %}
+{% endtabs %}

_docs/_developer_guide/platform_integration_guides/android/initial_sdk_setup/android_sdk_integration.md

@@ -140,3 +140,7 @@ Braze will now be able to collect [specified data from your application]({{site.
 
 Visit the following articles in order to enable [custom event tracking]({{site.baseurl}}/developer_guide/platform_integration_guides/android/analytics/tracking_custom_events/), [push messaging]({{site.baseurl}}/developer_guide/platform_integration_guides/android/push_notifications/android/integration/standard_integration/), [Content Cards]({{site.baseurl}}/developer_guide/platform_integration_guides/android/content_cards/integration/) and the complete suite of Braze features.
 
+{% alert warning %}
+If your application requires additional setup before initializing the SDK, such as fetching configuration data from a server or waiting for user consent, please refer to the [Delayed Initialization]({{site.baseurl}}/developer_guide/platform_integration_guides/android/advanced_use_cases/delayed_initialization/) documentation page.
+{% endalert %}
+