Anonymous contexts and users

To distinguish logged-in end users from anonymous end users in the SDK:

Context context = Context.Builder("context-key-123abc")
    .Anonymous(true)
    .Build();
COPY

To auto-generate a key for any context whose anonymous attribute is true:

Configuration config = Configuration.Builder("mobile-key-123abc")
    .GenerateAnonymousKeys(true)
    .Build();
COPY

If you set this option, you must still specify a non-null key as a placeholder when you construct the Context, because the SDK does not allow a Context to exist with a null key. When you pass this context to SDK methods like Init or Identify, the SDK replaces the placeholder key with a generated key.

In this example, the placeholder key is "unknown-context-key", but it could be any non-empty string:

Context context = Context.Builder("unknown-context-key")
    .Anonymous(true)
    .Build();
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

LDContext context = LDContext.builder("context-key-123abc")
    .anonymous(true)
    .build();
COPY

When you mark the context as anonymous, you can leave the key parameter in the Builder null or make it an empty string. The client will automatically set it to a LaunchDarkly-specific, device-unique string that is consistent between app restarts and device reboots.

To distinguish logged-in end users from anonymous end users in the SDK:

struct LDUser *user = LDUserNew("user-key-123abc");
LDUserSetAnonymous(user, true);
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

const anonymousUser2 = { key: 'user-key-123abc', anonymous: true };
COPY

To create an anonymous user with an auto-generated key, specify the "anonymous" property and omit the "key" property. The LaunchDarkly client creates a unique key for this user and caches it locally:

const anonymousUser = { anonymous: true };
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

LDUser user = LDUserBuilder('user key')
    .anonymous(true)
    .build();
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

var contextBuilder = LDContextBuilder(key: "context-key-123abc")
contextBuilder.anonymous(true)
let context = contextBuilder.build().get()
COPY

Alternatively, you can omit the key parameter. The client will automatically set the isAnonymous property for the context, and set the key to a LaunchDarkly-specific, device-unique string that is consistent between app restarts and device reboots.

Here's how:

// Have the SDK use a device persistent key. 
// This sets `isAnonymous` by default.
let context = try LDContextBuilder().build().get()
COPY

To create an anonymous context, specify the anonymous property and omit the key property. The client will automatically set the key to a LaunchDarkly-specific, device-unique string that is consistent between app restarts and device reboots.

Here's how:

const anonymousUserContext = {
  kind: 'user',
  anonymous: true
};
// A multi-context can contain both anonymous and non-anonymous contexts.
// Here, the organization is not anonymous.
const multiContext = {
  kind: 'multi',
  user: anonymousUserContext,
  org: {
    key: 'org-key-123abc',
    name: 'Example organization name'
  }
}
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

const anonymousContext = { kind: 'user', key: 'user-key-123abc', anonymous: true };
COPY

You can also have the SDK generate the key for you. Specify the anonymous property and omit the key property. The client will automatically set the key to a LaunchDarkly-specific, device-unique string that is consistent between app restarts and device reboots.

Here's how:

const anonymousContext = { kind: 'user', anonymous: true };
COPY

To create an create an anonymous context, specify the anonymous property. If you omit the context key when building an anonymous context, the client will automatically set it to a LaunchDarkly-specific, device-unique string that is consistent between app restarts and device reboots. If you omit the context key and do not mark the context as anonymous, the SDK gives a usage error.

Here's how:

// This device context is anonymous
// The key is omitted, and the SDK will automatically generate one
const deviceContext = {
  kind: 'device',
  deviceId: '12345',
  anonymous: true
}
// The multi-context contains one anonymous context
// and one non-anonymous context
const multiContext = {
  kind: 'multi',
  user: userContext,
  device: deviceContext
}
COPY

In the 6.x versions of the SDK, the user key is required when building anonymous users. To learn more, read Understanding changes to anonymous users in the React Native SDK 6.x to 7.0 migration guide.

To distinguish logged-in end users from anonymous end users in the SDK:

user.setAnonymous(Boolean)
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

var context = Context.Builder("context-key-123abc")
    .Anonymous(true)
    .Build();
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

LDUser user = new LDUser.Builder('abc123')
    .setAnonymous(true)
    .build();
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

LDUserSetAnonymous(user, true);
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

Context = ldclient_context:set(anonymous, true,
        ldclient_context:new(<<"user-key-123abc">>))
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

import (
    "github.com/launchdarkly/go-sdk-common/v3/ldcontext"
)
// Anonymous context with only a key
context1 := ldcontext.NewBuilder("context-key-123abc").Anonymous(true)
// Anonymous context with a key plus other attributes
context2 := ldcontext.NewBuilder("context-key-456def").
    Anonymous(true).
    SetString("country", "Canada").
    Build()
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

makeContext "user-key-123abc" "user"
  & withAnonymous True
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

LDContext context = LDContext.builder("context-key-123abc")
  .anonymous(true)
  .build();
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

local user = ld.makeUser({
    key       = "user-key-123abc",
    anonymous = true
    }
)
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

const context = {kind:'user', key:'user-key-123abc', anonymous: true};
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

$context = LDContext::builder("context-key-123abc")->anonymous(true)->build();
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

context = Context.builder("context-key-123abc").anonymous(True).build()
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

context = { key: "context-key-123abc", anonymous: true }
COPY

To distinguish logged-in end users from anonymous end users in the SDK:

// Anonymous context with only a key
let context = ContextBuilder::new("context-key-123abc").anonymous(true).build();
// Anonymous context with a key plus other attributes
let context = ContextBuilder::new("context-key-123abc").
    anonymous(true).
    set_value("country", "US".into()).
    build();
COPY