For AI agents: visit https://developers.maestra.io/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI. Append .md to any documentation page URL to get its markdown version.
Jump to Content
Maestra APIMaestra API
HomeDocumentation
Email CampaignsWebsite PersonalizationMobile AppsWeb PushLoyalty ProgramMaestra API
Documentation
Email CampaignsWebsite PersonalizationMobile AppsWeb PushLoyalty Program
Android

General

  • Maestra Integration Guide
    • 1. DNS Setup
    • 2. Event Tracking
      • Shopify integration
      • Custom integration
    • 3. Historical Data Upload
  • Shopify Native Integration
  • Website integration via JavaScript SDK
  • V3 API

Customers

  • Generating Website Authorization Ticket
  • Authentication
    • By Password
    • By Secret Code
  • Customers Bulk Import
  • Confirming Mobile Number and SMS Subscription
  • Getting Customer Details
  • Getting Customer Segments
  • Exporting Customers
  • Referral Program
  • Sending Confirmation Codes in SMS
  • Sign-Up, Subscription Forms, Site Tracking
    • JavaScript
    • xml
  • Updating Customer Details
    • JavaScript
    • xml
  • Verifying Customer by Database

Custom Fields

  • Importing Custom Field Values

Orders

  • Bulk Import of Orders
  • Getting Customer Order List
  • Getting Sum Total of Paid Orders
  • Exporting Orders
  • Order Placement
    • JavaScript
    • xml
  • Order Precalculation
  • Order Recalculation
  • Updating Orders
  • Begin order saving transaction (processing)
  • Order calculation
  • Commit order saving transaction (processing)
  • Rollback order saving transaction (Processing)

Products

  • Products Bulk Import
    • CSV
    • xml
  • Bulk Adding Products to List
  • Bulk Product List Updates
  • Category Actions
    • JavaScript
    • xml
  • Exporting Product Actions
  • Exporting Product Category Actions
  • Getting Customer Product List
  • Importing Product Categories
    • CSV
    • xml
  • Price Calculation and Messaging for Products
  • Product-Related Actions
    • JavaScript
    • xml
  • Product List Actions
    • xml
    • JavaScript

Promo Codes

  • Promocodes Bulk Import
  • Promocode Pools Bulk Import
  • Promo Codes Status Bulk Import
  • Rewarding with Promo Codes via API

Bonus Points

  • Getting Customer Bonus Points
  • Getting Customer's Balance Update History
  • Exporting Balance Updates
  • Updating Customer's Bonus Points Balance

Product Recommendations

  • Getting Popular Products
  • Getting Recommendations List

Campaigns

  • Transactional Mailings
    • JavaScript
    • xml
  • Web Push: Firebase Credentials

Gift Cards

  • Gift Card Pools Bulk Import
  • Gift Cards Status Update Bulk Import

Discount Cards

  • Discount Card Replacement
  • Bulk Import of Discount Cards Status
  • Bulk Import of Discount Card Pools
  • Getting Customer's Discount Card List
  • Getting Discount Card Details
  • Issuing Discount Cards to Customers
  • Issuing Discount Cards to Customers with SMS Confirmation
  • Updating Discount Card Status at Checkout
  • Updating Discount Card Status in Personal Profile

Touchpoint Management

  • Areas Bulk Import
  • Channels Bulk Import
  • Touchpoint Bulk Import

Exports

  • Exports overview
  • Export Campaigns
  • Export Campaign Engagement
  • Export API Method Logs
  • Export Webhook Logs
  • Exports to FTP/SFTP
  • Export customers
  • Export customer merges
  • Export customer segmentation changes
  • Export customer actions
  • Export product segmentation changes
  • Export orders and order lines
  • Export promotions

Mobile applications

  • Overview
  • iOS SDK
    • Setting up an Integration Points [iOS]
    • Sandbox Environment
    • Getting Credentials and Setting Up Connection to APNs
    • Adding the SDK to Your App
    • Initializing the SDK
    • Push Notification Setup
    • Setting Up Rich Push Notifications
      • Displaying an image preview
      • Image and button display
    • Handling Push Notification Taps
    • Tracking Push Notification Taps
    • Guaranteed Delivery Setup
    • Getting Mobile App Installation Source
    • Submitting Customer Actions
    • iOS SDK: Configuration Fields
    • iOS SDK: Request Constructor Framework
    • iOS Push Notifications Format
    • iOS SDK: Methods
    • Sending Events via iOS SDK
    • Syncing deviceUUID Between iOS mobile SDK and JS SDKs in app Using a WebView
  • Android SDK
    • Setting up Integration Points [Android]
    • Getting Firebase Credentials
    • Adding the SDK to Your App [Android]
    • Initializing the SDK [Android]
    • Push Notifications Setup for Firebase
    • Tracking Push Notification Taps
    • Getting the App Install Source
    • Submitting Customer Actions
    • Sending Events via Android SDK
    • Android SDK Configuration Fields
    • Android SDK Response Constructor Structure
    • Android SDK Request Constructor Structure
    • Android Push Notification Format
    • Android SDK Methods
    • Syncing deviceUUID Between Android Mobile SDK and JS SDK in a WebView App
    • Receiving Push Notifications from Multiple Providers
  • React Native SDK
    • 1. Adding SDK to Your App
    • 2. Initializing SDK
    • 3.1. Android: Sending Push Notifications via Firebase
    • 3.2. Android: Click counts on Mobile Push Notifications
    • 4.1. iOS: Sending Push Notifications
    • 4.2. iOS: Click Counts for Mobile Push
    • 4.3. iOS: Sending Rich Push Notifications
    • 5. Navigating Push Notification Clicks
    • 6. Getting Mobile App Installation Source
    • 7. iOS additional setup: Setting up Background Tasks for Guaranteed Delivery
    • 8. Integrating Actions in Your App
    • React Native SDK Methods
    • Synchronization of deviceUUID between React Native mobile SDK and JS SDK in a WebView-enabled app
    • React Native Expo
  • Flutter SDK
    • Setting up Integration Points
    • Getting Keys for mobile-push notifications
    • Adding the SDK to Your App
    • Initializing the SDK
    • IOS | Push Notification Sending
    • Android | Push Notification Sending (Firebase)
    • iOS | Setting Up Rich Push Notifications
      • Displaying an image preview
      • Image and button display
    • Sending Push Notification Tap Events to the CDP
    • Navigation on push notification tap
    • Guaranteed Delivery Setup
    • Getting the App Install Source
    • App–Maestra Customer Data Exchange
    • Flutter SDK Methods
    • Syncing deviceUUID Between Flutter Mobile and JS SDKs in app Using a WebView
  • In-App Messaging
  • Notification Center
  • Universal Links
  • Reference
    • Testing your mobile push notification setup
    • Creating a Customer in Maestra
  • SDK integration checklist
    • General problems
      • The app launched but there's an error in the console
      • An SDK request returns an error in the console
      • The user exists in the system but isn't receiving push notifications
    • IOS
      • The app fails to build
      • Deactivation reason : "The app is not registered in the push sending system"
      • The user has not granted push notification permission
      • The small image is not showing in the push notification
      • The large image is not showing when the notification is expanded
      • Action buttons are not showing when the notification is expanded
      • Tapping a push notification is not recorded in Maestra.
      • The tap is tracked but the data is not saved in the project
      • Sending a push notification returns a "wrong token" error
      • Error "wrong environment" or "all access tokens are incorrect"
      • Push notification status: "ContractMismatch"
    • Android
      • Installation status: "The app is not registered in the push sending system"
      • The system shows "sent" but the push notification is not displayed
      • Notifications arrive, but text, icon, or content isn't showing up
      • Push notification icon is showing the wrong color
      • Image isn't showing in push notifications
      • Push notification action buttons aren't working
      • Push notification clicks aren't being tracked in Mindbox
      • Push notification tapped, but the wrong screen opened (or nothing happened)
      • App crashes after notifications are sent
      • Error "wrong environment" or "all access tokens are incorrect"
      • Push notification status: "ContractMismatch"

Data for Analytics

  • How to read your data
  • Data schema
    • Balance changes events
    • Bonus promoactions
    • The relationship between point redemptions and accruals.
    • Points Balances
    • Orders
    • Order items
    • Order line statuses
    • Touchpoints
    • Campaigns
    • Subscription topics
    • Tags
    • Tags in campaigns
    • Campaign engagement
    • Segmentations
    • Segments
    • Customer segment history
    • Customer merge events
    • Folders
    • AB-test dictionary
    • AB-tests variants
    • A/B test participants
    • Custom fields
    • External customer IDs history
  • How to update data periodically
    • How to work with customer merging

AB Testing

  • AB Testing Website through Maestra
Powered by 

Android

Common issues when integrating push notifications in an Android app:

Updated 6 months ago


Push notification status: "ContractMismatch"
Installation status: "The app is not registered in the push sending system"