서버 간(S2S) 이벤트
서버 간(S2S) 이벤트 API를 사용하면 HTTP 요청을 통해 Adjust에 이벤트 데이터를 전송할 수 있습니다. Adjust SDK를 사용하여 설치, 세션, 리어트리뷰션을 기록하고, S2S API를 사용하여 커스텀 이벤트만 전송하시기 바랍니다.
S2S 이벤트를 iOS 14+ 앱으로 설정하면 Adjust는 전환값을 S2S 응답으로 서버에 전송합니다. 이후 서버는 인앱에서 전환값을 업데이트해야 합니다. 본 설정에 관한 자세한 내용은 iOS 14+ S2S 이벤트 지원 페이지를 확인하시기 바랍니다.
어트리뷰션의 경우, Adjust는 SDK로부터 전송된 클릭과 S2S 클릭을 구분하지 않습니다. 두 클릭 모두 어트리뷰션 워터폴에서는 동일한 것으로 간주됩니다.
이 페이지에서는 서버 간 이벤트 기록을 설정하고 관련 문제를 해결하는 방법을 확인하실 수 있습니다.
엔드포인트
S2S 이벤트 API는 다음의 엔드포인트를 사용합니다.
https://s2s.adjust.com/eventS2S 이벤트 전송
/event 엔드포인트는 다음의 서버 간 이벤트 요청을 허용합니다.
- URL 파라미터가 포함된 GET
- URL 파라미터가 포함된 POST
- Body 파라미터가 포함된 POST.
Content-Type은 반드시application/x-www-form-urlencoded으로 설정되어야 합니다.
S2S 보안 설정
S2S 보안을 설정하여 S2S 이벤트의 보안을 보장하고, 스푸핑 요청을 방지할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다.
설정을 하려면 S2S 보안 페이지에 명시된 단계를 수행하시기 바랍니다.
필수 파라미터
S2S 이벤트 파라미터는 대소문자를 구분해야 합니다.
/event 엔드포인트의 경우 각 요청에 다음 파라미터가 필요합니다.
- 광고 ID(예: iOS:
idfa, Android:gps_adid). - 이벤트 토큰.
- 앱 토큰.
- 엔드포인트에 요청이 서버 간(S2S)임을 알리기 위한 하드코드된
s2s=1파라미터
| 파라미터 | 설명 | 예시 |
|---|---|---|
광고 ID(예: iOS: idfa , Android: gps_adid). | 기기 ID 전체 목록 표시. | idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1Egps_adid=660e1d86-6796-463a-be86-897993136018 |
event_token | 대시보드의 Adjust 이벤트 토큰 | event_token=f0ob4r |
app_token | 대시보드의 Adjust 앱 토큰 | app_token=4w565xzmb54d |
s2s | S2S 파라미터 값을 1로 설정하세요. | s2s=1 |
이벤트 전송을 위한 기타 권장 파라미터
정확한 이벤트 어트리뷰션을 위해서는 이벤트에 다음 파라미터를 포함하시기 바랍니다.
iOS 기기의 경우, adid 광고 ID를 사용해야 합니다. 이를 통해 IDFA를 사용할 수 없는 경우에도 기기 데이터를 매칭할 수 있습니다.
| 파라미터 | 설명 | 예시 |
|---|---|---|
adid | 기기와 연관된 Adjust ID. IDFA 정보가 없는 iOS에서 LAT 사용자를 식별할 때 유용합니다. | adid=18546f6171f67e29d1cb983322ad1329 |
ip_address | 기기의 IP 주소. 이벤트를 제3자(예: Google)에 연결하고 위치 관련 정보(예: city ,postal_code)를 콜백에 포함하는 데 사용됩니다.ip_address 파라미터는 IPv4 주소만 허용합니다. IPv6은 현재 지원되지 않습니다. | ip_address=192.0.0.1 |
created_at_unix(권장)또는 created_at | 이벤트가 발생한 날짜 및 시간. | created_at_unix=1484085154또는 created_at=2017-01-02T15:04:05.000+0000 |
user_agent | 기기의 사용자 에이전트. 반드시 URL이 인코딩되어야 합니다. | user_agent=Mozilla%2F5.0%20%28iPhone%3B%20 CPU%20iPhone%20OS%2016_6%20like%20mac%20OS%20X%29%20AppleWebKit%2F605.1.15%20%28Klike%2C%20%28Klike%2C%20Gecko%29Gecko 20Version%2F16.5%20Mobile%2F15E148%20Safari%2F604.1 |
이벤트 타임스탬프
이벤트 타임스탬프는 created_at_unix 파라미터나 created_at 파라미터를 사용하여 지정할 수 있습니다.
created_at_unix: 이벤트가 전송된 시점의 UNIX 타임스탬프 예:1484085154.created_at: ISO 8601 형식 의 URL 인코딩된 타임스탬프. 예:2023-01-02T15%3A04%3A05.000%2B0000
요청에서 타임스탬프를 전송하지 않은 경우, Adjust는 이벤트가 수신된 시점을 이벤트 날짜로 사용합니다.
다음을 반드시 확인하시기 바랍니다.
- 이벤트는 반드시 요청에 있는 타임스탬프에 따라 각 기기와 이벤트 토큰에 대해 시간 순으로 제출해야 합니다. Adjust는 리스트된 기기 및 이벤트에 대해 수신한 것보다 이전의 타임스탬프를 가진 이벤트를 수신할 경우, 해당 이벤트를 거부합니다.
- 모든 이벤트는 58일 이내에 제출되어야 합니다. 58일이 지난 타임스탬프가 있는 이벤트는 모두 거부됩니다.
커스텀 데이터 공유하기
콜백 및 파트너 파라미터를 사용하여 커스텀 이벤트 데이터를 Adjust로 전송하시기 바랍니다. 콜백 파라미터는 로데이터 내보내기에서 이용 가능하며, 파트너 파라미터는 네트워크 파트너와 공유됩니다.
다음 파라미터를 사용하여 요청에 파라미터를 추가하시기 바랍니다.
callback_params: 문자열 키-값 쌍을 포함한 URL로 인코딩된 JSON 객체partner_params: 문자열 키-값 쌍을 포함한 URL로 인코딩된 JSON 객체
맞춤 데이터 객체에서 객체를 중첩하지 마시기 바랍니다.
로데이터 내보내기에서 콜백 파라미터를 수신하려면 S2S 콜의 callback_params 파라미터에 데이터를 추가하시기 바랍니다.
curl --location https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=8A3CB124-5A79-4334-8802-F75FEC099C58&callback_params=%7B%222f0%222f0%20%2C%2%2%2C%2 %22bar%22%3A%22baz%22%7D네트워크 파트너에게 이벤트 정보를 전송하려면, S2S 콜의 partner_params 파라미터에 데이터를 추가합니다.
curl --location https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=8A3CB124-5A79-4334-8802-F75FEC099C58&partner_params=%7B%222f0%222f%2%2%2c%2%2c%2a%2c%2a%2c% %22bar%22%3A%22baz%22%7D매출 이벤트 기록
서버 간 매출 이벤트를 기록하려면 다음의 매출 파라미터를 이벤트 제출에 추가하시기 바랍니다.
| 파라미터 | 설명 |
|---|---|
revenue |
통화 단위를 포함한 매출 이벤트 값 |
currency | 이벤트와 관련된 통화 코드 . |
environment | 데이터를 게시할 환경 ( environment=sandbox또는environment=production).기본값은 production 입니다. |