Common API

인쇄

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

AccessKey 설정

발급받은 accessKey를 설정합니다.

late final _shopLiveCommonPlugin = ShopLiveCommon();
_shopLiveCommonPlugin.setAccessKey(accessKey: String?)

사용자 인증

간편 인증

void setUser({required String accessKey, required ShopLiveCommonUser user})을 통해 사용자 정보를 저장합니다.

자세한 내용은 authentication 가이드를 참조하세요.

ShopLiveCommonUser

Property name	Type	Description
userId	String	A value that ensures the uniqueness of a logged-in user (Required)
name	String?	User name
age	Int?	User age
gender	ShopLiveCommonUserGender?	User gender
userScore	Int?	Integers are available from -100 to 100.
custom	Map<String, dynamic>?	Any data can be set up to 1KB. It allows checking the total/login viewers' data.

late final _shopLiveCommonPlugin = ShopLiveCommon();
_shopLiveCommonPlugin.setUser(
    accessKey: "accessKey",
    user: ShopLiveCommonUser(
      userId: "userId",
      userName: "TestUser",
      userScore: 0,
      gender: ShopLiveCommonUserGender.NEUTRAL,
      age: 20,
      custom: {"key": "value"},
    ));

JWT 인증

void setAuthToken({required String? userJWT})을 통해 ShopLive JWT 인증합니다.

late final _shopLiveCommonPlugin = ShopLiveCommon();
_shopLiveCommonPlugin.setAuthToken(userJWT: String)

인증 정보 초기화

설정된 인증 정보를 초기화합니다.

late final _shopLiveCommonPlugin = ShopLiveCommon();
_shopLiveCommonPlugin.clearAuth()

마케팅 유입 경로 추적

다음의 함수들을 통해 UTM 태그(Source/Medium/Campaign/Content)를 트래킹할 수 있습니다. 로깅된 정보는 데이터 인사이트에서 확인할 수 있습니다.

void setUtmSource({required String? utmSource})
void setUtmMedium({required String? utmMedium})
void setUtmCampaign({required String? utmCampaign})
void setUtmContent({required String? utmContent})

Parameter name	Type	Description
utmSource	String?	해당 유입이 어디에서 발생하였는지 전달합니다.
utmMedium	String?	해당 유입이 어떻게 발생하였는지 전달합니다. 구글은 medium 파라미터를 유입이 유도된 마케팅 방식을 지칭하도록 세팅하는 것을 권장하고 있습니다. (e.g. cpc, banner, email, blog, social etc.)
utmCampaign	String?	어떤 광고의 캠페인으로 유입이 발생하였는지를 전달해줍니다. Campaign Name, Campaign Term, Campaign Content로 나눠서 만들 수 있습니다.
utmContent	String?	해당 유입이 어떤 내용을 가진 포스팅/광고에 의해서 발생하였는지 전달합니다. 주로 campaign 파라미터의 하위 구분으로 자주 활용됩니다.

Sample code

late final _shopLiveCommonPlugin = ShopLiveCommon();
_shopLiveCommonPlugin.setUtmSource(utmSource: "utm_source")
_shopLiveCommonPlugin.setUtmMedium(utmMedium: "utm_medium")
_shopLiveCommonPlugin.setUtmCampaign(utmCampaign: "utm_campaign")
_shopLiveCommonPlugin.setUtmContent(utmContent: "utm_content")

What's Next

이미지 제작 가이드 (세로 방송)

AccessKey 설정
사용자 인증
마케팅 유입 경로 추적