The logged in signal is how your Android app tells Connect who just authenticated. The SDK sends an identifier — typically a customer ID or email address — and Connect uses it to match the app visitor to an existing contact or create one. Once the contact is known, marketers can target push notifications to that person and attribute the rest of the session to their profile.

Languages: Kotlin and Java

Availability: Pro, Premium, and Ultimate

How identification works

Two parameters do the identification work:

• identifierName — the contact attribute in Connect that the value should be matched against, for example Customer ID or Email Address.
• identifierValue — the value itself.

The identifierName must match a contact attribute name exactly as it appears in Connect, including capitalization and spacing. To look up attribute names, in Connect go to Audience > Contacts > Attributes.

Choosing an identifier

Use the most stable identifier your authentication service returns:

1. Customer ID (preferred). If your Connect audience has a contact key attribute, use it — this is what Connect uses internally to identify a contact.
2. Email address or phone number. Both are standard contact attributes in Connect and work well when no customer ID is available.

When to call

API reference

Connect.logIdentificationEvent(
    identifierName: String,
    identifierValue: String,
    url: String = "http://acoustic.co/test",
    signalType: String = "loggedIn",
    additionalParameters: Map<String, String> = emptyMap()
): Boolean

Returns false without throwing if either identifierName or identifierValue is blank.

Supported fields in additionalParameters

Required

• loginMethod — how the user authenticated, for example "email", "passwordless", or "sso".

Optional

• ssoProvider — the SSO provider name, for example "Google" or "Apple". Include only for SSO-backed sign-ins.
• name — a short label for the signal instance. Appears as the signal name in Connect.
• description — a longer human-readable note describing the event.

Example

Call logIdentificationEvent() after authentication is confirmed — not when the user submits the sign-in form.

authService.signIn(email, password) { result ->
    when (result) {
        is Success -> {
            Connect.logIdentificationEvent(
                identifierName = "Email Address",
                identifierValue = result.user.email,
                url = "SignInScreen",
                signalType = "loggedIn",
                additionalParameters = mapOf(
                    "loginMethod" to "email"
                )
            )
            navigateToDashboard()
        }
        is Failure -> showError(result.error)
    }
}

Try the sample app

Both sample apps include a working identity screen:

• View-based: IdentityFragment.kt
• Jetpack Compose: IdentityScreen.kt

Troubleshooting

Signal not appearing in Connect?

• Verify identifierName and identifierValue are not empty or whitespace-only. The SDK trims both and returns false silently if either is blank.
• Confirm identifierName matches a contact attribute in Connect exactly — including capitalization and spacing.
• Confirm the signal fires after authentication is confirmed, not on form submit.
• Confirm additionalParameters includes loginMethod. The signal is rejected if this field is missing.

Contact not created or updated?

• Verify the identifierName value matches a contact attribute defined in Connect.
• Attribute values must be passed as strings. If the matching attribute in Connect is typed as a number, Boolean, or date, pass the value as a string representation (for example, "42", "true", or an ISO 8601 date string).