adjust-icon

서버 간(S2S) 이벤트

서버 간(S2S) 이벤트 API를 사용하면 HTTP 요청을 통해 Adjust에 이벤트 데이터를 전송할 수 있습니다. Adjust SDK를 사용하여 설치, 세션, 리어트리뷰션을 기록하고, S2S API를 사용하여 커스텀 이벤트만 전송하시기 바랍니다.

S2S 이벤트를 iOS 14+ 앱으로 설정하면 Adjust는 전환값을 S2S 응답으로 서버에 전송합니다. 이후 서버는 인앱에서 전환값을 업데이트해야 합니다. 본 설정에 관한 자세한 내용은 iOS 14+ S2S 이벤트 지원 페이지를 확인하시기 바랍니다.

이 페이지에서는 서버 간 이벤트 기록을 설정하고 관련 문제를 해결하는 방법을 확인하실 수 있습니다.

엔드포인트
https://s2s.adjust.com/event

S2S 이벤트 전송

/event 엔드포인트는 다음의 S2S 이벤트 요청을 허용합니다.

  • URL 파라미터가 포함된 GET
  • URL 파라미터가 포함된 POST.
  • Body 파라미터가 포함된 POST. Content-Type 은 반드시 application/x-www-form-urlencoded 으로 설정되어야 합니다.

S2S 보안 설정

S2S 보안을 설정하여 S2S 이벤트의 보안을 보장하고, 스푸핑 요청을 방지할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다.

설정을 하려면 S2S 보안 페이지에 명시된 단계를 수행하시기 바랍니다.

필수 파라미터

/event 엔드포인트는 모든 요청에서 다음 파라미터가 필요합니다.

  1. 광고 ID(예: iOS: idfa , Android: gps_adid ).
  2. 이벤트 토큰.
  3. 앱 토큰.
  4. 해당 요청이 서버 간 요청임을 알려주는 하드코드된 s2s=1 파라미터.

정확한 이벤트 어트리뷰션을 위해 이벤트에 다음 파라미터를 포함시키십시오.

이벤트 타임스탬프

이벤트 타임스탬프는 created_at_unix 파라미터 또는 created_at 파라미터를 사용하여 지정할 수 있습니다.

  • created_at_unix: 이벤트가 전송된 UNIX 타임스탬프입니다. 예: 1484085154.
  • created_at: ISO 8601 형식의 URL 인코딩된 타임스탬프. 예: 2023-01-02T15%3A04%3A05.000%2B0000

다음 내용을 확인하시기 바랍니다.

  • 이벤트는 요청의 타임스탬프에 따라 각 디바이스 및 이벤트 토큰에 대해 순차적으로 제출해야 합니다. Adjust에서 나열된 디바이스 및 이벤트에 대해 이전에 수신한 이벤트보다 앞선 타임스탬프의 이벤트를 수신할 경우 해당 이벤트는 거부됩니다.
  • 모든 이벤트는 58일 이내에 제출되어야 합니다. 타임스탬프가 58일을 초과한 이벤트는 거부됩니다.

커스텀 데이터 공유하기

콜백 및 파트너 파라미터를 사용하여 사용자 지정 이벤트를 Adjust로 전송합니다. 콜백 파라미터는 로 데이터 내보내기에서 사용할 수 있으며, 파트너 파라미터는 네트워크 파트너와 공유됩니다.

다음 파라미터를 사용하여 요청에 파라미터를 추가합니다.

  • callback_params: 문자열 키-값 쌍을 포함한 URL 인코딩된 JSON 객체
  • partner_params: 문자열 키-값 쌍을 포함한 URL 인코딩된 JSON 객체
인코딩 되지 않은 예시
{
   "f0o": "bar",
   "bar": "baz"
}
인코딩된 예시
%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

로 데이터 내보내기에서 콜백 파라미터를 수신하려면 서버 간 콜의 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%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

네트워크 파트너에게 이벤트 정보를 전송하려면 서버 간 콜의 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%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

매출 이벤트 기록

이벤트 제출에 다음의 매출 파라미터를 추가하여 S2S 매출 이벤트를 기록할 수 있습니다.

예시