{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Activation","product_name":"Engage Studio","type":"markdown"},"seo":{"title":"Mobile In-App SDK Integration Prerequisites","description":"Prepare the endpoints, credentials, event schema, and native Engage Mobile SDK settings required to integrate Mobile In-App Messaging.","siteUrl":"https://docs.treasure.ai","image":"/assets/treasure-ai-social-preview.e6fefb35676f6da91c2d1bc783bd39e618e7af2b1ad3aa52a96ae69d72e700fe.b1bff462.png","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"mobile-in-app-sdk-integration-prerequisites","__idx":0},"children":["Mobile In-App SDK Integration Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this page when you are preparing an iOS or Android app to request and display Mobile In-App messages. Campaign configuration belongs in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/setup-and-prerequisites"},"children":["Mobile In-App Campaign Setup"]}," guide."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Beta"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The native SDK integration is in preview. APIs, payloads, package distribution, and event schemas may change before general availability."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-values","__idx":1},"children":["Required Values"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Prepare these values before integrating the SDK:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A write-only API key for event ingestion."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Records endpoint for the account region."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Personalization endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Personalization token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A destination database and table for trigger events."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An event schema that identifies the screen or action that should trigger a message."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keep the write-only API key and Personalization token outside message content and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profileContext"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configure-realtime-personalization-for-the-app","__idx":2},"children":["Configure Realtime Personalization for the App"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Complete the app-facing Realtime Personalization configuration before testing a trigger event:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Realtime Personalization 2.0"]}," for the account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the RT event tables that receive mobile app events."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ID stitching"]}," when campaigns require a unified customer identity."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The campaign owner creates the Parent Segment, Realtime Personalization entry, and Personalization Section in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/setup-and-prerequisites"},"children":["Mobile In-App Campaign Setup"]}," guide."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"define-the-trigger-event-contract","__idx":3},"children":["Define the Trigger Event Contract"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The app must send an event when a customer reaches a screen or performs an action that can trigger a campaign. The event name, screen name, customer identifier, and targeting attributes must use the names configured in Realtime Personalization."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the supported event namespaces and fields, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/sdk-reference"},"children":["Engage Mobile SDK API and Event Reference"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK does not infer business events such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["purchase"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["add_to_cart"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]},". The app must create and send those events when a campaign depends on them."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"install-the-native-sdk-integration","__idx":4},"children":["Install the Native SDK Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the platform-specific integration guide for the SDK artifact you received:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/developer-guide-ios"},"children":["iOS SDK Integration"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/developer-guide-android"},"children":["Android SDK Integration"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/rich-landing-integration"},"children":["Hosted Pages WebView and Bridge Integration"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The app must initialize the Core SDK once, configure the Personalization endpoint and token, and call the platform-specific ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TDEngage.install"]}," method before the first trigger event."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verify-the-integration","__idx":5},"children":["Verify the Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before creating a campaign, verify the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["RT events arrive in the expected table."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The customer ID resolves as expected."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Parent Segment contains the test customer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Personalization entry and Section are active and available to the app."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A test event causes the app to request a message."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Engage Mobile SDK can display the response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The app safely handles a response with no matching message."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For implementation failures, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/sdk-troubleshooting"},"children":["Mobile In-App SDK Troubleshooting"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-documentation","__idx":6},"children":["Related Documentation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/setup-and-prerequisites"},"children":["Set Up Mobile In-App Campaigns"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/sdk-reference"},"children":["Engage Mobile SDK API and Event Reference"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/measurement"},"children":["Mobile In-App Measurement"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/sdk-troubleshooting"},"children":["Mobile In-App SDK Troubleshooting"]}]}]}]},"headings":[{"value":"Mobile In-App SDK Integration Prerequisites","id":"mobile-in-app-sdk-integration-prerequisites","depth":1},{"value":"Required Values","id":"required-values","depth":2},{"value":"Configure Realtime Personalization for the App","id":"configure-realtime-personalization-for-the-app","depth":2},{"value":"Define the Trigger Event Contract","id":"define-the-trigger-event-contract","depth":2},{"value":"Install the Native SDK Integration","id":"install-the-native-sdk-integration","depth":2},{"value":"Verify the Integration","id":"verify-the-integration","depth":2},{"value":"Related Documentation","id":"related-documentation","depth":2}],"frontmatter":{"seo":{"title":"Mobile In-App SDK Integration Prerequisites","description":"Prepare the endpoints, credentials, event schema, and native Engage Mobile SDK settings required to integrate Mobile In-App Messaging."}},"lastModified":"2026-10-24T07:54:27.640Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/marketing-cloud/engage-studio/channels/mobile-inapp/sdk-integration-prerequisites","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}