이벤트 규칙 설정
이벤트 규칙 은 정의한 커스텀 조건에 따라 설치 후 이벤트 를 검증하도록 Conversion Rules를 확장합니다.
이벤트가 이러한 조건을 충족하지 못하면 Adjust가 해당 이벤트를 거부하며 콜백, CSV 내보내기, 리포트를 통해 거부 결과를 보고합니다.
계정에서 Conversion Rules(및 이벤트 규칙)를 활성화하려면 sales@adjust.com으로 연락주시기 바랍니다.
시작에 앞서
이벤트 규칙 설정 전에 알아야 할 사항은 다음과 같습니다.
요구 사항
- Adjust에서의 관리자, 편집자 또는 사용자 지정 편집자 권한.
- Adjust에서 단일 또는 멀티 플랫폼 앱.
이벤트 규칙 설정
이벤트 규칙을 설정하려면 다음의 단계를 수행하시기 바랍니다.
앱 뷰에서 이벤트 & 구독 을 열고 검증할 이벤트를 선택합니다.
이벤트 편집 을 선택합니다.
구성하고자 하는 검사 항목으로 이동합니다.
다음 상태 옵션 중 하나를 선택합니다.
- 라이브 - 규칙이 저장되면 Adjust 시스템에서 해당 검사가 활성화됩니다. 검사를 통과하지 못한 이벤트는 거부 됩니다.
- 테스트 - 규칙이 저장되면 Adjust 시스템에서 해당 검사가 활성화됩니다. 검사를 통과하지 못한 이벤트는 거부되지 않지만 플래그 표시되고 보고됩니다.
- 일시 중지 - 규칙이 어느 이벤트에도 적용되지 않습니다. 이 상태를 사용하면 활성화하지 않고 변경 사항을 저장할 수 있습니다.
검사 를 1개 이상 구성합니다(검사 참조).
변경 내용 저장 을 선택합니다.
초기 이벤트 생성 과정에서도 이벤트 규칙 검사를 구성할 수 있습니다.
이벤트 규칙 검사 삭제
검사를 삭제하려면 상태를 OFF 로 설정합니다.
확인
이벤트 규칙에 여러 개의 검사를 적용할 수 있습니다.
라이브 상태에서 검사가 실패하면 이벤트가 거부 됩니다.
타겟 필터링
타겟 필터를 사용하여 각 체크가 적용되는 트래픽의 범위를 좁힐 수 있습니다. 필터는 체크 별로 구성되며, 동일한 규칙의 다른 체크에는 영향을 주지 않습니다.
채널
특정 트래픽 채널에 대해서만 체크를 제한합니다. 기본 설정에 따라, 체크는 모든 채널에 적용됩니다.
설치 앱 버전
특정 버전의 앱을 설치한 사용자만 확인하도록 제한합니다. 이를 통해 규칙 로직이 유효하고 유의미한 사용자(예: 규칙이 참조하는 모든 이벤트와 플로우가 이미 앱의 일부였던 버전을 설치한 사용자)에게만 적용되도록 할 수 있습니다.
설치 앱 버전은 현재 앱 버전이 아닌 설치 시점의 버전을 의미합니다. 설치 후 업그레이드하는 사용자는 규칙 평가를 위해 원래의 설치 버전을 유지합니다.
소스 확인
이를 사용하여 허용되는 이벤트 소스를 제어하고 앱에서 더 이상 활성화되지 않은 이벤트를 처리할 수 있습니다.
허용되는 이벤트 소스
허용되는 이벤트 소스를 제한합니다.
- SDK - SDK에서 발생한 이벤트만 허용합니다.
- S2S - 서버 간 이벤트만 허용합니다.
허용되지 않은 소스에서 발생한 이벤트는 거부됩니다.
지원 중단된 이벤트
이벤트가 앱에서 삭제되어 더 이상 트리거되지 않는 경우 거부합니다. 이를 사용하여 더 이상 앱의 이벤트 플로우에 포함되지 않는 이벤트에 대한 나머지 트리거를 무효화할 수 있습니다.
플로우 확인
이를 사용하여 이벤트의 예상 순서, 타이밍, 필수 파라미터를 제어할 수 있습니다.
조건을 여러 개 선택할 수 있으며, 이 경우 이벤트가 통과하려면 선택한 모든 조건이 충족되어야 합니다. 그렇지 않은 경우 이벤트가 거부됩니다.
설치 후 시간
이벤트가 설치 후 특정 기간 이내 또는 그 이후에 발생해야 합니다.
예: "설치 후 5분 이상 경과"
선행 이벤트 필요
이 이벤트 이전에 특정 이벤트( 예: 레벨 1) 가 발생해야 합니다. 추가 제약 조건으로, 필요한 선행 이벤트와 현재 이벤트 사이의 최소 또는 최대 윈도우(시간 간격)를 지정할 수 있습니다.
선행 이벤트 필요 조건은 SDK 에서 전송된 이벤트에만 적용됩니다.
서버 간(S2S) 으로 전송되는 이벤트에서는 올바르게 평가되지 않으므로 이 검사를 구성하지 마세요.
특정 이벤트가 상호 배제되는 경우 이벤트는 발생할 수 없습니다.
해당 사용자에 대해 명시된 다른 이벤트가 이미 발생한 경우 해당 이벤트를 거부합니다. 두 이벤트 간에 상호 배제를 적용하기 위해 이를 사용하여, 하나의 이벤트가 발생하면 다른 하나는 차단됩니다.
예: " 환불 이 이미 발생한 경우 구매 불가".
기존의 상호 배제 규칙에 이미 연결된 이벤트는 드롭다운 메뉴에서 이미 연결됨 으로 표시됩니다.
이 조건을 정의하면 지정된 이벤트에 동일한 규칙 상태를 가진 대칭 규칙이 자동으로 생성되며, 이는 UI에서 확인할 수 있습니다.
타겟 필터를 사용하는 경우, 두 이벤트 모두에 대해 타겟 필터 를 정렬하여 일관되지 않은 거부 행동을 방지하시기 바랍니다.
이벤트의 마지막 트리거 최소 발생 시점 — 시간 기반 이벤트 억제
지정된 시간보다 짧은 간격으로 트리거된 이벤트는 거부합니다. 이를 사용하여 특정 사용자에 대해 동일한 이벤트가 허용되는 빈도를 제한할 수 있습니다.
예: " 구매 의 마지막 트리거가 최소 5분 전 발생".
필수 파라미터
이벤트 페이로드에 특정 SDK 파라미터(예: user_id, transaction_id)가 포함되어야 합니다. 여러 개의 파라미터를 제공할 수 있으며, 다수의 파라미터가 정의된 경우에는 확인 과정에서 모든 파라미터가 존재해야 조건을 충족한 것으로 처리됩니다.
개별 이벤트 인스턴스가 아닌, 설치 및 설치 후 활동에서 파라미터를 확인하고 싶은 경우에는 파라미터 규칙 유형을 사용하시기 바랍니다.
매출 확인
이 검사를 사용하여 수익화 이벤트의 완전성 및 결제 검증을 확인할 수 있습니다.
결제 검증 결과에 따라 검사 결과가 통과 또는 실패로 결정됩니다.
토글을 활성화하면 거래 데이터가 없는 이벤트도 거부됩니다.
매출 검사 구성
결제 검증 구성은 앱 보기 → Protection → 결제 검증 에서 관리됩니다.
매출 검사 플로우에서 결제 검증 결과를 사용하려면 우선 레거시 모드 에서 이벤트 모드 로 전환해야 합니다.
- 이벤트 규칙에 대한 결제 검증이 구성되지 않음
- 결제 검증 구성 예시
데이터 공유
거부된 이벤트는 다음과 같이 보고됩니다.
거부된 이벤트 트리거가 구성된 경우의 콜백 및 CSV 내보내기 를 통해 보고됩니다. {rejection_reason} 플레이스홀더는 체크별로 세분화된 값과 함께 보고됩니다.
post_install_activity_event_rule_source_checkpost_install_activity_event_rule_flow_checkpost_install_activity_event_rule_pv_status_check
거부된 이벤트 및 거부된 이벤트 비율 지표는 리포트에서 거부 사유 별로 분류됩니다.
rejected_events_post_install_activity_event_rule_source_check(이벤트 규칙 소스 확인)rejected_events_post_install_activity_event_rule_flow_check(이벤트 규칙 플로우 확인)rejected_events_post_install_activity_event_rule_pv_status_check(이벤트 규칙 PV 상태 확인)rejected_events_post_install_activity_rule(설치 이후 활동 필터) — 이전 버전과의 호환성을 위해 유지됨
테스트 모드 결과
테스트 상태의 규칙은 규칙이 실패하더라도 이벤트를 거부하지 않습니다. 거부된 결과는 파트너에게 전달되지 않으며 고객에게만 공유됩니다.
테스트와 라이브 결과를 구분하려면 콜백 또는 CSV 내보내기 설정에 {conversion_rule_status} 플레이스홀더를 추가하시기 바랍니다. 플레이스홀더는 규칙이 테스트 상태인 경우 test를 반환하고, 규칙이 라이브 상태인 경우 live를 반환합니다.