Salesforce Docs Portal

Marketing Cloud Mobile App Messaging SDK

This section provides API reference details for the Marketing Cloud Mobile App Messaging SDK module in React Native unified plugin.

getDeviceId

Returns the device ID that Mobile App Messaging uses to identify the device.

Syntax

MobileAppMessagingSdkModule.getDeviceId();

Returns

  • Promise<string \| null> - A promise that resolves to the device ID, or null.

Example

import { MobileAppMessagingModule } from "@sfmc/react-native-mobileappmessaging";
import type { MAMApi } from "@sfmc/react-native-mobileappmessaging";

const mam: MAMApi = await MobileAppMessagingModule.requestSdk();
const deviceId = await mam.getDeviceId();

See Also

enableAnalytics

Enables analytics in the Mobile App Messaging SDK.

Syntax

MobileAppMessagingSdkModule.enableAnalytics();

Returns

  • void

Example

import { MobileAppMessagingModule } from "@sfmc/react-native-mobileappmessaging";
import type { MAMApi } from "@sfmc/react-native-mobileappmessaging";

const mam: MAMApi = await MobileAppMessagingModule.requestSdk();
mam.enableAnalytics();

See Also

disableAnalytics

Disables analytics in the Mobile App Messaging SDK.

Syntax

MobileAppMessagingSdkModule.disableAnalytics();

Returns

  • void

Example

import { MobileAppMessagingModule } from "@sfmc/react-native-mobileappmessaging";
import type { MAMApi } from "@sfmc/react-native-mobileappmessaging";

const mam: MAMApi = await MobileAppMessagingModule.requestSdk();
mam.disableAnalytics();

See Also

isAnalyticsEnabled

Checks whether analytics is enabled in the Mobile App Messaging SDK.

Syntax

MobileAppMessagingSdkModule.isAnalyticsEnabled();

Returns

  • Promise<boolean> - A promise that resolves to whether analytics is enabled.

Example

import { MobileAppMessagingModule } from "@sfmc/react-native-mobileappmessaging";
import type { MAMApi } from "@sfmc/react-native-mobileappmessaging";

const mam: MAMApi = await MobileAppMessagingModule.requestSdk();
const enabled = await mam.isAnalyticsEnabled();

See Also

setRegistrationCallback

Registers a callback to receive registration change events from the SDK.

Syntax

MobileAppMessagingSdkModule.setRegistrationCallback();

Returns

  • void

Example

import { MobileAppMessagingModule } from "@sfmc/react-native-mobileappmessaging";
import type { MAMApi } from "@sfmc/react-native-mobileappmessaging";

const mam: MAMApi = await MobileAppMessagingModule.requestSdk();
mam.setRegistrationCallback();

const sub = MobileAppMessagingModule.getEmitter().addListener(
  "sfmc_mam_registration",
  (registration) => {
    console.log("MAM registration changed:", registration);
  },
);

sub.remove();

See Also

unsetRegistrationCallback

Unregisters the registration change callback.

Syntax

MobileAppMessagingSdkModule.unsetRegistrationCallback();

Returns

  • void

Example

import { MobileAppMessagingModule } from "@sfmc/react-native-mobileappmessaging";
import type { MAMApi } from "@sfmc/react-native-mobileappmessaging";

const mam: MAMApi = await MobileAppMessagingModule.requestSdk();
mam.unsetRegistrationCallback();

See Also