이벤트 엔드포인트

이벤트 엔드포인트를 사용하여 리포트 서비스 쿼리에서 사용할 이벤트 slug를 가져옵니다. 이 엔드포인트를 사용하면 읽을 수 있는 이름으로 이벤트를 검색하고 각 이벤트에 대한 정보를 반환할 수 있습니다.

시작에 앞서

엔드포인트를 사용하려면 Adjust API 토큰이 필요합니다. 인증 가이드 내 설명을 참조하여 토큰을 생성하시기 바랍니다.

엔드포인트

https://dash.adjust.com/control-center/reports-service/events

GET request

이벤트 객체 목록 반환

파라미터

파라미터데이터 유형필수설명
events__containsStringNo이벤트 키의 정확한 일치 또는 해당 값의 부분적 일치로 이벤트를 필터링합니다.

응답

본 엔드포인트는 다음의 응답을 반환합니다.

응답설명참고 사항
200Success리포트 정보 반환
204No content응답 객체가 공란일 경우 반환됨
400Bad request요청 형식이 잘못되었거나 지원되지 않는 파라미터가 포함된 경우 반환됨
401Unauthorized자격 증명이 올바르지 않거나 없는 경우 반환됨
403Forbidden열람 권한이 없는 정보에 액세스를 시도할 경우 반환됨
429Too many requests동시 요청이 50개를 초과하면 반환됨
503Service unavailable서버에 연결할 수 없는 경우 반환됨
504Gateway timeout쿼리의 응답 반환 시간이 너무 오래 걸리는 경우 반환됨

성공적인 응답

[
  {
    "id": "string",
    "name": "string",
    "short_name": "",
    "section": "",
    "formatting": "money",
    "increase_is_negative": false,
    "description": "",
    "app_token": [
      "string"
    ],
    "tokens": [
      "string"
    ]
  }
]

파라미터

파라미터데이터 유형설명
idString이벤트 slug.
nameString이벤트 이름
short_nameString이벤트의 축약된 이름.
sectionString이벤트 섹션 사용 가능한 값에 대한 정보는 아래 표를 참조하시기 바랍니다.
formattingString이벤트의 데이터가 저장된 포멧.
increase_is_negative 지원 중단 Boolean가장 최근 변경 사항이 값 증가인지 여부.
app_tokenArray이벤트가 연관된 앱 토큰.
tokensArray이벤트의 토큰.

섹션

예시

cURL
curl --location --request GET 'https://dash.adjust.com/control-center/reports-service/events?event__contains=purchase' \
--header 'Authorization: Bearer {API_TOKEN}'
[
  {
    "id": "purchase",
    "name": "Purchase event",
    "short_name": "PUR",
    "section": "Revenue",
    "formatting": "money",
    "increase_is_negative": false,
    "description": "",
    "app_token": [
      "4zb92bmajmrd"
    ],
    "tokens": [
      "abc123"
    ]
  }
]