회원가입

mkt_signup 시에는, 회원가입하는 user_id를 명시해주어야 합니다. 이어서 이 유저를 계속 로그인 상태로 유지할지, 아니면 직접 로그인 시킬지에 따라 persistUesr 옵션을 설정해주어야 합니다.

이 로그인상태는 고객의 기기로 푸시메세지를 보낼때 고객의 보유 여부 기준이 됩니다. (관련 문서)

사용자가 회원가입했음을 SDK에 알립니다. 사용자 식별자(user id)를 전달하여 이후 이벤트와 데이터를 사용자와 연결합니다. 만약, 회원가입 이후 자동로그인의 흐름을 사용하지 않는 경우, persistUser 옵션을 false로 명시해주어야 합니다. 제공되지 않는 경우 기본값은 true입니다. 이벤트 이름은 자동으로 mkt_signup으로 설정되어 수집 서버에 전달됩니다.

JavaScript

아래와 같이 유저 정보와 이벤트 프로퍼티를 함께 전달할 수 있습니다 .

mtap.signup(user.id, // "USER_ID_1234"
  {
    // 유저 속성
    mkt_name: user.name, // 'John Doe',
    mkt_email: user.email, // '[email protected]',
    mkt_gender: user.gender // 'Male',
  }, 
  {
    // 이벤트 속성
    retain_from_adv: false
  },
  false // persistUser 옵션
);

유저 프로퍼티와 이벤트 프로퍼티의 순서가 바뀌지 않도록 주의하세요.

Android - Kotlin

Android - Java

IOS - Swift

Flutter - Dart

Best Practice

플랫폼의 회원가입 시나리오에 따라 연동 방식이 달라집니다.

1. 회원가입 이후 유저가 명시적으로 로그인을 해야 하는 경우

회원가입 이벤트에서는 반드시 user_id가 필요합니다. 다만 이후 발생하는 이벤트는 다시 익명 유저 이벤트로 기록되어야 합니다. 이를 위해 persistUser 값을 false로 설정하면, SDK가 해당 이벤트를 user_id와 함께 기록한 뒤 자동으로 익명 상태로 복귀하도록 동작합니다.

Marketap.signup(
  userId: user.id, // "USER_ID_1234"
  userProperties: {
    // 유저 속성
    "mkt_name": user.name // 'John Doe',
    "mkt_email": user.email // '[email protected]',
    "mkt_gender": user.gender // 'Male',
  }, 
  eventProperties: {
    // 이벤트 속성
    "retain_from_adv": false
  },
  persistUser: false
);

2. 회원가입 이후 유저가 가입된 데이터로 자동으로 로그인되는 경우

이 경우에는 persistUser 값을 별도로 설정하지 않거나 true로 지정해야 합니다. 이렇게 하면 SDK가 해당 이벤트 이후에도 로그인 이벤트처럼 동일한 유저와 계속 연결된 상태를 유지합니다.

Marketap.signup(
  userId: user.id, // "USER_ID_1234"
  userProperties: {
    // 유저 속성
    "mkt_name": user.name // 'John Doe',
    "mkt_email": user.email // '[email protected]',
    "mkt_gender": user.gender // 'Male',
  }, 
  eventProperties: {
    // 이벤트 속성
    "retain_from_adv": false
  },
  persistUser: true // null인 경우도 true로 간주 (default)
);