Stipop Docs | Documentation for SDK and API

Register Sticker Usage

제품에서 사용자 행동을 이해하는 것이 매우 중요하다는 것을 알기 때문에 스티커가 제품에서 어떻게 사용되고 있는지 확인할 수 있는 분석 도구를 제공하고 있습니다. Registering Sticker Usage를 적용하면 대시보드를 통해 사용자가 어떻게 스티커를 사용하고 있는지 상세하게 분석할 수 있습니다.

스티커 사용 데이터를 통해 사용자의 취향과감정 데이터를 확인할 수 있습니다. 또한 유료 스티커 판매시 개인화된 스티커 추천 시스템을 통해 유료 구매율을 최적화 할 수도 있습니다.

스티커가 전송될 때 해당 API를 적용하면 필요한 모든 정보를 확인할 수 있습니다.

Request URL

POST
https://messenger.stipop.io/v1/analytics/send/:stickerId

Best Practices

  1. 권장: 최적의 서비스를 위해 언어(lang)와 국가(countryCode) 파라미터를 사용해 사용자 위치 정보를 제공하세요. 스티팝은 사용자의 선호 언어, 문화, 그리고 로컬 트렌드를 적용해 자동으로 최적화된 스티커를 제공합니다. 언어와 국가의 기본값은 각각 enUS 입니다.
  2. 스티커가 검색되어 전송됐다면 검색 태그 (q)를 함께 올려주세요. 검색 태그를 통해 향후 검색 결과를 최적화 할 수 있습니다.
  3. userId 파라미터에 다양한 사용자에 대해 같은 userId 값을 사용하지마세요. 해당 값은 지속적으로 모니터링이 되며 중복값이 사용 될 경우 API key가 비활성화 될 수 있습니다. userId 값은 아무 string 형태의 값이면 됩니다.
  4. API를 설정한 후 대시보드 Analytics 페이지에서 스티커 사용 데이터를 확인해보세요. 많은 클라이언트들이 해당 데이터를 스티커 판매 수익률 증대 및 서비스 개선에 활용하고 있습니다.

Parameters

Request Headers
RequiredTypeDescription
apikeystring발급받은 API 키 값:
스티팝 대시보드에서 새로운 API 키를 발급받을 수 있습니다.
Request Path Parameters
RequiredTypeDescription
stickerIdint전송되는 스티커의 [stickerId]이며 [packId]와 다릅니다.
예시: 140502, 134960, 121856
Request Query Parameters
RequiredTypeDescription
userIdstring앱 사용자에게 부여되는 고유 값.
userId는 아무 string 값이면 됩니다.
중요: 여러 사용자에게 동일한 userId를 사용하면 안됩니다.
Strongly RecommendedTypeDescription
qstring검색어 혹은 문장. 40+개 언어 지원.
예시: 안녕, 야구, Excited, Merry Christmas
langstring언어 최적화를 위해 언어 정보를 입력해주세요.
ISO 639-1의 2-letter 언어 코드를 사용하세요.
기본 값: en
countryCodestring국가 최적화를 위해 국가 정보를 입력해주세요.
ISO 3166-1의 2-letter 국가 코드를 사용하세요.
기본 값: US

Example Request

샘플 요청: 스티커 전송 기록
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": []
}
ErrorCodeDescription
non exist apikey9000사용된 API 키가 존재하지 않습니다.
server error1000서버에서 정보를 받을 수 없습니다.
도움이 필요하신가요? 문의주세요.