Register Sticker Usage
제품에서 사용자 행동을 이해하는 것이 매우 중요하다는 것을 알기 때문에 스티커가 제품에서 어떻게 사용되고 있는지 확인할 수 있는 분석 도구를 제공하고 있습니다. Registering Sticker Usage를 적용하면 대시보드를 통해 사용자가 어떻게 스티커를 사용하고 있는지 상세하게 분석할 수 있습니다.
스티커 사용 데이터를 통해 사용자의 취향과감정 데이터를 확인할 수 있습니다. 또한 유료 스티커 판매시 개인화된 스티커 추천 시스템을 통해 유료 구매율을 최적화 할 수도 있습니다.
스티커가 전송될 때 해당 API를 적용하면 필요한 모든 정보를 확인할 수 있습니다.
Request URL
POST
https://messenger.stipop.io/v1/analytics/send/:stickerId
Best Practices
- 권장: 최적의 서비스를 위해 언어(lang)와 국가(countryCode) 파라미터를 사용해 사용자 위치 정보를 제공하세요. 스티팝은 사용자의 선호 언어, 문화, 그리고 로컬 트렌드를 적용해 자동으로 최적화된 스티커를 제공합니다. 언어와 국가의 기본값은 각각 en과 US 입니다.
- 스티커가 검색되어 전송됐다면 검색 태그 (q)를 함께 올려주세요. 검색 태그를 통해 향후 검색 결과를 최적화 할 수 있습니다.
- userId 파라미터에 다양한 사용자에 대해 같은 userId 값을 사용하지마세요. 해당 값은 지속적으로 모니터링이 되며 중복값이 사용 될 경우 API key가 비활성화 될 수 있습니다. userId 값은 아무 string 형태의 값이면 됩니다.
- API를 설정한 후 대시보드 Analytics 페이지에서 스티커 사용 데이터를 확인해보세요. 많은 클라이언트들이 해당 데이터를 스티커 판매 수익률 증대 및 서비스 개선에 활용하고 있습니다.
Parameters
| Required | Type | Description |
|---|---|---|
| apikey | string | 발급받은 API 키 값: 스티팝 대시보드에서 새로운 API 키를 발급받을 수 있습니다. |
| Required | Type | Description |
|---|---|---|
| stickerId | int | 전송되는 스티커의 [stickerId]이며 [packId]와 다릅니다. 예시: 140502, 134960, 121856 |
| Required | Type | Description |
|---|---|---|
| userId | string | 앱 사용자에게 부여되는 고유 값. userId는 아무 string 값이면 됩니다. 중요: 여러 사용자에게 동일한 userId를 사용하면 안됩니다. |
| Strongly Recommended | Type | Description |
| q | string | 검색어 혹은 문장. 40+개 언어 지원. 예시: 안녕, 야구, Excited, Merry Christmas |
| lang | string | 언어 최적화를 위해 언어 정보를 입력해주세요. ISO 639-1의 2-letter 언어 코드를 사용하세요. 기본 값: en |
| countryCode | string | 국가 최적화를 위해 국가 정보를 입력해주세요. ISO 3166-1의 2-letter 국가 코드를 사용하세요. 기본 값: US |
Example Request
샘플 요청: 스티커 전송 기록
cURL
1
curl --location --request POST "https://messenger.stipop.io/v1/analytics/send/790?userId=9937" --header "apikey:xxxxxxxxx"Success Response
성공 응답: 200
1
2
3
4
5
6
7
8
{
"header": {
"code": "0000",
"status": "success",
"message": "success"
},
"body": []
}
| Error | Code | Description |
|---|---|---|
| non exist apikey | 9000 | 사용된 API 키가 존재하지 않습니다. |
| server error | 1000 | 서버에서 정보를 받을 수 없습니다. |
이 페이지가 도움이 되셨나요?
도움이 필요하신가요? 문의주세요.