Push API 스트리밍 로데이터

프리미엄

요약: 로데이터 어트리뷰션 이벤트를 서버 측 엔드포인트로 스트리밍합니다.

6970_Push_API_image.png

푸시 API

Push API는 앱스플라이어 어트리뷰션 및 메시지로서의 SKAN(SKAdNetwork) 어트리뷰션으로 생성된 로데이터를 서버로 스트리밍합니다. 메시지 유형 및 콘텐츠를 선택하고 목적지 엔드포인트를 설정할 수 있습니다.

사용 가능한 메시지 유형, 데이터 신선도 및 필드는 다음 섹션에서 설명하는 어트리뷰션 프레임워크(앱스플라이어 또는 SKAN)에 따라 달라집니다. 

앱스플라이어 어트리뷰션 메시지

메시지 특성

특성 상세 내용
메시지 유형 구분
  • 메시지는 엔드포인트로 분리하거나(앱당 최대 6개 엔드포인트) 나열된 다음 필드 값을 검사하여 메시지 유형을 결정할 수 있습니다.
    • event_name
    • conversion_type
    • campaign_type 
  • 메시지 유형별 필드 값은 다음 표에 표시됩니다.

예:

메시지에는 다음 사항이 포함됩니다.

  • conversion_type=install
  • campaign_type=organic
  • event_name=인스톨

표를 사용하여 이 이벤트가 오가닉 사용자의 인스톨 이벤트인지 확인합니다. 

데이터 최신성

앱스플라이어 플랫폼에 이벤트가 기록되는 즉시 메시지가 전송됩니다. 이 과정은 보통 1분 이내입니다. 

메시지 콘텐츠(필드)
  • 메시지는 키:값 구조를 가집니다.
  • 사용 가능한 앱스플라이어 속성 Push API 필드를 참조하십시오.
  • 각 키는 로데이터 필드를 나타냅니다. 앱스플라이어의 로데이터 필드 설명을 참조하십시오. 
  • 공백 또는 null 키는 전송되지 않습니다.
  • 이 예시에는 null 필드와 빈 필드를 모두 포함합니다. 실제 포스트백에는 비어 있지도 않고 null 필드도 없습니다. 제공된 예시는 JSON 형식입니다.
타임 스탬프 필드 형식
  • UTC 타임 스탬프: yyyy-mm-dd hh:mm:ss.sss. 예를 들면, 2019-09-17 00:09:00.123과 같이 표시됩니다. 이벤트가 도쿄 시간 18:00에 이루어졌습니다. UTC로 변환된 시간은 09:00입니다. 기록된 시간은 UTC 시간대입니다. 
  • 선택한 시간대(앱별로 선택) 타임 스탬프: yyyy-mm-dd hh:mm:ss.sss±th:tm. 예를 들면  2019-09-17 18:00:16.000+0900. 이벤트가 도쿄 시간 18:00에 이루어졌습니다. 표시된 이벤트 시간은 18:00+09:00로 기록됩니다. 09:00은 도쿄 시간대입니다. 

사용 가능한 메시지 유형

어트리뷰션 컨텍스트 메시지 유형 conversion_type 필드 campaign_type 필드 event_name 필드 event_type 필드
사용자 획득 인스톨* 인스톨

논오가닉: UA

오가닉: 오가닉

인스톨

  • 인스톨

  • organic-install

유저 획득  install in-app events 인스톨

논오가닉: UA

오가닉: 오가닉

광고주가 정의한 이벤트 이름

  • install-in-app-event

  • organic-install-in-app-event

리타겟팅

리인게이지먼트 리인게이지먼트 리타게팅 리인게이지먼트

리인게이지먼트

리타겟팅  Re-engagement in-app events 리인게이지먼트 리타게팅 광고주가 정의한 이벤트 이름

re-engagement-in-app-event

리타겟팅  Re-attribution  재설치 (Reinstall) 리타게팅 리어트리뷰션

리어트리뷰션

유저 획득  재설치 (Reinstall) 재설치 (Reinstall)

논오가닉: UA

오가닉: 오가닉

재설치 (Reinstall)

  • 재설치 (Reinstall)

  • organic-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 메시지는 동등한 구조 및 필드를 가집니다. 

메시지 특성:

특성 상세 내용
메시지 유형 구분
  • 모든 메시지는 사용자가 설정한 1개의 엔드포인트로 전송됩니다.
  • 메시지 유형을 결정하려면 다음 필드를 사용하십시오.
    • event_name
    • skad_redownload
  • 메시지 유형별 필드 값은 다음 표에 표시됩니다.

예:

메시지에는 다음 사항이 포함됩니다.

  • event_name: 인스톨
  • skad_redownload: true

skad_redownload: true이므로, 이것은 재다운로드 이벤트라고 결정할 수 있습니다. 

데이터 최신성
  • 인스톨, 재다운로드 및 인앱 이벤트:
    • 매일 처리됨
    • 앱스플라이어에서 iOS 포스트백을 받은 다음 날 엔드포인트로 전송됩니다
    • 이벤트 메시지는 05:00–08:00 UTC에 받을 것으로 예상됩니다(정확한 시간은 변동됩니다)
    • 예시: 월요일에 받은 포스트백은 화요일 05:00 UTC부터 시작하여 전송됩니다
  • iOS의 포스트백 및 포스트백 복사본: 메시지는 앱스플라이어에 도착한 후 즉시 전송됩니다
메시지 예시 스프레드시트에는 메시지 예시가 포함되어 있습니다. 제공된 예시는 JSON 형식입니다.  SKAN 예시 메시지.

SKAN 어트리뷰션에 대한 메시지 유형

메시지 유형 

event_name 필드

skad_redownload 필드

event_type 필드

인스톨  인스톨
  • 가질 수 있는 값: false, blank, null. 
  • 필드가 메시지에 없으면 값을 false로 간주합니다. 

skad-installs

재다운로드  인스톨 true

skad-re-downloads

인앱 이벤트 

광고주가 설정한 이벤트 이름

광고주가 설정한 이벤트 이름

skad-in-app-events

iOS의 포스트백

이 메시지에서는 사용할 수 없습니다

이따금 사용 가능합니다

skad-postbacks

포스트백 복사

이 메시지에서는 사용할 수 없습니다

이따금 사용 가능합니다

skad-postbacks-copy


SKAN 어트리뷰션 메시지 유형을 결정합니다.

일러두기: iOS에서 직접 도착하는 포스트백 메시지에는 적용되지 않습니다.

PushAPI-2_en-us.png

Push API 엔드포인트 설정하기

 주의

다음과 같은 이유로 앱스플라이어 어트리뷰트 데이터를 타사에 전송할 때 Push API를 사용하지 마십시오.

  • 사용자가 자신의 데이터를 타사에 보내지 않기로 선택한 경우 CCPA와 같은 프라이버시 규정의 위반으로 될 수 있습니다.
  • 일부 미디어소스는 해당 미디어소스가 제공하는 사용자 수준 데이터의 사용, 제3자 공유 또는 둘 다를 제한합니다. 미디어소스의 사용 약관을 준수하십시오.
    예를 들어 X 광고, 스냅챗, 핀터레스트.

일러두기: 이 주의사항은 SKAN 데이터에는 적용되지 않습니다. Push API를 사용하여 SKAN 데이터를 타사 엔드포인트로 전송합니다.

Push API를 설정하려면 다음 작업 목록을 완료하십시오.

Push API 설정 체크리스트

단계 번호  Appsflyer 어트리뷰션 SKAdNetwork 어트리뷰션 
1

활성 Push API 엔드포인트가 이미 있는 경우 이 단계를 건너뛸 수 있습니다. 

서버 측 필요 사항을 완료하십시오.

2

앱스플라이어 어트리뷰션의 경우 Push API 계획 체크리스트를 사용하여 엔드포인트 설정을 계획합니다.

해당 사항 없음.

3

앱스플라이어 어트리뷰션 엔드포인트 설정하기

SKAdNetwork 어트리뷰션 엔드포인트 설정하기

서버 측 필요 사항 (앱 개발사 서버)

서버가 다음 요구 사항을 준수하는지 확인하십시오. 

서버 측 필요 사항

엔드포인트 URL
  • 유효한 도메인 이름
  • 앱당 최대 고유 엔드포인트 수: 
    • 앱스플라이어: 6개 엔드포인트
    • SKAdNetwork: 3개 엔드포인트
엔드포인트 리턴 코드 엔드포인트는 메시지를 수신하면 반드시 HTTP 200 상태 코드를 반환해야만 합니다.
앱스플라이어 서버 등록

방화벽 및 보안 시스템에 앱스플라이어 서버 IP 주소를 등록하여 엔드포인트와의 통신을 보장합니다.

TLS 버전
포트

포트: 80, 443

메모! 지속 시간이 2초인 시간 제한 메커니즘이 사용됩니다. 이 시간 동안 앱스플라이어가 OK 메시지를 받지 못하면 앱스플라이어는 이를 메시지 전송 실패로 간주합니다. 

앱스플라이어 어트리뷰선에 대한 Push API 계획 체크리스트

  • 이 체크리스트를 사용하여 앱스플라이어 어트리뷰션 엔드포인트 설정을 계획합니다. 그림 속의 숫자는 체크리스트의 행 번호와 같습니다.
  • 이 섹션은 SKAdNetwork 어트리뷰션과 관련이 없습니다. SKAdNetwork 어트리뷰션 설정을 참고하십시오. 

엔드포인트 

PushAPI_us-en.png

엔드포인트 계획 체크리스트

아닙니다.

설정

상세 내용 이 열에 계획한 설정을 기록합니다
1

방법

POST 또는 GET

 

2

엔드포인트 URL

-  
3 이벤트 메시지 유형
  • 적어도 하나의 이벤트 메시지 유형을 선택하십시오.
  • 인앱 이벤트 메시지를 선택하려면, 인앱 이벤트를 기록해야 합니다. 그렇게 할 때까지는 인앱 이벤트 메시지를 선택할 수 없습니다. 

InappSelectionDisabled_us-en.png

 

4

  • 필드 
  • 필드 목록은 모든 메시지 유형에 공통입니다.

 주의

모두 선택으로 표시하면 새로 추가된 필드도 모두 자동으로 선택됩니다. 문제를 방지하기 위해 스키마에 자동으로 추가된 모든 새 필드를 지원할 수 있는지 확인하십시오.

필요한 필드를 선택하십시오.

  • 가장 일반적인 필드는 기본적으로 미리 선택되어 있습니다.
  • 비어 있는 필드/null 필드는 전송하지 않습니다
 
5

인앱 이벤트 유형

 

인앱 이벤트 기준으로 필터링하여 엔드포인트로 전송되는 트래픽을 줄입니다.

  • 하나 또는 여러개, 또는 모든 인앱 이벤트를 선택합니다. 일러두기 만약 이벤트가 목록에 표시되지 않는다면, 검색하십시오. 
  • 만약 모두 선택으로 설정한다면, 새로운 인앱 이벤트는 자동으로 추가됩니다. 
  • 인앱 이벤트는 한 번 이상 기록된 후에만 선택할 수 있습니다. 필요한 경우 S2S를 사용하여 이벤트를 실행하십시오.
  • mceclip1.png
 

앱스플라이어 어트리뷰션 엔드포인트 설정하기

참고: 앱스플라이어 계정 소유자만 푸시 API 설정을 변경할 수 있습니다. 다른 계정 사용자는 설정을 볼 수만 있습니다.

앱스플라이어 어트리뷰션 엔드포인트 추가 방법:
  1. 리포트 > API 액세스 )로 이동 Push API 섹션까지 아래로 스크롤합니다.
  2. 엔드포인트 추가 버튼을 클릭합니다. 
  3. HTTP 메서드를 선택합니다. POST 또는 GET
  4. 엔드포인트 URL을 입력합니다. 이 URL이 안전하지 않음 메시지가 표시되면 앱스플라이어 지원팀에 문의하십시오.
  5. 하나 이상의 이벤트 유형을 선택합니다. 일러두기: 인앱 이벤트 메시지가 비활성화 상태라면 지금까지 인앱 이벤트가 기록되지 않았다는 것입니다. 
  6. 푸시 API 메시지에 포함될 필드를 선택합니다. 참고:
    • 항상 전송되는 필수 필드: App ID, Event name, Event time, IDFA (iOS) 또는 Advertising ID (안드로이드)
    • 다음 그림을 참고하여 옵션 필드를 선택하십시오. 

      PushAPIFieldSelect1.jpg

      • 가장 일반적인 필드는 기본적으로 미리 선택되어 있습니다. 선택은 취소할 수 있습니다.
      • 필요에 따라 옵션 필드를 선택하십시오.
      • 모든 옵션 필드를 삭제하려면 모두 지우기를 클릭하십시오.
      • 비어 있는 필드/null 필드와 이 필드에 연결된 키는 전송하지 않습니다. 가져오기/파싱 절차를 계획할 때, 이 점을 고려하십시오.
  7. 인앱 이벤트를 하나 또는 여러 개(최대 52개 이벤트) 선택하거나, 모두 선택합니다.
    • 목록은 이미 기록된 적이 있는 이벤트 유형들로 이루어져 있습니다. 이벤트가 누락된 경우, 테스트 기기를 사용하여 이 유형의 이벤트를 보내십시오. 
  8. 저장을 클릭합니다.
    Push API가 지금 활성화되었습니다. 전환 데이터가 엔드포인트로 전송됩니다.
  9. 아래 설명된 절차를 통해 엔드포인트를 테스트 합니다.

엔드포인트를 테스트하려면:

  1. 테스트 전송을 클릭합니다.
    테스트 전송 버튼 아래에 테스트 결과 메시지가 표시됩니다. 
    테스트 메시지가 엔드포인트로 전송됩니다. 테스트에 실패하는 경우 앱스플라이어 IP 주소가 등록되었는지 확인하십시오. 
    일러두기! 2초간 지속되는 시간 제한 메커니즘이 사용됩니다. 앱스플라이어가 이 시간 동안 OK 메시지를 받지 못한다면 앱스플라이어는 메시지 전송 실패로 간주합니다. 
  2. 엔드포인트가 테스트 메시지를 수신했는지 검증합니다.
    전송된 메시지 복사본은 다음과 같습니다. 

SKAdNetwork 어트리뷰션 엔드포인트 설정하기

참고: 앱스플라이어 계정 소유자만 푸시 API 설정을 변경할 수 있습니다. 다른 계정 사용자는 설정을 볼 수만 있습니다.

SKAdNetwork Push API 엔드포인트를 추가하는 방법:
  1. 리포트 > API 액세스 )로 이동 Push API 섹션까지 아래로 스크롤합니다.
  2. SKAdNetwork를 어트리뷰트 엔터티로 선택합니다. 
  3. 엔드포인트 추가를 클릭합니다. 
    일러두기
    : 앱당 1-3개의 SKAdNetwork 엔드포인트를 정의할 수 있습니다. 
  4. HTTP 메서드를 선택합니다. POST 또는 GET
  5. 엔드포인트 URL을 입력합니다. 이 URL이 안전하지 않음 메시지가 표시되면 앱스플라이어 지원팀에 문의하십시오.
  6. 비어 있는 필드/null 필드와 이 필드에 연결된 키는 전송하지 않습니다. 가져오기/파싱 절차를 계획할 때, 이 점을 고려하십시오.
  7. 저장을 클릭합니다.
    Push API가 지금 활성화되었습니다. 데이터가 엔드포인트로 전송됩니다. 

추가 절차—엔드포인트 관리

엔드포인트 변경

참고: 앱스플라이어 계정 소유자만 푸시 API 설정을 변경할 수 있습니다. 다른 계정 사용자는 설정을 볼 수만 있습니다.

엔드포인트 설정 수정 방법: 

  1. API 액세스 > 보고서 로 이동합니다.Push API 섹션까지 아래로 스크롤합니다.
  2. 수정할 엔드포인트를 찾습니다.
  3. 수정합니다.
  4. 저장을 클릭합니다.

엔드포인트 삭제

참고: 앱스플라이어 계정 소유자만 푸시 API 설정을 변경할 수 있습니다. 다른 계정 사용자는 설정을 볼 수만 있습니다.

엔드포인트를 삭제하려면:

  1. Report > API Access(API 액세스 보고서)로 이동 Push API access(푸시 API 액세스) 섹션까지 아래로 스크롤합니다.
  2. 엔드포인트 삭제를 클릭합니다.
  3. 저장을 클릭합니다.
    엔드포인트가 삭제되었습니다.

문제 해결, 특성 및 제한 사항

테스트 메시지 실패

테스트 메시지를 받지 못하고 IP 주소별로 서버에 대한 액세스를 제한하는 경우 앱스플라이어 IP 주소를 모두 등록했는지 확인하십시오. 

중복된 리타겟팅 인앱 이벤트

유저 유입(UA) 리인게이지먼트 윈도우 내에, 리타겟팅 캠페인의 영향으로 구매 이벤트가 일어나는 경우, 리타겟팅 인앱 이벤트는 중복 기록됩니다. 이는 UA 미디어 소스와 리타겟팅 미디어 소스 모두에 수익을 어트리뷰션 하기위해 이루어집니다.

아래 둘 다 활성화한 경우에만 중복 이벤트를 얻을 수 있습니다.

  • install in-app events
  • 리타겟팅 인앱 이벤트 

인앱 이벤트 식별 및 중복 제거

 

인앱 이벤트 메시지 선택란이 비활성화 상태입니다.

InappSelectionDisabled_us-en.png

  • 인앱 이벤트 메시지는 최소 하나의 인앱 이벤트가 기록된 후에만 선택할 수 있습니다.
  • 테스트 기기를 사용하여 인앱 이벤트를 생성하거나, S2S API를 사용하여 수동으로 이벤트를 생성하십시오. 

누락된 푸시 메시지와 CloudFront

엔드포인트로 아마존 CloudFront를 사용하고 있습니까? 그렇다면, CloudFront가 거부 코드 421를 가진 메시지를 거부하고 있는지 확인하십시오. 이 경우  CloudFront에서 HTTPS 요청을 처리하는 방법 선택 안내를 참고하십시오.

엔드포인트 오류 메시지

증상: 엔드포인트 URL을 설정할 때 이 URL이 안전하지 않음 메시지가 표시됩니다.

필요한 조치: 앱스플라이어 지원팀에 문의하십시오. 이때 앱 ID, 엔드포인트 URL 및 오류 메시지의 스크린샷을 제공하십시오.

사양 및 제한 사항

사양 참고 
광고 네트워크 해당 없음 
에이전시 N/A
앱 별 시간대 지원됨.
앱 별 통화  지원됨.
사이즈 제한 해당 사항 없음.
오가닉 
논오가닉
데이터 최신성 계속 
과거 데이터 지원 안 됨. 데이터가 누락된 경우에는 Pull API를 사용하여 데이터를 가져오십시오. SKAN의 경우에는 데이터 락커를 통해 기록 데이터를 얻을 수 있습니다(데이터 락커 가용성 기간으로 제한됨). 

계정 소유자/사용자 액세스

앱스플라이어 계정 소유자만 푸시 API 설정을 변경할 수 있습니다.

  • 각 앱스플라이어 계정에는 한 명의 계정 소유자만 있습니다. 이것은 첫 번째 앱스플라이어 사용자입니다(계정이 개설될 때 생성됨) .

다른 계정 사용자는 Push API 설정을 볼 수는 있지만, 변경할 수 없습니다.