요약: 로데이터 리포트에서는 Protect360 엔진에 의해 그리고 수동으로 추가된 유효성 검증 규칙으로부터 차단된 인스톨 및 인앱 이벤트를 설명합니다.
Protect360 로데이터 리포트 소개
로데이터 리포트:
- 다음 데이터를 표시합니다.
- Protect360 엔진에서 사기로 식별된 클릭, 인스톨 및 인앱 이벤트.
- 유효성 검증 규칙을 통해 식별된 인스톨 및 인앱 이벤트.
- 클릭, 인스톨 또는 인앱 이벤트에 대한 차단 이유를 포함합니다.
- 광고주가 최적화를 위해 광고 네트워크 계정을 조정하고 포스트 어트리뷰션 사기에 대한 어트리뷰션 대시보드를 조정하는 데 사용됩니다.
- 앱스플라이어 Aggregated Advanced Privacy(AAP)인 경우 일부 필드가 제한되거나 사용할 수 없습니다.
- 리포트 유형 및 다운로드, API 및 데이터 락커(S3 버킷)에 의한 사용 가능 여부가 다음 섹션에 설명되어 있습니다.
- 과거 로데이터 리포트 보존 기간은 리포팅 도구 및 로데이터의 출처에 따라 최대 90일입니다.
리포트 유형
Protect360 로데이터 리포트 유형
| 리포트 | 설명 |
|---|---|
| 인스톨 |
리포트에는 다음이 포함됩니다.
|
| 포스트 어트리뷰션 인스톨 |
리포트에는 미디어소스로 귀속되었지만 나중에 사기 행위로 판명된 인스톨이 포함됩니다. Protect360은 어트리뷰션을 수정합니다. |
| 차단된 인앱이벤트 |
리포트에는 다음의 인앱 이벤트가 포함됩니다.
|
| 포스트 어트리뷰션 인앱 이벤트 |
리포트에는 다음의 인앱 이벤트가 포함됩니다.
|
| 클릭 | 리포트에는 차단 사유와 함께 차단된 클릭이 포함됩니다. |
| 차단된 인스톨 포스트백 | 리포트에는 차단된 인스톨을 가져오는 미디어소스로 전송된 거부 포스트백의 복사본이 포함됩니다. |
포스트 어트리뷰션 리포트
- 포스트 어트리뷰션 로데이터 프로드 리포트는 차단된 프로드 리포트와 동일한 구조를 갖고 있습니다.
- 이번 달 (인스톨 날짜 기준) 포스트 어트리뷰션 리포트는 다음 달의 7일 (탐지 날짜 기준)까지 계속 업데이트됩니다.
- 포스트 어트리뷰션 로데이터 리포트는 광고주로 제한됩니다. 에이전시는 액세스할 수 있는 권한을 받아야 합니다.
- 리포트에는 프로텍트360으로 식별된 포스트 어트리뷰션 프로드 이벤트가 포함되며, 하나의 리포트에 모든 미디어소스가 포함됩니다. 일러두기: 선택한 날짜 범위에 대해 식별된 포스트 어트리뷰션 사기 이벤트가 없으면 비어 있는 리포트를 반환합니다,
-
포스트 어트리뷰션 로데이터 프로드 리포트는 다음과 같이 가능합니다:
- 대시보드 UI: 달력 기준 한 달 동안 하나의 미디어 소스로 제한됩니다.
- 풀(pull) API: 모든 미디어 소스를 포함합니다. (제한: 앱 소유주에게만 가능)
포스트 어트리뷰션 리포트 사용
- 인스톨/IAE 날짜 및 탐지 날짜 범위의 조합을 필요한 대로 선택합니다.
- 프로텍트360은 달력 기준 한 달의 인스톨에 대한 포스트 어트리뷰션 탐지를 그다음 달 7일까지 수행한다는 점을 고려하십시오. 예를 들어, 11월에 발생한 인스톨에 대해 프로텍트360은 12월 7일까지 프로드를 체크합니다.
- 풀(pull) API를 사용한 모범 사례는 다음과 같습니다:
- 리포트를 매일 가져온다고(pull) 가정합니다.
- 인스톨 날짜 기간을 현재 날짜로부터 이전 60 일로 설정합니다.
- detect-from/detect-to 탐지 날짜 기간을 현재 날짜 이전으로 설정합니다.이는 어제 탐지된 포스트 어트리뷰션 프로드 목록을 수신한다는 것을 의미합니다. 며칠 동안 리포트를 가져오지 않았다면, 탐지 날짜 기간을 조절하여 리포트를 당겨오십시오.
예
예시 A: 12월에 (인스톨 날짜) 15개의 인스톨이 example_media로 어트리뷰션되었습니다. 1월 3일(탐지 날짜), Protect360은 example_media를 사기꾼으로 식별합니다. 이에 따라, example_media 에 어트리뷰션된 15개의 인스톨은 앱 소유주가 추가 조치를 취할 수 있도록 포스트 어트리뷰션 사기 리포트에 사기로 나열됩니다.
예시 B: 12월에 15개의 인스톨이 example_media로 어트리뷰션되었습니다. 1월 9일에 프로텍트360은 example_media를 사기꾼으로 식별합니다. 이 경우, 1월 7일 월간 결산을 한 이후에 프로드가 식별되었으므로, 프로텍트360은 아무 조치도 취해지지 않습니다.
도구 유형별 로데이터 가용성
툴 유형 별 프로텍트360 로데이터 가능 여부
| 리포트 | 데이터 최신성 | 풀 API | 데이터 내려받기(Export Data) 페이지 | Data Locker |
|---|---|---|---|---|
| 인스톨 | 실시간 | ✓ | ✓ | ✓* |
| 차단된 인앱이벤트 | 실시간 | ✓ | ✓ | ✓ |
| 클릭 | 실시간 | ✓ | ✓ | ✓ |
| 차단된 인스톨 포스트백 | 실시간 | - | ✓ | - |
| 포스트 어트리뷰션 인스톨 |
일일 10:00 UTC |
✓ |
✓ | ✓* |
| 포스트 어트리뷰션 인앱 이벤트 |
일일 10:00 UTC |
✓ | ✓ | - |
|
* 데이터 락커를 통한 리포트의 제한:
|
||||
로데이터 리포트 얻기
로데이터 리포트는 다운로드, Pull API 및 데이터 락커(S3 버킷)을 통해 사용할 수 있습니다. 또한 파트너에게 리포트에 대한 액세스를 부여할 수 있습니다.
다운로드
다운로드 방법:
- Protect360 대시보드에서 로데이터 리포트 > 차단된 또는 포스트 어트리뷰션으로 이동합니다.
- 포스트 어트리뷰션 리포트의 경우 미디어소스와 월을 선택합니다.
- 다운로드할 Protect360 및 유효성 검증 규칙 리포트를 선택합니다.
혹은
- 앱스플라이어 대시보드에서 데이터 내보내기로 이동합니다.
- 다운로드할 Protect360 및 유효성 검증 규칙 리포트를 선택합니다.
일러두기: 데이터 내보내기 페이지에서 다운로드한 리포트에는 모든 미디어소스가 포함되어 있습니다.
풀 API
Pull API로 사용 가능한 로데이터 리포트를 다운로드하는 방법:
시작하기 전에:
풀 API 토큰이 필요합니다. 어드민 사용자로부터 토큰을 얻습니다.
- 연동 > API 액세스로 이동합니다. Pull API 페이지가 열립니다.
- 프로텍트360 프로텍트 리포트 섹션에서 필요한 풀 API 호출을 선택합니다.
- 필요에 따라 파라미터를 채웁니다. 다음 표에는 파라미터가 나열되어 있습니다.
- 리포트를 가져오기(pull) 합니다.
풀 API 로데이터 리포트 파라미터
| 파라미터 | 설명 | 형식 | 필수 |
|---|---|---|---|
| app_id | 앱스플라이어에 표시된 앱 ID | 문자열 | 예 |
| api_token | 대시보드에서 키 값을 가져옵니다. 연동 > API 액세스로 이동합니다.어드민 사용자만이 API 토큰을 검색할 수 있습니다. | 문자열 | 예 |
| from |
날짜 범위를 시작합니다:
|
YYYY-MM-DD | 예 |
| 활용 |
날짜 범위를 종료합니다:
|
YYYY-MM-DD | 예 |
| event_name |
[포스트 어트리뷰션 인앱 이벤트 프로드의 경우에 선택적] 인앱 이벤트 별로 이벤트를 필터링합니다. 리포트를 해당 특정 이벤트로만 제한합니다. 하나 또는 그 이상의 이벤트가 포함될 수 있습니다. 사용법 예시: |
문자열 |
아니오.
|
| additional_fields=rejected_reason_value |
[포스트 어트리뷰션 인앱 이벤트 프로드의 경우에 선택적] rejected_reason_value는 하이재킹된 인스톨/인앱 이벤트에 대한 유효한 기여자(미디어소스)를 표시합니다. 기여자[1-3] 또는 오가닉으로 채워집니다. |
문자열 |
아니오. |
| detect-from |
[포스트 어트리뷰션 인스톨의 경우에 선택적] 사기 탐지 날짜 범위를 시작합니다. (기본 설정은 from입니다.) (포스트 어트리뷰션 인스톨 사기에 사용됩니다.) (포스트 어트리뷰션 인스톨 사기에 사용됩니다.) |
YYYY-MM-DD | 아니오. |
| detect-to |
[포스트 어트리뷰션 인스톨의 경우에 선택적] 사기 탐지 날짜 범위를 종료합니다. (기본 설정은 to입니다.) |
YYYY-MM-DD | 아니오. |
Data Locker
프로텍트360 리포트 구조
Protect360 리포트는 사용자 인입 리포트 필드와 일반 구조가 동일합니다.
일반 로데이터 리포트 필드 외에도 Protect360 리포트에는 다음과 같은 이유 필드도 있습니다.
차단 이유
클릭 수준 차단 이유
인스톨 수준 차단 이유
인스톨 수준에서, 앱스플라이어는 인스톨 시점에 다음 중 하나로 판별할 수 있는 충분한 데이터를 식별합니다.
- 허위 인스톨, 즉 앱을 인스톨한 유저가 실제 사람이 아닙니다. 이런 경우, 어트리뷰션은 완전히 차단됩니다.
- 인스톨 하이재킹, 즉 유저는 실제이지만 광고 인게이지먼트가 위조된 것입니다. 이런 경우, 프로드 인게이지먼트는 차단되고 어트리뷰션은 첫 번째의 유효한 기여 애드 네트워크로 다시 지정됩니다.
다음 표에는 인스톨 수준에서 가능한 차단 이유가 나열되어 있습니다.
인스톨 수준: 허위 인스톨 차단 이유
| Blocked Reason | 차단된 하위 이유 | 설명 |
|---|---|---|
| 봇 | fake_device_parameters | 앱 설치 프로세스 중에 기기 관련 파라미터에서 비인간 동작이 탐지되었습니다. |
| 봇 | fake_install_parameters | 앱 설치 프로세스 중에 인스톨 관련 파라미터에서 비인간 동작이 탐지되었습니다. |
| 봇 | bayesian_network | 프로드 패턴에 대한 베이지안 네트워크 (Bayesian network) 식별 |
| install_store_validation | - |
Apple App Store 인스톨 영수증 유효성 검사 실패함 |
| validation_bots | invalid_device_parameters | 예상되는 특정 디바이스 필드에 불일치 - 프로텍트360 사용자가 정의 |
| validation_bots | validation_rules |
결과가 수동으로 정의된 유효성 검사 규칙에 기초한 차단된 인스톨인 규칙 |
인스톨 수준: 어트리뷰션 하이재킹 차단 이유
| Blocked Reason | 차단된 하위 이유 | 설명 |
|---|---|---|
|
ctit_anomalies |
short_ctit |
짧은 CTIT로 차단된 인스톨: 프로텍트360 정의 기준 |
|
install_hijacking |
referrer_hijack |
구글 플레이 API와 앱스플라이어 SDK 파라미터에 기반하여 차단된 하이재킹 시도 |
|
install_hijacking |
integration_temporarily_blocked |
파트너(pid)의 사기율이 매우 높고 모든 트래픽에 심각한 이상이 있기 때문에 인스톨이 차단되었습니다. |
|
validation_hijacking |
short_ctit |
짧은 CTIT로 차단된 인스톨: 프로텍트360 사용자 정의 기준 |
|
validation_hijacking |
empty_site_id |
채워지지 않은 사이트 ID로 인해 차단된 인스톨. 규칙 적용은 단계적입니다. |
|
validation_hijacking |
validation_rules |
결과가 수동으로 정의된 유효성 검사 규칙에 기초한 차단된 어트리뷰션인 규칙 |
클러스터 수준 차단 이유
사기 패턴이 탐지되었을 때, 해당 사기 소스는 블랙리스트됩니다. 이런 블랙리스트된 소스에서의 인스톨은 다음의 이유로 차단됩니다.
- 허위 인스톨, 즉 앱을 인스톨한 유저가 실제 사람이 아닙니다. 이런 경우, 어트리뷰션은 완전히 차단됩니다.
- 인스톨 하이재킹, 즉 유저는 실제이지만 광고 인게이지먼트가 위조된 것입니다. 이런 경우, 프로드 인게이지먼트는 차단되고 어트리뷰션은 첫번째의 유효한 기여 애드 네트워크로 다시 지정됩니다.
다음 표에는 클러스터 수준에서 가능한 차단 이유가 나열되어 있습니다.
클러스터 수준: 허위 인스톨 차단 이유
| Blocked Reason | 차단된 하위 이유 | 설명 |
|---|---|---|
| 봇 | timestamp_anomalies | 어트리뷰션 흐름 상의 클릭 시간과 디바이스에서 수집된 다른 타임스탬프와 관련된 이상 현상 |
| bots, site_blacklist | device_emulators | 가상 환경에서 작동하는 자동 스크립트에 의해 대규모로 생성된 인스톨 |
| site_blacklist | device_farms | 높은 비율의 알려지지 않은 (뉴) 디바이스 |
| behavioral_anomalies | behavioral_anomalies | 일반 앱 유저 행동 패턴에 비교했을 때, 의심스러운 인앱 행동 |
클러스터 수준: 어트리뷰션 하이재킹 차단 이유
| Blocked Reason | 차단된 하위 이유 | 설명 |
|---|---|---|
| ctit_anomalies, install_hijacking | ctit_anomalies | 앱 표준에 비해 비정상적인 CTIT 패턴 |
| click_flood | click_flood | 비정상적으로 많은 클릭이 긴 CTIT 분포에 걸쳐있음 |
| install_hijacking | click_clusters | 기기 수준 멀웨어에 의해 클릭이 생성됨 |
인앱 수준 차단 이유
인앱 이벤트는 다음과 같은 이유로 차단될 수 있습니다.
- 초기 인스톨이 허위로 식별되었습니다.
- 정의된 유효성 검증 규칙 때문입니다.
- 앱스플라이어 알고리즘이 프로드를 감지했기 때문입니다.
다음 표에는 인앱 이벤트 수준에서 가능한 차단 이유가 나열되어 있습니다.
인앱 이벤트 수준 차단 이유
| Blocked Reason | 차단된 하위 이유 | 설명 |
|---|---|---|
| Inherits from install | Inherits from install | 인스톨 또는 거부 리스트 수준의 이유에 의해 초기 인스톨이 허위로 식별되었음 |
| inapps_bots | fake_device_parameters | 앱스플라이어 알고리즘이 프로드를 감지 |
| in_app_store_validation | - | 인앱 구매에 대한 영수증 검증 실패. |
| validation_inapps | validation_rules |
수동으로 정의한 유효성 검사 규칙에 기반 |
리타게팅
Protect360 로데이터에는 리타게팅 캠페인으로부터의 사기성 인스톨 및 세션(각각 리어트리뷰션 및 리인게이지먼트라고 함)이 포함됩니다. 데이터는 이벤트 이름 및 리타게팅 변환 유형 필드를 사용하여 표시됩니다. 다음 중 하나로 표시됩니다.
- 인스톨(이벤트 이름에는 표시되지만 변환 유형을 다시 지정할 수는 없음)
- 리어트리뷰션
- 리인게이지먼트
- 재설치 (Reinstall)
Protect360 리타게팅 로데이터는 다음과 같이 실시간 차단 및 사기로 식별된 포스트 어트리뷰션에 대해 사용할 수 있습니다.
| 리포트 | 데이터 내려받기 | 풀 API | Data Locker |
|---|---|---|---|
| 인스톨 | ✓* | ✓* | - |
| 포스트 어트리뷰션 인스톨 | ✓ | ✓ | ✓ |
|
* 리인게이지먼트 데이터 사용 불가 |
|||
하이재킹 인스톨 어트리뷰션 수정
하이재킹된 인스톨의 경우 앱스플라이어는 사기성 네트워크에 대한 어트리뷰션을 차단하고 대신 마지막 합법적인 기여자 소스를 지정합니다.
하이재킹된 인스톨의 경우 rejected_reason_value 필드를 사용하여 유효한 기여자(미디어소스)를 식별합니다. 이는 원래 어트리뷰선을 받았어야 하는 기여자를 의미합니다.
- rejected_reason_value는 기여자[1-3] 또는 오가닉으로 채워집니다. 기여자[1-3] 미디어소스/파트너 필드를 확인하여 기여자 세부 정보를 확인하고 조정합니다.
- 기여자 필드가 리포트에 표시되지 않으면 데이터 내보내기 페이지에서 추가할 수 있습니다.
일러두기: 하이재킹된 인스톨이 실시간으로 차단되면 올바른 어트리뷰션이 앱스플라이어 대시보드 및 리포트에 표시됩니다(Protect360뿐만 아니라). 하이재킹된 인스톨이 포스트 어트리뷰션으로 확인되면 Protect360 로데이터에만 올바른 어트리뷰션이 표시됩니다.