전환 규칙 설정
Conversion Rules 는 Protect 라인의 고급 기능으로, 원하는 커스텀 규칙으로 설치와 사용자 인게이지먼트를 검증할 수 있도록 해줍니다.
계정에서 Conversion Rules를 활성화하려면 sales@adjust.com으로 연락주시기 바랍니다.
시작에 앞서
딥링크 생성 전에 알아야 할 사항은 다음과 같습니다.
요구 사항
- Adjust에서의 관리자, 편집자 또는 사용자 지정 편집자 권한.
- Adjust에서 단일 또는 멀티 플랫폼 앱.
전환 규칙 설정
전환 규칙을 설정하려면 다음의 단계를 수행하시기 바랍니다.
Protection 에서 Conversion Rules 를 선택합니다.
새 전환 규칙 을 선택합니다.
규칙 이름을 입력합니다.
다음 중 하나의 상태를 선택합니다.
- 라이브 - 조건이 충족되는 즉시 어트리뷰션에 규칙이 적용됩니다.
- 테스트 - 전환 규칙을 테스트하려면 이 상태를 사용하시기 바랍니다. 전환 규칙이 테스트 상태인 경우, Adjust는 어트리뷰션 소스를 변경하거나 콜백을 전송하지 않습니다.
- 일시 중지 - 규칙이 어트리뷰션에 적용되지 않습니다.
앱을 선택합니다.
규칙 유형을 선택하고 이에 따라 규칙을 구성합니다.
새 규칙 생성 을 선택합니다.
규칙이 라이브 상태인 경우 Adjust는 규칙 구성과 어트리뷰션 데이터를 비교하며, 이에 따라 어트리뷰션 결과가 변경될 수 있습니다. 변경 사항은 로데이터 내보내기 또는 Datascape에서 확인하실 수 있습니다. 테스트 상태의 규칙에 대해서는 어트리뷰션 소스가 변경되거나, 콜백이 전송되지 않습니다.
어트리뷰션 행동
특정 규칙 유형의 경우, 어트리뷰션 결과의 처리 방법을 정의할 수 있습니다. 사용 가능한 옵션은 다음과 같습니다.
검증되지 않은 기기
- 포스트백과 집계된 데이터가 Adjust에 보관됩니다.
- 검증되지 않은 기기는 리어트리뷰션될 수 있습니다.
신뢰할 수 없는 기기
- 가장 높은 심각도를 나타냅니다.
- 포스트백이나 집계된 데이터가 Adjust에 보관되지 않습니다.
- 신뢰할 수 없는 기기는 리어트리뷰션될 수 없습니다.
라이브 또는 테스트 모드에서 어트리뷰션 행동을 지정하려면, 우선 계정에 Conversion Rules Core 기능이 활성화되어 있어야 합니다. 지원이 필요하시면 sales@adjust.com으로 연락주시기 바랍니다.
스토어
'스토어' 유형 규칙은 Google 플레이 스토어 또는 Apple 앱 스토어로부터의 앱 설치를 허용합니다.
스토어 규칙을 설정하려면 다음의 단계를 수행하시기 바랍니다.
허용된 스토어를 선택합니다. 단일 플랫폼 앱의 경우, 상응하는 플랫폼 스토어만 표시됩니다.
스토어가 허용된 스토어와 일치하지 않는 경우의 어트리뷰션 결과를 선택합니다.
특정 채널에 대해 규칙이 실행되는 것을 원하지 않는 경우 채널 제외 옵션을 사용하시기 바랍니다.
새 규칙 생성 을 선택합니다.
이 규칙을 사용하면 허용된 스토어 외의 설치는 ' 검증되지 않은 기기 ' 또는 ' 신뢰할 수 없는 기기' 로 어트리뷰션됩니다.
지역
'지역' 규칙은 특정 지역의 기기 및 설치를 허용합니다.
지역 규칙을 설정하려면 다음의 단계를 수행하시기 바랍니다.
지역이 사전 지정한 지역과 일치하지 않는 경우, 어트리뷰션 결과를 다음 중 어느 것으로 변경해야 하는지 선택합니다.
규칙 조건 에서 국가 에 대한 조건을 설정하여 여러 지역을 선택합니다.
- 조건 유형 - 다음 값과 일치 또는 제외 로 설정합니다.
- 값 - 목록에서 값을 선택합니다.
특정 채널에 대해 규칙이 실행되는 것을 원하지 않는 경우 채널 제외 옵션을 사용하시기 바랍니다.
새 규칙 생성 을 선택합니다.
이 규칙을 사용하면 특정 국가 외에서 발생한 설치는 '검증되지 않은 기기' 또는 '신뢰할 수 없는 기기' 로 어트리뷰션됩니다.
예: '지역' 규칙
- 조건 유형: 포함
- 국가 값: 일본
목적: 일본 지역에서의 설치만 어트리뷰션 하고자 합니다.
규칙 행동: 일본 외에서의 설치는 '검증되지 않은 기기' 또는 '신뢰할 수 없는 기기'로 어트리뷰션됩니다.
버전
버전 규칙을 사용하면 다음과 같은 버전별 필드에 기반하여 조건을 정의할 수 있습니다.
- 앱 버전
- SDK 버전
- 서명 버전
- OS 버전
이 규칙을 사용하여 특정 버전을 실행하는 기기로 어트리뷰션을 제한할 수 있습니다. 조건이 충족되지 않은 경우 어트리뷰션은 설정에 따라 검증되지 않거나 신뢰할 수 없는 기기에 할당됩니다.
버전 규칙을 설정하려면 다음의 단계를 수행하시기 바랍니다.
버전 데이터 포인트가 지정한 조건과 일치하지 않는 경우 어트리뷰션 방식을 선택합니다.
규칙 조건:
(선택 사항) 사전 조건 이 글로벌 필터 역할을 하여 규칙의 적용을 제한합니다. 그룹 조건을 평가하려면 먼저 사전 조건을 충족해야 합니다.
예를 들어, 멀티 플랫폼 앱에서 이 규칙을 Android 기기에만 적용하려면 다음 사전 조건을 사용하시기 바랍니다.- 조건: OS명
- 조건 유형: 일치
- 값: Android
(필수) 조건 – 설치가 정상적으로 어트리뷰션되기 위해 충족해야 하는 하나 이상의 버전 기반 조건을 추가합니다.
그룹 내 조건은 AND 로직을 사용하여 결합됩니다. OR 로직을 적용하려면 별도의 그룹을 사용합니다.
특정 채널에 대해 규칙이 실행되는 것을 원하지 않는 경우 채널 제외 옵션을 사용하시기 바랍니다.
새 규칙 생성 을 선택합니다.
예:
마케터인 저는 멀티 플랫폼 앱에 대한 보안 팀의 요구 사항을 준수하는 규칙을 정의해야 합니다.
요구 사항은 다음의 경우 Android에서 설치를 차단 하는 것입니다.
- 앱 버전이 2.2.1 이전 버전이고 기기 OS 버전이 6.0.0 이전 버전
- 앱 버전이 2.9.1 이전 버전이고 기기 OS 버전이 7.1.2 이전 버전
조건이 일치하지 않는 경우의 어트리뷰션 행동: 신뢰할 수 없는 기기
사전 조건:
[OS명] [일치] [Android]
일치 조건:
그룹 1
[앱 버전] [2.2.1] [이상]
[OS 버전] [6.0.0] [이상]
그룹 2
[앱 버전] [2.9.1] [이상]
[OS 버전] [7.1.2] [이상]
- 사례 1: 설치 OS명이 iOS인 경우
- 결과: 규칙 건너뜀
규칙에 OS명 사전 조건이 포함되지 않았다면 일치하는 조건이 없기 때문에 설치 어트리뷰션이 거부되었을 것입니다.
사례 2: 설치 OS명이 Android, 앱 버전이 2.3, OS 버전이 6.1인 경우
- 결과: 조건이 일치함. 거부 없음.
사례 3: 설치 OS명이 Android, 앱 버전이 2.1, OS 버전이 6.1인 경우
- 결과: 조건이 일치하지 않음. 어트리뷰션 거부됨.
사전 조건 및 조건 상세 정보
이름 | 세부 사항 |
---|---|
앱 버전 | 문자열 조건 유형: - 일치(문자열) - 불일치(문자열) - 포함 - 미포함 ✅ 일치(문자열) 및 불일치(문자열)는 다중값 지원 시맨틱 버전 조건 유형¹: - 일치(의미적) - 불일치(의미적) - 초과 - 이상 - 미만 - 이하 - 범위 내 - 범위 외 ✅ 일치 및 불일치는 다중값 지원 비교 로직: Adjust가 규칙의 앱 버전을 다음과 비교: - app_version_short(iOS) - app_version(기타 모든 플랫폼) |
OS명 | 목록 조건 유형: - 일치 - 불일치 ✅ 다중값 지원 |
OS 버전 | 시맨틱 버전 조건 유형¹: - 일치(의미적) - 불일치(의미적) - 초과 - 이상 - 미만 - 이하 - 범위 내 - 범위 외 ✅ 일치 및 불일치는 다중값 지원 |
SDK 버전 | 시맨틱 버전 조건 유형¹: - 일치() - 불일치(의미적) - 초과 - 이상 - 미만 - 이하 - 범위 내 - 범위 외 ✅ 일치 및 불일치는 다중값 지원 사용 가이드: 비 네이티브 SDK(예: React Native, Unity)의 경우 비 네이티브 SDK 버전을 타겟팅합니다. 예시: client_sdk = react_native5.0.0@ios5.1.0 규칙: SDK 버전 = 5.0 → ✅ 수락 규칙: SDK 버전 = 5.0, 네이티브 SDK 버전 = 5.0.0 → ❌ 거부 |
SDK 플랫폼 | 목록 조건 유형: - 일치 - 불일치 ✅ 다중값 지원 사용 가이드: React Native 또는 Unity와 같은 비 네이티브 SDK에 사용됩니다. 예시: client_sdk = react_native5.0.0@ios5.1.0 규칙: SDK 플랫폼 = React Native → ✅ 수락 규칙: SDK 플랫폼 = React Native, 네이티브 SDK 플랫폼 = Android → ❌ 거부 |
네이티브 SDK 버전 | 시맨틱 버전 조건 유형¹: - 일치(의미적) - 불일치(의미적) - 초과 - 이상 - 미만 - 이하 - 범위 내 - 범위 외 ✅ 일치 및 불일치는 다중값 지원 사용 가이드: 앱이 Adjust의 네이티브 SDK와 연동되거나 비 네이티브 SDK(예: React Native, Unity)가 그 위에 레이어된 경우 이 필드를 사용합니다. 다음과 같이 사용할 수 있습니다. - 네이티브 SDK 버전만 사용하여 래퍼(예: 여러 래퍼에서 Android SDK 5.0.0 사용)와 관계없이 특정 네이티브 SDK 버전을 사용하는 모든 연동을 타겟팅합니다. - 네이티브 SDK 버전을 SDK 플랫폼 및 SDK 버전과 결합하여 특정 래퍼 + 네이티브 SDK 조합(예: React Native 5.0 + iOS SDK 5.1.0)을 사용한 설치를 정확하게 일치시킬 수 있습니다. |
네이티브 SDK 플랫폼 | 목록 조건 유형: - 일치 - 불일치 ✅ 다중값 지원 사용 가이드: SDK 플랫폼을 결합하여 정확한 SDK 쌍을 일치시킬 수 있습니다. 예시: client_sdk = react_native5.0.0@ios5.1.0 규칙: SDK 플랫폼 = React Native, 네이티브 SDK 플랫폼 = iOS → ✅ 수락 규칙: SDK 플랫폼 = React Native, 네이티브 SDK 플랫폼 = Android → ❌ 거부 |
SDK 서명 버전 | 시맨틱 버전 조건 유형¹: - 일치(의미적) - 불일치(의미적) - 초과 - 이상 - 미만 - 이하 - 범위 내 - 범위 외 ✅ 일치 및 불일치는 다중값 지원 |
¹ 시맨틱 버전 형식
버전은 다음의 표준 시맨틱 버전 형식을 따라야 합니다.
형식:MAJOR.MINOR.PATCH[-pre-release]
구성 요소:
- MAJOR, MINOR, PATCH는 숫자(예: 1.2.3)
- 선택적으로 출시 전 태그(예:
-alpha
,-beta
,-rc
또는-dev
)가 뒤에 올 수 있음 - 또한
+build
와 같은 빌드 메타데이터를 포함할 수 있으며 이는 비교 시 무시됨
유효한 버전의 예: - 5.3.1
- 1.0.0-beta
- 2.2.0-rc
- 3.4.5-dev+123
- v2.1.0 (선택 사항인
v
접두사가 지원됨)
조건을 너무 엄격하게 좁히는 연산자를 사용할 때는 주의해야 합니다. 예:
앱 버전 = 1.2.1
앱이 새로운 버전(예: 1.2.2)을 출시하면 규칙이 더 이상 일치하아 새로운 설치가 거부되거나 검증되지 않을 수 있습니다.
✅ 안전한 대안은 범위 또는 하한선을 사용하는 것입니다. 예:
앱 버전 1.2.1 이상
의도적으로 특정 빌드를 타겟팅하는 것이 아니라면 항상 조건이 향후 앱 버전과의 호환이 가능한지 확인해야 합니다.
매우 특정한 빌드를 타겟팅하고자 하는 경우, 해당 조건을 사전 조건 섹션으로 이동하는 것을 고려하시기 바랍니다.
이를 통해 규칙의 가독성과 장기적인 유지 관리를 개선할 수 있습니다.
고정/고정 해제 기능
조건을 고정하여 사전 조건으로 전환할 수 있습니다.
이는 규칙의 그룹 조건이 평가되기 전에 충족되어야 하는 글로벌 필터를 간단하게 적용할 수 있는 방법입니다.
특히 어떤 조건에 따라 해당 규칙의 적용 여부가 결정된다는 것을 알게 된 경우에 유용합니다.
조건 고정:
그룹 내 조건 옆에 있는 고정 아이콘을 클릭하면 사전 조건 섹션으로 이동합니다.
사전 조건 고정 해제:
고정 해제 아이콘을 클릭하면 해당 조건이 그룹 조건 섹션으로 돌아갑니다.
지역 및 캠페인 매칭
'지역 및 캠페인 매칭' 규칙은 선택한 지역 및 캠페인의 기기와 설치를 허용합니다.
'지역 및 캠페인 매칭' 규칙을 설정하려면 다음의 단계를 수행하시기 바랍니다.
채널 필터 설정에서 채널 , 캠페인 , '광고그룹' 을 지정하여 캠페인을 선택합니다.
규칙 조건 에서 국가 에 대한 조건을 설정하여 여러 지역을 선택합니다.
- 조건 유형 - 다음 값과 일치 또는 제외 로 설정합니다.
- 값 - 목록에서 값을 선택합니다.
새 규칙 생성 을 선택합니다.
이 규칙 유형은 어트리뷰션 소스를 스킵 합니다. 사전 지정한 지역에서 해당 캠페인 트래픽으로부터의 어트리뷰션이 없는 경우, 어트리뷰션이 발생하지 않습니다. 가장 최신의 폴백은 오가닉입니다.
예: '지역 및 캠페인 매칭' 규칙
- 캠페인 '채널' 값: AppLovin
- 국가 값: 일본
목적: AppLovin 캠페인에 대해 일본 지역에서 발생한 설치만 어트리뷰션하고자 합니다.
규칙 행동: 일본 외 지역에서 발생한 설치는 어트리뷰션을 얻은 최종 클릭이 AppLovin에서 유래했더라도 AppLovin 캠페인에 어트리뷰션되지 않습니다.
따라서 Adjust는 선행하는 가장 적합한 클릭을 찾습니다. 적합한 클릭이 발견되면 해당 클릭에 설치가 어트리뷰션되며, 그렇지 않은 경우 오가닉으로 어트리뷰션됩니다.
전환 규칙 관리
전환 규칙 페이지에서는 다음을 수행할 수 있습니다.
전환 규칙 목록 확인
규칙 상태 확인 및 상태 변경
(편집 아이콘)을 선택하여 규칙 수정 (규칙 이름, 상태, 유형 및 설정 변경 가능)
- 규칙을 생성한 앱은 바꿀 수 없습니다.
(삭제 아이콘)을 선택하여 규칙 삭제
리포트
리포트에서는 Adjust가 Datascape에서 전환 규칙 데이터를 보고하는 방법을 자세히 확인할 수 있습니다. 리포트는 다음의 구조를 사용합니다.
'검증되지 않은 기기'로 변경된 어트리뷰션
캠페인 구조 수준 | 리포트 값 |
---|---|
채널 |
|
캠페인 | 규칙 유형
|
광고 그룹 |
|
크리에이티브 |
|
'신뢰할 수 없는 기기'로 변경된 어트리뷰션
캠페인 구조 수준 | 리포트 값 |
---|---|
채널 |
|
캠페인 | 규칙 유형
|
광고 그룹 |
|
크리에이티브 |
|
항목
- 검증되지 않은 기기
- 신뢰할 수 없는 기기
지표
검증되지 않은 기기, 신뢰할 수 없는 기기 어트리뷰션 행동
설치
- 검증되지 않은 설치 스토어 규칙
- 검증되지 않은 설치 지역 규칙
- 검증되지 않은 설치 버전 규칙
- 거부된 설치 스토어 규칙
- 거부된 설치 지역 규칙
- 거부된 설치 버전 규칙
리어트리뷰션 수
- 검증되지 않은 리어트리뷰션 스토어 규칙
- 검증되지 않은 리어트리뷰션 지역 규칙
- 검증되지 않은 리어트리뷰션 버전 규칙
- 거부된 리어트리뷰션 스토어 규칙
- 거부된 리어트리뷰션 지역 규칙
- 거부된 리어트리뷰션 버전 규칙
"소스 스킵" 어트리뷰션 행동
- 검증되지 않은 인게이지먼트 지역 캠페인 규칙
- 검증되지 않은 클릭 지역 캠페인 규칙
- 검증되지 않은 노출 지역 캠페인 규칙