Skip to content

Documentation needs more clarity around identification #74

@JulianKingman

Description

@JulianKingman

The react native documentation is lacking detail around identification that makes it confusing. Here's what I've run into so far:

  • Do we need to set up identification in the native code in order to use the SDK? It says it's optional, but also says here that we need to set up identity requests in the native code first.
  • Before a user has identifying information available, what should we be using to identify them? IDFA? Are they automatically identified through the IDFA when an identity request is created, as specified in the iOS docs? I see that there could be a lot of flexibility in how to do this, but I really would like to be shown the "recommended way" to handle it.
  • Does the comment about IDFA's no longer being included automatically need to be handled somehow? Not sure how to do this.
  • None of the functions documented are described, so I'm left to guess the difference between new MParticle.IdentityRequest, MParticle.Identity.identify, MParticle.Identity.login, MParticle.Identity.logout and MParticle.Identity.modify. There's some description of the corollary functions in the iOS SDK docs, so it shouldn't take much to update the react native docs.
  • What's the difference between request.setUserIdentity('example@example.com', MParticle.UserIdentityType.Email) and var request = new MParticle.IdentityRequest(); request.email = 'example@example.com' MParticle.Identity.identify(request);
  • How do we add multiple identifiers in a row? I assume that involves setting request properties sequentially before running MParticle.Identity.identify(request), it would be nice to see an example.
  • Should I be using the same IdentityRequest class instance throughout the app, for example to run login, identify and modify commands?

Unrelated: pod setup in the docs doesn't indicate specific versions. Auto-linking should solve this.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions