요약: 로데이터 어트리뷰션 이벤트를 서버 측 엔드포인트로 스트리밍합니다.
푸시 API
Push API는 앱스플라이어 어트리뷰션 및 메시지로서의 SKAN(SKAdNetwork) 어트리뷰션으로 생성된 로데이터를 서버로 스트리밍합니다. 메시지 유형 및 콘텐츠를 선택하고 목적지 엔드포인트를 설정할 수 있습니다.
사용 가능한 메시지 유형, 데이터 신선도 및 필드는 다음 섹션에서 설명하는 어트리뷰션 프레임워크(앱스플라이어 또는 SKAN)에 따라 달라집니다.
앱스플라이어 어트리뷰션 메시지
메시지 특성
특성 | 상세 내용 |
---|---|
메시지 유형 구분 |
예: 메시지에는 다음 사항이 포함됩니다.
표를 사용하여 이 이벤트가 오가닉 사용자의 인스톨 이벤트인지 확인합니다. |
데이터 최신성 |
앱스플라이어 플랫폼에 이벤트가 기록되는 즉시 메시지가 전송됩니다. 이 과정은 보통 1분 이내입니다. |
메시지 콘텐츠(필드) |
|
타임 스탬프 필드 형식 |
|
사용 가능한 메시지 유형
어트리뷰션 컨텍스트 | 메시지 유형 | conversion_type 필드 | campaign_type 필드 | event_name 필드 | event_type 필드 |
---|---|---|---|---|---|
사용자 획득 | 인스톨* | 인스톨 |
논오가닉: UA 오가닉: 오가닉 |
인스톨 |
|
유저 획득 | install in-app events | 인스톨 |
논오가닉: UA 오가닉: 오가닉 |
광고주가 정의한 이벤트 이름 |
|
리타겟팅 |
리인게이지먼트 | 리인게이지먼트 | 리타게팅 | 리인게이지먼트 |
리인게이지먼트 |
리타겟팅 | Re-engagement in-app events | 리인게이지먼트 | 리타게팅 | 광고주가 정의한 이벤트 이름 |
re-engagement-in-app-event |
리타겟팅 | Re-attribution | 재설치 (Reinstall) | 리타게팅 | 리어트리뷰션 |
리어트리뷰션 |
유저 획득 | 재설치 (Reinstall) | 재설치 (Reinstall) |
논오가닉: UA 오가닉: 오가닉 |
재설치 (Reinstall) |
|
리타겟팅 | Re-attribution in-app events | 재설치 (Reinstall) | 리타게팅 | 광고주가 정의한 이벤트 이름 |
re-attribution-in-app-event |
광고 조회 어트리뷰션과 관련되는 일부 인스톨은 제한된 미디어 소스로 어트리뷰트됩니다. |
고유 필드
표시 이름 | Push API 이름 |
---|---|
선택된 통화* | selected_currency |
선택된 통화로 표시된 수익 | revenue_in_selected_ currency |
선택된 통화로 표시된 비용 | cost_in_selected_ currency |
선택된 시간대의 기기 다운로드 시간 | device_download_time_selected_timezone |
선택된 시간대의 어트리뷰트된 터치 시간 | attributed_touch_time_selected_timezone |
선택된 시간대의 인스톨 시간 | install_time_selected_ timezone |
선택된 시간대의 이벤트 시간 | event_time_selected_ timezone |
선택된 시간대(*) |
selected_timezone |
* API 메시지가 전송될 때 적용되어 있는 앱 설정을 따릅니다. |
SKAN 어트리뷰션 메시지
이 섹션에서는 SKAN에 사용할 수 있는 메시지(리포트 유형)와 메시지를 식별하는 방법에 대해 설명합니다. 이 섹션을 읽은 다음 SKAN 어트리뷰 엔드포인트 설정을 읽으십시오.
관련 자료: SKAN 로데이터 필드. Push API 메시지는 동등한 구조 및 필드를 가집니다.
메시지 특성:
특성 | 상세 내용 |
---|---|
메시지 유형 구분 |
예: 메시지에는 다음 사항이 포함됩니다.
skad_redownload: true이므로, 이것은 재다운로드 이벤트라고 결정할 수 있습니다. |
데이터 최신성 |
|
메시지 예시 | 스프레드시트에는 메시지 예시가 포함되어 있습니다. 제공된 예시는 JSON 형식입니다. SKAN 예시 메시지. |
SKAN 어트리뷰션에 대한 메시지 유형
메시지 유형 |
event_name 필드 |
skad_redownload 필드 |
event_type 필드 |
---|---|---|---|
인스톨 | 인스톨 |
|
skad-installs |
재다운로드 | 인스톨 | true |
skad-re-downloads |
인앱 이벤트 |
광고주가 설정한 이벤트 이름 |
광고주가 설정한 이벤트 이름 |
skad-in-app-events |
iOS의 포스트백 |
이 메시지에서는 사용할 수 없습니다 |
이따금 사용 가능합니다 |
skad-postbacks |
포스트백 복사 |
이 메시지에서는 사용할 수 없습니다 |
이따금 사용 가능합니다 |
skad-postbacks-copy |
SKAN 어트리뷰션 메시지 유형을 결정합니다.
일러두기: iOS에서 직접 도착하는 포스트백 메시지에는 적용되지 않습니다.
Push API 엔드포인트 설정하기
주의
다음과 같은 이유로 앱스플라이어 어트리뷰트 데이터를 타사에 전송할 때 Push API를 사용하지 마십시오.
- 사용자가 자신의 데이터를 타사에 보내지 않기로 선택한 경우 CCPA와 같은 프라이버시 규정의 위반으로 될 수 있습니다.
- 일부 미디어소스는 해당 미디어소스가 제공하는 사용자 수준 데이터의 사용, 제3자 공유 또는 둘 다를 제한합니다. 미디어소스의 사용 약관을 준수하십시오.
예를 들어 X 광고, 스냅챗, 핀터레스트.
일러두기: 이 주의사항은 SKAN 데이터에는 적용되지 않습니다. Push API를 사용하여 SKAN 데이터를 타사 엔드포인트로 전송합니다.
Push API를 설정하려면 다음 작업 목록을 완료하십시오.
Push API 설정 체크리스트
단계 번호 | Appsflyer 어트리뷰션 | SKAdNetwork 어트리뷰션 |
---|---|---|
1 |
활성 Push API 엔드포인트가 이미 있는 경우 이 단계를 건너뛸 수 있습니다. 서버 측 필요 사항을 완료하십시오. |
|
2 |
앱스플라이어 어트리뷰션의 경우 Push API 계획 체크리스트를 사용하여 엔드포인트 설정을 계획합니다. |
해당 사항 없음. |
3 |
서버 측 필요 사항 (앱 개발사 서버)
서버가 다음 요구 사항을 준수하는지 확인하십시오.
서버 측 필요 사항
엔드포인트 URL |
|
엔드포인트 리턴 코드 | 엔드포인트는 메시지를 수신하면 반드시 HTTP 200 상태 코드를 반환해야만 합니다. |
앱스플라이어 서버 등록 |
방화벽 및 보안 시스템에 앱스플라이어 서버 IP 주소를 등록하여 엔드포인트와의 통신을 보장합니다. |
TLS 버전 |
|
포트 |
포트: 80, 443 |
메모! 지속 시간이 2초인 시간 제한 메커니즘이 사용됩니다. 이 시간 동안 앱스플라이어가 OK 메시지를 받지 못하면 앱스플라이어는 이를 메시지 전송 실패로 간주합니다.
앱스플라이어 어트리뷰선에 대한 Push API 계획 체크리스트
- 이 체크리스트를 사용하여 앱스플라이어 어트리뷰션 엔드포인트 설정을 계획합니다. 그림 속의 숫자는 체크리스트의 행 번호와 같습니다.
- 이 섹션은 SKAdNetwork 어트리뷰션과 관련이 없습니다. SKAdNetwork 어트리뷰션 설정을 참고하십시오.
엔드포인트
엔드포인트 계획 체크리스트
아닙니다. |
설정 |
상세 내용 | 이 열에 계획한 설정을 기록합니다 |
---|---|---|---|
1 |
방법 |
POST 또는 GET |
|
2 |
엔드포인트 URL |
- | |
3 | 이벤트 메시지 유형 |
|
|
4 |
|
주의모두 선택으로 표시하면 새로 추가된 필드도 모두 자동으로 선택됩니다. 문제를 방지하기 위해 스키마에 자동으로 추가된 모든 새 필드를 지원할 수 있는지 확인하십시오. 필요한 필드를 선택하십시오.
|
|
5 |
인앱 이벤트 유형
|
인앱 이벤트 기준으로 필터링하여 엔드포인트로 전송되는 트래픽을 줄입니다.
|
앱스플라이어 어트리뷰션 엔드포인트 설정하기
참고: 앱스플라이어 계정 소유자만 푸시 API 설정을 변경할 수 있습니다. 다른 계정 사용자는 설정을 볼 수만 있습니다.
앱스플라이어 어트리뷰션 엔드포인트 추가 방법:- 리포트 > API 액세스 )로 이동 Push API 섹션까지 아래로 스크롤합니다.
- 엔드포인트 추가 버튼을 클릭합니다.
- HTTP 메서드를 선택합니다. POST 또는 GET
- 엔드포인트 URL을 입력합니다. 이 URL이 안전하지 않음 메시지가 표시되면 앱스플라이어 지원팀에 문의하십시오.
- 하나 이상의 이벤트 유형을 선택합니다. 일러두기: 인앱 이벤트 메시지가 비활성화 상태라면 지금까지 인앱 이벤트가 기록되지 않았다는 것입니다.
- 푸시 API 메시지에 포함될 필드를 선택합니다. 참고:
- 인앱 이벤트를 하나 또는 여러 개(최대 52개 이벤트) 선택하거나, 모두 선택합니다.
- 목록은 이미 기록된 적이 있는 이벤트 유형들로 이루어져 있습니다. 이벤트가 누락된 경우, 테스트 기기를 사용하여 이 유형의 이벤트를 보내십시오.
- 저장을 클릭합니다.
Push API가 지금 활성화되었습니다. 전환 데이터가 엔드포인트로 전송됩니다. - 아래 설명된 절차를 통해 엔드포인트를 테스트 합니다.
엔드포인트를 테스트하려면:
- 테스트 전송을 클릭합니다.
테스트 전송 버튼 아래에 테스트 결과 메시지가 표시됩니다.
테스트 메시지가 엔드포인트로 전송됩니다. 테스트에 실패하는 경우 앱스플라이어 IP 주소가 등록되었는지 확인하십시오.
일러두기! 2초간 지속되는 시간 제한 메커니즘이 사용됩니다. 앱스플라이어가 이 시간 동안 OK 메시지를 받지 못한다면 앱스플라이어는 메시지 전송 실패로 간주합니다. - 엔드포인트가 테스트 메시지를 수신했는지 검증합니다.
전송된 메시지 복사본은 다음과 같습니다.
SKAdNetwork 어트리뷰션 엔드포인트 설정하기
참고: 앱스플라이어 계정 소유자만 푸시 API 설정을 변경할 수 있습니다. 다른 계정 사용자는 설정을 볼 수만 있습니다.
SKAdNetwork Push API 엔드포인트를 추가하는 방법:- 리포트 > API 액세스 )로 이동 Push API 섹션까지 아래로 스크롤합니다.
- SKAdNetwork를 어트리뷰트 엔터티로 선택합니다.
- 엔드포인트 추가를 클릭합니다.
일러두기: 앱당 1-3개의 SKAdNetwork 엔드포인트를 정의할 수 있습니다. - HTTP 메서드를 선택합니다. POST 또는 GET
- 엔드포인트 URL을 입력합니다. 이 URL이 안전하지 않음 메시지가 표시되면 앱스플라이어 지원팀에 문의하십시오.
- 비어 있는 필드/null 필드와 이 필드에 연결된 키는 전송하지 않습니다. 가져오기/파싱 절차를 계획할 때, 이 점을 고려하십시오.
- 저장을 클릭합니다.
Push API가 지금 활성화되었습니다. 데이터가 엔드포인트로 전송됩니다.
추가 절차—엔드포인트 관리
엔드포인트 변경
참고: 앱스플라이어 계정 소유자만 푸시 API 설정을 변경할 수 있습니다. 다른 계정 사용자는 설정을 볼 수만 있습니다.
엔드포인트 설정 수정 방법:
- API 액세스 > 보고서 로 이동합니다.Push API 섹션까지 아래로 스크롤합니다.
- 수정할 엔드포인트를 찾습니다.
- 수정합니다.
- 저장을 클릭합니다.
엔드포인트 삭제
참고: 앱스플라이어 계정 소유자만 푸시 API 설정을 변경할 수 있습니다. 다른 계정 사용자는 설정을 볼 수만 있습니다.
엔드포인트를 삭제하려면:
- Report > API Access(API 액세스 보고서)로 이동 Push API access(푸시 API 액세스) 섹션까지 아래로 스크롤합니다.
- 엔드포인트 삭제를 클릭합니다.
- 저장을 클릭합니다.
엔드포인트가 삭제되었습니다.
문제 해결, 특성 및 제한 사항
테스트 메시지 실패
테스트 메시지를 받지 못하고 IP 주소별로 서버에 대한 액세스를 제한하는 경우 앱스플라이어 IP 주소를 모두 등록했는지 확인하십시오.
중복된 리타겟팅 인앱 이벤트
유저 유입(UA) 리인게이지먼트 윈도우 내에, 리타겟팅 캠페인의 영향으로 구매 이벤트가 일어나는 경우, 리타겟팅 인앱 이벤트는 중복 기록됩니다. 이는 UA 미디어 소스와 리타겟팅 미디어 소스 모두에 수익을 어트리뷰션 하기위해 이루어집니다.
아래 둘 다 활성화한 경우에만 중복 이벤트를 얻을 수 있습니다.
- install in-app events
- 리타겟팅 인앱 이벤트
인앱 이벤트 메시지 선택란이 비활성화 상태입니다.
- 인앱 이벤트 메시지는 최소 하나의 인앱 이벤트가 기록된 후에만 선택할 수 있습니다.
- 테스트 기기를 사용하여 인앱 이벤트를 생성하거나, S2S API를 사용하여 수동으로 이벤트를 생성하십시오.
누락된 푸시 메시지와 CloudFront
엔드포인트로 아마존 CloudFront를 사용하고 있습니까? 그렇다면, CloudFront가 거부 코드 421를 가진 메시지를 거부하고 있는지 확인하십시오. 이 경우 CloudFront에서 HTTPS 요청을 처리하는 방법 선택 안내를 참고하십시오.
엔드포인트 오류 메시지
증상: 엔드포인트 URL을 설정할 때 이 URL이 안전하지 않음 메시지가 표시됩니다.
필요한 조치: 앱스플라이어 지원팀에 문의하십시오. 이때 앱 ID, 엔드포인트 URL 및 오류 메시지의 스크린샷을 제공하십시오.
사양 및 제한 사항
사양 | 참고 |
---|---|
광고 네트워크 | 해당 없음 |
에이전시 | N/A |
앱 별 시간대 | 지원됨. |
앱 별 통화 | 지원됨. |
사이즈 제한 | 해당 사항 없음. |
오가닉 | 예 |
논오가닉 | 예 |
데이터 최신성 | 계속 |
과거 데이터 | 지원 안 됨. 데이터가 누락된 경우에는 Pull API를 사용하여 데이터를 가져오십시오. SKAN의 경우에는 데이터 락커를 통해 기록 데이터를 얻을 수 있습니다(데이터 락커 가용성 기간으로 제한됨). |
계정 소유자/사용자 액세스 |
앱스플라이어 계정 소유자만 푸시 API 설정을 변경할 수 있습니다.
다른 계정 사용자는 Push API 설정을 볼 수는 있지만, 변경할 수 없습니다. |