이벤트 엔드포인트

/events 엔드포인트를 사용하여 단일 요청으로 1개 이상의 앱에 대한 이벤트를 생성하거나 업데이트할 수 있습니다. 이는 여러 앱에서 이벤트 정의를 일관되게 유지하는 데 유용합니다.

이벤트 생성 또는 업데이트

1개 이상의 앱에 대해 새 이벤트를 생성하거나 기존 이벤트를 업데이트합니다. API는 이름에 따라 이벤트를 매칭하며, 동일한 이름의 이벤트가 이미 존재하는 경우 업데이트됩니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/app-automation/events

호출하여 트래킹할 수 있습니다: POST

요청 본문: 이벤트 요청 페이로드

응답: 이벤트 결과

파라미터

파라미터	데이터 유형	필수	설명
`app_tokens`	`Array[String]`	O	이벤트를 생성/업데이트할 앱 토큰 목록.
`events`	`Array[Object]`	O	이벤트 정의 목록. 이벤트 객체를 참조하세요.

이벤트 객체

파라미터	데이터 유형	필수	설명
`name`	`String`	O	이벤트 이름. 고유 식별자로 사용됩니다.
`unique`	`Boolean`	아니요	이벤트를 사용자당 고유 이벤트로 집계할지 여부. 기본값은 `false`입니다.

예시

여러 앱에 대한 이벤트 생성

curl --location 'https://automate.adjust.com/app-automation/events' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
    "app_tokens": ["abc123xyz", "def456uvw", "ghi789rst"],
    "events": [
        { "name": "purchase", "unique": false },
        { "name": "registration", "unique": true },
        { "name": "level_complete", "unique": false },
        { "name": "add_to_cart", "unique": false }
    ]
}'

{
   "successes": [
      {
         "app_token": "abc123xyz",
         "event": {
            "id": 12345,
            "name": "purchase",
            "token": "abc1de",
            "unique": false,
            "autogenerated": false,
            "archived": false
         }
      },
      {
         "app_token": "abc123xyz",
         "event": {
            "id": 12346,
            "name": "registration",
            "token": "fgh2ij",
            "unique": true,
            "autogenerated": false,
            "archived": false
         }
      },
      {
         "app_token": "def456uvw",
         "event": {
            "id": 12347,
            "name": "purchase",
            "token": "klm3no",
            "unique": false,
            "autogenerated": false,
            "archived": false
         }
      }
   ],
   "failures": [
      {
         "app_token": "ghi789rst",
         "name": "purchase",
         "details": "App not found"
      }
   ]
}

단일 이벤트 생성

curl --location 'https://automate.adjust.com/app-automation/events' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
    "app_tokens": ["abc123xyz"],
    "events": [
        { "name": "tutorial_complete", "unique": true }
    ]
}'

{
   "successes": [
      {
         "app_token": "abc123xyz",
         "event": {
            "id": 12348,
            "name": "tutorial_complete",
            "token": "pqr4st",
            "unique": true,
            "autogenerated": false,
            "archived": false
         }
      }
   ],
   "failures": []
}

이벤트 토큰 이해하기

이벤트가 생성되면 Adjust가 특별한 이벤트 토큰을 생성합니다. 이 토큰은 Adjust SDK에서 이벤트를 전송할 때 사용됩니다.

이벤트 이름 : 사용자가 정의하며 읽을 수 있는 식별자(예: purchase)
이벤트 토큰 : SDK 콜에 사용된 시스템 생성 식별자(예: abc1de)

특별한 이벤트

사용자당 한 번만 집계되어야 하는 이벤트에 대해 unique: true로 설정합니다. 이는 다음과 같은 이벤트에 유용합니다.

첫 구매
Registration
첫 번째 앱 실행
구독 시작 (Subscription start)

사용자당 여러 번 발생할 수 있는 이벤트(예: 레벨 완료 또는 인앱 구매)의 경우 unique: false로 설정합니다.

오류 처리

API는 각 앱에 대한 이벤트를 독립적으로 처리합니다. 한 앱에서 이벤트가 실패하더라도 다른 앱에 영향을 주지 않습니다. 응답에서 successes 및 failures 배열을 모두 확인합니다.

일반적인 실패 이유:

원인	설명
앱을 찾을 수 없음	앱 토큰이 존재하지 않거나 액세스 권한이 없습니다.
유효하지 않은 이벤트 이름	이벤트 이름에 유효하지 않은 문자가 있거나 너무 깁니다.
중복 이벤트	동일한 이름의 이벤트가 이미 존재합니다(이는 오류가 아니며 해당 이벤트는 업데이트됩니다).

데이터 모델

이벤트 요청 페이로드

파라미터	데이터 유형	설명
`app_tokens`*	`Array[String]`	이벤트를 생성/업데이트할 Adjust 앱 토큰 목록.
`events`*	`Array[Object]`	이벤트 정의 목록.

이벤트 정의

파라미터	데이터 유형	설명
`name`*	`String`	이벤트 이름.
`unique`	`Boolean`	이벤트가 사용자별로 고유한지 여부. 기본값은 `false`입니다.

이벤트 결과

파라미터	데이터 유형	설명
`successes`	`Array[Object]`	성공적으로 생성/업데이트된 이벤트 목록.
`failures`	`Array[Object]`	실패한 이벤트 작업 목록.

이벤트 성공

파라미터	데이터 유형	설명
`app_token`*	`String`	이벤트가 속한 앱 토큰.
`event`*	`Object`	생성/업데이트된 이벤트 상세 정보.

이벤트 상세 정보

파라미터	데이터 유형	설명
`id`*	`Integer`	내부 이벤트 ID.
`name`*	`String`	이벤트 이름.
`token`*	`String`	SDK 연동을 위한 이벤트 토큰.
`unique`*	`Boolean`	이벤트가 사용자별로 고유한지 여부.
`autogenerated`	`Boolean`	이벤트가 자동 생성되었는지 여부. 기본값은 `false`입니다.
`archived`	`Boolean`	이벤트의 아카이브 여부. 기본값은 `false`입니다.
`callback_url`	`String`	이 이벤트에 대한 콜백 URL.

이벤트 실패

파라미터	데이터 유형	설명
`app_token`*	`String`	작업이 실패한 앱 토큰.
`name`*	`String`	실패한 이벤트 이름.
`details`*	`String`	오류에 대한 설명.