연동 파트너를 위한 Protect360

요약: 연동 파트너(애드 네트워크 및 에이전시)는 ProtectLITE 및 Protect360 엔진으로 식별되고 차단되는 트래픽과 관련된 사기와 고객이 수동으로 정의한 유효성 검증 규칙을 볼 수 있습니다.

개요

앱스플라이어는 다음을 통해 사기를 식별하고 차단합니다. 

  • ProtectLITE: 모든 고객에 대한 기본 사기 보호. 
  • Protect360: 프리미엄 구독 플랜을 가진 광고주를 위한 고급 사기 방지. 

광고주는 다음을 제공해야 합니다.

  • Protect 360 대시보드 및 로데이터 리포트(ProtectLITE 포함)에 대한 액세스 및 집약형 인앱이벤트 데이터(인앱이벤트 사기에 대한)에 대한 액세스를 위한 광고 네트워크 권한.
  • Protect360 대시보드 및 로데이터 액세스를 위한 에이전시 권한.

올바른 권한을 가진 연동 파트너는 다음을 수행할 수 있습니다.

클릭 및 노출 캡핑에 대한 광고 네트워크에 사용 가능한 로데이터 리포트와 광고주 권한이 필요하지 않은 실패한 클릭 서명도 있습니다.

 일러두기

에이전시를 통해 광고 네트워크에 대한 작업을 수행하는 광고주의 경우 광고 네트워크와 에이전시가 모두 데이터에 액세스하기 위해 광고주는 에이전시와 광고 네트워크를 모두 앱스플라이어에 연동하고 데이터에 액세스할 수 있는 권한을 부여해야 합니다.

에이전시만 연동하고 권한을 부여하면 광고 네트워크가 데이터에 접근할 수 없습니다.

대시보드 뷰

전제조건: 광고주로부터 ProtectLITE 및 Protect360에 액세스 권한 받기. 

연동 파트너는 대시보드와 차트를 볼 수 있습니다. 다음 스크린샷을 참조하십시오.

ProtectLITEProtect360 대시보드에서 사용 가능한 데이터에 대해 자세히 알아보십시오.   

제한 사항:

  • 광고 네트워크는 이상 대시보드에 액세스할 수 없습니다. 에이전시는 액세스 권한이 있지만, 다른 미디어소스를 비교하기 위해 기준선을 작성할 수 있도록 앱스플라이어가 신뢰하는 소스에서 낮은 사기 비율을 갖는 트래픽이 있는 경우에만 데이터를 볼 수 있습니다.

p360_dashboard_1.jpg

로데이터 리포트

전제조건: 광고주로부터 ProtectLITE 및 Protect360에 액세스 권한 받기. 

Protect360 로데이터 리포트는 ProtectLITE, Protect360 및 유효성 검증 규칙을 통해 식별되고 차단된 사기를 보여줍니다.

리포트는 다음을 통해 사용 가능합니다.

  • 데이터 내보내기: 리포트 > 데이터 내보내기로 이동합니다.
  • API: 다음에 나오는 광고 네트워크 리포트 API 섹션을 참조하십시오. 

Protect360 로데이터 리포트에 대해 자세히 알아보기.

Protect360 광고 네트워크 리포트 API

  • 이 절에 기재한 로데이터 리포트는 API를 통해 광고 네트워크에 사용할 수 있습니다.
  • 동등한 리포트는 데이터 내보내기 페이지의 대시보드에서 사용할 수 있습니다.
  • 광고주에게 Protect360 등록이 없는 경우에는 인스톨 리포트만 사용할 수 있습니다.

선행 조건

  • API에 의해 광고주 데이터에 액세스하기 위해, 광고주는 광고 네트워크에 Protect360 대시보드 및 API에 의한 데이터에 액세스하기 위한 권한을 승인합니다. 대시보드에 대한 액세스를 갖는 광고 네트워크는 API를 사용하도록 허용됩니다. 광고주는 어떤 작업도 필요하지 않습니다. 
  • Protect360 권한이 있는 앱 목록은 앱 목록 API 가져오기를 사용하십시오. 
  • 관리자는 대시보드에서 사용 가능한 앱스플라이어 V2.0 인증 토큰 을 가져와야 합니다.

Protect360 API 리포트

리포트 데이터 최신성 설명
포스트 어트리뷰션 인앱 이벤트 프로드

일일 10:00 UTC

  • 프로드로 식별된 인스톨에서 수행된 인앱 이벤트
  • 인스톨과 상관없이 프로드로 판단된 다른 모든 인앱 이벤트

아래에서 설명한 대로, 리포트를 인앱 이벤트 유형 기준으로 선택적으로 필터링할 수 있습니다. 

리포트 주제: fraud-post-inapps

포스트 어트리뷰션 인스톨

일일 10:00 UTC

  • 프로드 포스트 어트리뷰션으로 식별된 인스톨. 
  • 아래에서 설명한 대로, 리포트를 탐지 날짜 기준으로 선택적으로 필터링할 수 있습니다. 

리포트 주제: detection

인스톨

실시간

차단된 인스톨과 차단 이유

리포트 주제: blocked_installs_report

인앱 이벤트 실시간

차단된 유저가 수행한 인앱 이벤트

리포트 주제: blocked_in-app_events_report

클릭 실시간

차단된 유저가 수행한 클릭

리포트 주제: blocked_clicks_report

다운로드로 Protect360 리포트를 얻기 위한 광고 네트워크를 위한 절차

API를 사용하는 리포트를 가져오는 방법:

  1. 선행 목록에서 필수 리포트를 식별합니다.
  2. 관련 curl 예제(다음 절에서)를 사용하여 스크립트를 준비합니다.
  3. 다음 플레이스홀더를 대체하는지 확인하십시오.
    1. 앱 ID
    2. 시작 날짜
    3. 종료 날짜
    4. 베어러 토큰(앱스플라이어 V2.0 인증 토큰)
  4. 본 기사에서 설명한 것처럼 일부 콜은 선택적인 파라미터를 가집니다. 

curl 예시

인스톨(blocked_installs_report)

app_id, 시작, 종료 및 토큰 플레이스홀더를 교체합니다.


curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/blocked_installs_report/app/{app_id}?from={2020-07-10}&to={2020-07-20}&additional_fields=keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \

포스트 어트리뷰션 인스톨(감지)

app_id, 시작, 종료 및 토큰 플레이스홀더를 교체합니다. 


curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/detection/app/{app-id}?from={2020-06-10}&to={2020-07-20}&additonal-fields=fraud_reason,fraud_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,detection_date' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \

인앱 이벤트(blocked_in_app_events_report)

app_id, 시작, 종료 및 토큰 플레이스홀더를 교체합니다.


curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/blocked_in_app_events_report/app/?from=YYYY-MM-DD&to=YYYY-MM-DD&additional_fields=keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type' \ -H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \

포스트 어트리뷰션 인앱 이벤트 사기(fraud_post_inapps)

app_id, 시작, 종료 및 토큰 플레이스홀더를 교체합니다.


curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/fraud-post-inapps/app/{app-id}?from={2020-06-10}&to={2020-07-20}&additional_fields=match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,fraud_reason,fraud_sub_reason,detection_date' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \

클릭(blocked-clicks_report)

app_id, 시작, 종료 및 토큰 플레이스홀더를 교체합니다.


curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/blocked_clicks_report/app/{app-id}?from={2020-06-10}&to={2020-07-20}&additional_fields=keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}' \

Protect360 광고 네트워크 API 참조 가이드

API 기초

Protect360 광고 네트워크 API 기초

경로

https://hq1.appsflyer.com/api/adnets-data/v1/export/report_topic/app/app_id

방법 GET
경로 파라미터(필수)
  • app_id:
    • 앱스플라이어 대시보드에서 찾아볼 수 있는 앱 식별자. 대시보드에 표시된 대로 정확하게 삽입합니다.
    • iOS 앱 앞에 ID를 붙이십시오.
  • report_topic
허용된 콘텐츠 유형 application/json 
권한관리
  • 요청 헤더의 베어러 토큰.
  • AppsFlyerAdmin_us-en.png어드민에게 토큰 페이지에서 V2.0 토큰을 가져오도록 요청하십시오. 이 토큰은 길이가 약 700자입니다. 
콜 수 제한 콜 수 제한
데이터 범위 제한
  • 지원되는 가장 최근 날짜: 현재 날짜의 90일 전
  • 이전 90일 중 31일
행 제한 20만 행
리포트 특성
  • 시간대: UTC
  • 통화: USD

API 파라미터

Protect360 API 파라미터

파라미터 설명 형식 필수
app_id  앱스플라이어에 표시되는 앱 ID 문자열
from

날짜 범위를 시작합니다:

  • 인스톨의 경우, 인스톨 날짜입니다.
  • 인앱 이벤트의 경우, 이벤트 날짜입니다.
YYYY-MM-DD
활용

날짜 범위를 종료합니다:

  • 인스톨의 경우, 인스톨 날짜입니다.
  • 인앱 이벤트의 경우, 이벤트 날짜입니다.
YYYY-MM-DD
event_name

[포스트 어트리뷰션 인앱 이벤트 프로드의 경우에 선택적]

인앱 이벤트별로 이벤트를 필터링합니다. 리포트를 해당 특정 이벤트로만 제한합니다. 하나 또는 그 이상의 이벤트가 포함될 수 있습니다.

사용법 예시: &event_name=af_purchase,af_login

문자열

아니오

 

detect-from

[포스트 어트리뷰션 인스톨의 경우에 선택적]

프로드 탐지 날짜 범위를 시작합니다. (기본 설정은 from입니다.) 

YYYY-MM-DD 아니오
detect-to

[포스트 어트리뷰션 인스톨의 경우에 선택적]

프로드 탐지 날짜 범위를 종료합니다. (기본 설정은 to입니다.)

YYYY-MM-DD 아니오

Protect360 API HTTP 리턴 코드

오류 코드 및 해결 방안

상태 메시지 코드 증상/메시지 해결 방안
OK 200 빈 CSV 파일

addtional_fields은 URL에서 한 번 이상 사용됩니다.

OK

200

빈 CSV 파일

시작 날짜와 종료 날짜가 모두 yyyy-mm-dd 형식인지 확인하십시오.

확인 

200

AppsFlyer HTML 로그인 페이지 리턴

베어러 토큰 헤더에 토큰이 없습니다.

Bad request

400

Bad request

  • 데이터 범위 제한.
    • 허용된 가장 빠른 날짜는 현재 날짜보다 90일 이전입니다.
    • 기간은 인스톨의 경우 60일, 인앱 리포트의 경우 90일을 초과할 수 없습니다.
Unauthorized

401

Unauthorized

토큰이 발견되었지만 올바르지 않습니다. 계정에 대한 현재 V2.0 토큰이 있는지 확인합니다. 관리자에게 대시보드에서 현재 토큰을 검색하도록 요청하십시오.

Not found

404

 

  • 지정한 엔드포인트가 올바르지 않습니다.
  • 앱 ID가 올바른지 확인하십시오.
  • 앱에 액세스할 권한이 없습니다.

노출 및 클릭 캡핑

광고 네트워크의 노출 또는 클릭 사기율이 매우 높은 경우 Protect360은 24시간 동안 광고 네트워크의 노출 또는 클릭을 차단합니다. 다시 말하면 임계값에 도달한 후 발생한 노출/클릭은 앱스플라이어에서 기록되지 않으며, 어트리뷰션 자격도 없다는 것을 의미합니다. 차단된 노출/클릭은 Protect360 대시보드 및 리포트에 나타납니다.

앱스플라이어의 사기 방지 알고리즘은 사기 행위를 탐지할 때 노출/클릭 수, CVR, 사기 탐지율, 활동의 정상적인 변동, 산업 및 지리적 벤치마크, 독점 파라미터 등 다양한 매개 변수를 고려합니다. 알고리즘은 변화하는 추세를 고려하여 매시간 동적으로 업데이트됩니다.

노출 또는 클릭 도배 임계값을 반복적으로 트리거하면 앱스플라이어 플랫폼에서 파트너 연동이 영구적으로 제거될 수 있습니다.

노출 및 클릭 캡핑 임계값: 

  • 모든 광고 네트워크에 동등하게 적용합니다. 즉, 극도로 높은 노출 또는 클릭 사기율이 캡핑으로 이어지지 않는 광고 네트워크는 존재하지 않습니다.
  • 앱/광고 네트워크 수준이어야 합니다. 즉, 사기 분석은 앱에 있는 모든 광고 네트워크의 캠페인을 고려하며, 차단은 앱에서 모든 광고 네트워크의 캠페인에 대한 보고 및 어트리뷰션에 영향을 미칩니다(계정에 Protect360이 있는지 여부에 관계없이).
  • 24시간의 주기 후 재설정되며 주기 종료 시까지 차단이 적용됩니다. 주기의 시작과 종료에 대한 자세한 내용은 앱스플라이어에 의해 비공개로 유지됩니다.
  • 변경 또는 중지할 수 없습니다. Protect360은 정밀하게 조정되고 사기를 정확하게 감지하며 알고리즘은 수동으로 조정하거나 끌 수 없습니다. 
  • 비정상적인 활동을 하는 캠페인 및 퍼블리셔를 중지하여 방지할 수 있습니다.

자주 하는 질문

노출 및 클릭 캡핑의 자주 묻는 질문

질문: 네트워크 임계값은 무엇입니까?

A: 클릭 상한선 메커니즘의 세부 사항은 우회 시도를 방지하기 위해 보호됩니다. 즉, 임계값은 인간 행동의 가능성을 넘어 엄청난 양의 노출/클릭이 발생한 경우에만 도달합니다. 그날의 인상을 살펴보면 클릭 및 설치 볼륨을 통해 하나 이상의 게시자로 인한 플러드 문제가 있는지 여부를 명확하게 알 수 있습니다.

질문: 네트워크가 차단 해제되는 방법은 무엇입니까?

답변: 네트워크는 비정상적인 활동을 하는 캠페인 및 퍼블리셔를 중지하여 임계값을 방지할 수 있습니다. 일단 차단되면, 네트워크는 24시간 주기가 끝날 때까지 클릭이 다시 기록되기를 기다려야 합니다.

질문: 이 차단은 Protect360을 사용하지 않는 앱스플라이어 고객에게 영향을 미칩니까?

A: 예, 상한선은 고객이 Protect360을 보유하고 있는지 여부에 관계없이 영향을 미칩니다. 최대 설정 메커니즘은 클릭/노출 남용으로부터 모든 고객을 보호합니다.

질문: 이건 사기가 아닙니다. 네트워크는 저렴한 소스로 작동하고 있으며 품질이 떨어지는 경우도 있습니다.

답변: 의심스럽지 않은 소스에서 정상적인 척도로 성능이 저하되면 클릭 캡핑이 발생하지 않습니다. 알고리즘은 인간이 식별할 수 없는 성능을 식별합니다.

질문: 이로 인해 캠페인 규모가 확장되지 않으며 이러한 노출/클릭이 차단되는 것을 원하지 않는 것입니다.

답변: 앱스플라이어 사기 보호 알고리즘은 극단적이고 노골적인 플러딩 사례로부터 고객을 보호합니다. 대부분의 차단이 골칫거리만 일으키는 비인적 노출/클릭을 처리하므로 확장 기능에 영향을 미치지 않습니다. 문제가 있는 경우 앱스플라이어에 문의하여 문제를 해결하십시오.

Q: 이것은 사기가 아닙니다. AppsFlyer가 노출/클릭 수를 처리하는 데 문제가 있는 것은 아닐까요?

A: 볼륨을 처리하는 데 문제가 없습니다. 당사는 세계 최대 규모의 광고주를 지원하고 수많은 합법적인 클릭을 포함하여 매일 수십억 개의 실시간 데이터 포인트를 처리합니다. 풍부하고 정확한 데이터로 대규모 성장을 지원하기 위한 노력의 일환으로 당사는 고객의 이익을 위해 노력하고 명확한 클릭 도배의 인스턴스를 차단합니다. 

 

질문: 인스톨과 함께 클릭을 제한하는 접근 방식을 변경한 이유는 무엇입니까?

A: 우리는 고객을 보호하기 위한 지속적인 노력의 일환으로 사기 방지 메커니즘을 지속적으로 개선하고 있습니다. 지금까지는 노출/클릭을 허용하고 설치만 차단했습니다. 그러나 극단적인 경우 클릭률이 불가능할 정도로 극단적이며, 이러한 경우 이를 시스템에 수용하는 것은 의미가 없습니다.

Q: 트래픽 및 노출/클릭 수가 크게 증가할 것으로 예상되는 경우(예: 새 캠페인으로 인해) 어떻게 해야 합니까? 차단을 피하기 위해 무엇을 할 수 있을까요?

A: 알고리즘은 동적이며 다양한 추세를 고려하여 매시간 업데이트됩니다. 스파이크를 처리할 수 있을 만큼 정교하며 갑작스럽고 상당한 볼륨 증가를 포함한 정상적인 활동 변동에 의해 트리거되지 않습니다. 즉, 파트너는 노출/클릭 데이터 및 보고서를 사용하여 의심스러운 출처를 식별하고 해당 캠페인을 중지할 수 있습니다.

Q: 트래픽이 문제가 있는지 확인하고 캠페인 성과를 개선하려면 어떻게 해야 합니까?

A: 파트너는 노출/클릭 데이터 및 보고서를 사용하여 의심스러운 출처를 식별하고 해당 캠페인을 중지할 수 있습니다. 또한 파트너는 광고주로부터 대시보드에서 사기 데이터를 볼 수 있는 필수 권한을 받은 경우 전용 열 아래의 Protect360/ProtectLITE 대시보드에서 차단된 노출 및 클릭 데이터를 볼 수 있습니다.

 

Q: 네트워크에 최대 한도 설정과 관련된 알림 이메일이 전송됩니까?

ᅡ: 클릭 상한선의 경우, 앱스플라이어는 클릭 상한선 임계값에 도달할 때마다 광고 네트워크에 이메일 알림을 보냅니다.

클릭 서명

클릭 제한을 방지하기 위해 광고 네트워크는 HMAC-SHA256 서명을 클릭에 추가할 수 있습니다. 

서명을 통해 앱스플라이어는 클릭의 유효성을 검사하고 부정 행위자가 클릭 정보를 조작하지 않았는지 확인할 수 있습니다.

  • 검증된 클릭이 기록되고 광고 네트워크에 어트리뷰트됩니다. 
  • 검증되지 않은 클릭은 거부되며 
    • (광고주가 아닌) 광고 네트워크에서 사용할 수 있는 Protect360 리포트에 집계됩니다.
    • 전환율이나 광고 네트워크의 클릭 캠핑 임계값에 영향을 주지 않습니다.