Singular는 앱 인스톨, 리인게이지먼트, 그리고 인앱 이벤트들에 대한 알림을 귀사의 BI 플랫폼에 실시간으로 전송할 수 있습니다. 이 알림들은 "내부 BI 포스트 백"으로 알려져 있으며, 파트너 컨피규레이션 페이지에서 설정하실 수 있습니다. 포스트 백 옵션 설정에 대한 세부사항을 보시려면, 어트리뷰션 파트너 설정하는 방법 페이지를 참조하세요.
- 포스트 백 옵션 설정에 대한 세부사항을 보시려면, 어트리뷰션 파트너 설정하는 방법 페이지를 참조하세요..
- Facebook, Google, Apple, Snapchat, Twitter, and Yahoo로부터 어떻게 데이터를 매핑하는지 보시려면, 자가 기여 네트워크 : 필드 매핑과 예시의 내부 BI 포스트 백 페이지를 참조하세요.
BI 포스트 백을 설정하기 위해서 무엇을 고려해야 할까요?
귀사의 시스템은 포스트 백을 수신하고 올바르게 자료를 수집할 수 있어야 합니다. 이 계획을 수립하는 과정에 있어 귀사의 테크니컬 팀 멤버와 상의하세요.
주의: Singular로부터 유저 레벨 어트리뷰션을 얻는 다른 방법들도 있습니다.
- 로그를 다운로드합니다. (로그 추출과 유저 레벨 데이터 FAQ를 참조하세요)
- Singular로부터 귀사 시스템으로 유저 레벨 데이터들을 정기적으로 전송하기 위해 데이터 종착지를 설정하세요. (예를 들어, Singular Data Destinations (ETL) FAQ페이지를 참조하세요)
어떻게 내부 BI 포스트 백을 설정할까요?
- Singular 어카운트로 로그인하셔서, Attribution > Partner Configuration, 그리고 Internal BI partner를 선택하세요.
- 컨피규레이션 윈도우에서, 포스트 백 URL을 반드시 작성하세요. (예, https://my_company_name.com/bi/event_endpoint?app=12) 이 포스트 백 URL이 Singular가 POST request를 통해 포스트 백을 전송하는 곳입니다.
- 파트너 포스트 백을 위해 다른 포스트 백 설정도 같은 방식으로 설정하세요. (어트리뷰션 파트너 설정하기를 참조하세요).
몇몇 특정한 네트워크에는 데이터 공유의 제한이 있을 수 있음에 주의하세요.
포스트 백은 어떻게 전송될까요? 만약 문제가 있다면 얼마나 자주 Singular에서 재전송할까요?
- Singular는 HTTP POST 요청과 JSON 형식의 데이터 페이 로드를 만듭니다. (하단의 구조를 참조하세요)
- 만약 Singular가 500 에서 599사이의 HTTPS 응답 코드를 수신한다면, 포스트 백의 전송을 재시도합니다. (최대로 5번까지 재시도합니다)
- 첫 시도로부터 1, 5, 15, 30, 60분을 기준으로 재시도합니다.
- Singular 포스트 백은 CIDR IP 레인지의 198.134.6.0/23로부터 시도되며 이것은 모든 IP 주소 198.134.6.0부터 198.134.7.255까지 모두 커버합니다.
Singular 포스트 백의 구조는 무엇인가요?
Singular는 JSON 형태로 다음 필드들을 전송합니다.
키 | 값 | |
---|---|---|
app_name | 앱에 표시되는 이름입니다. | 문자열 |
longname | 앱의 Long name (bundle ID) | 문자열 |
platform | iOS 또는 Android | 문자열 |
event_name | 이벤트 명입니다. 포스트 백으로 전송된 몇몇 이벤트들은 자동 트래킹 되거나 생성된 이벤트입니다. 이 이벤트들은 인스톨, 세션, 언인스톨, 리인스톨, 그리고 매출 이벤트들을 포함합니다. 자동 트래킹 이벤트를 참조하세요. | 문자열 |
idfa | 디바이스의 해시 되지 않은 iOS 광고 식별자 | 문자열 |
idfv | 벤더의 해시 되지 않은 iOS 식별자 | 문자열 |
aifa | 디바이스의 해시 되지 않은 Android 광고 식별자 | 문자열 |
android_id | 해시 되지 않은 Android ID. aifa가 사용할 수 있지 않을 때만 사용 가능합니다. (android 광고 ID) | 문자열 |
singular_id | 더 이상 지원하지 않는 기능 - LAT이 iOS 디바이스에서 사용되었을 때 사용됩니다. Singular 내부 ID | 문자열 |
event_utc_timestamp | UNIX Timestamp 이벤트 | 숫자 |
click_utc_timestamp | UNIX Timestamp 클릭 | 숫자 |
install_utc_timestamp | UNIX Timestamp 인스톨 | 숫자 |
is_organic | 만약 이벤트가 오가닉이 라면 1, 어트리뷰트 되었다면 0에 해당합니다. | 숫자 |
is_viewthrough | 어트리뷰트 된 이벤트가 뷰스루 컨버전이라면 1, 아니라면 0에 해당합니다. | 숫자 |
network | 사용 가능한 경우, 인스톨이 어트리뷰트 된 네트워크의 이름입니다. | 문자열 |
campaign | 어트리뷰션 트래킹 태그에 명시된 캠페인 명입니다. | 문자열 |
campaign_group | 캠페인 그룹명 (몇몇 자가 어트리뷰션 파트너에게만 사용 가능) | 문자열 |
tracker_campaign_name | 네트워크에 의해 보내진 캠페인 명입니다. 클릭의 PCN에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_campaign_id | 네트워크에 의해 전송된 캠페인 ID입니다. 클릭의 PCID에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_sub_ campaign_name | 네트워크로 인해 전송된 하위 캠페인 명입니다. 클릭의 PSCN에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_sub_ campaign_id |
네트워크로 인해 전송된 하위 캠페인 명입니다. 클릭의 PSCID에 전송된 경우 사용 가능합니다. |
문자열 |
tracker_creative_name | 네트워크로 인해 전송된 캠페인 소재 명입니다. 클릭의 PCRN에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_creative_id | 네트워크로 인해 전송된 캠페인 소재 ID입니다. 클릭의 PCRID에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_publisher_id | 네트워크로 인해 전송된 퍼블리셔 ID입니다. 클릭의 PS에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_publisher_ sub_id | 네트워크로 인해 전송된 퍼블리셔 SUB ID입니다. 클릭의 PSSN에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_publisher_ site_name | 네트워크에 의해 전송된 퍼블리셔 명입니다. 클릭의 PSN에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_publisher_ site_id | 네트워크로 인해 전송된 퍼블리셔 ID입니다. 클릭의 PSID에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_publisher_ sub_site_name | 네트워크에 의해 전송된 하위 퍼블리셔 명입니다. 클릭의 PSSN에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_publisher_ sub_site_id | 네트워크에 의해 전송된 하위 퍼블리셔 명입니다. 클릭의 PSSID에 전송된 경우 사용 가능합니다. | 문자열 |
tracker_name | 어트리뷰션 트래킹 태그에 명시된 캠페인 명입니다. | 문자열 |
partner_campaign | 더 이상 지원하지 않는 기능입니다. tracker_campaign_name 또는 tracker_campaign_id 또는 네트워크에 의해 전송된 이름을 사용합니다. 클릭에서 전송된 경우 사용 가능합니다. | 문자열 |
partner_sub_campaign | 더 이상 지원하지 않는 기능입니다. tracker_sub_campaign_name 또는 tracker_sub_campaign_id 하위 캠페인 또는 네트워크에 의해 전송된 ID를 사용합니다. | 문자열 |
partner_site | 더 이상 지원하지 않는 기능입니다. tracker_publisher_site_name 또는 tracker_publisher_site_id Source site 또는 클릭의 애플리케이션에 사용합니다. 클릭에서 전송된 경우 사용 가능합니다. | 문자열 |
partner_sub_site | 더 이상 지원하지 않는 기능입니다. tracker_publisher_sub_site_name 또는 tracker_publisher_sub_site_id Source sub site 또는 클릭의 애플리케이션에 사용합니다. 클릭에서 전송된 경우 사용 가능합니다. | 문자열 |
creative | 소재 이름 또는 ID. 클릭에서 제공된 경우에만 사용 가능합니다. | 문자열 |
site | 소재 사이트 & 클릭의 하위 사이트입니다. 클릭에서 전송된 경우에만 사용 가능합니다. | 문자열 |
user_id | 커스텀 유저 ID. SDK에 의해 전송된 경우 사용 가능합니다. | 문자열 |
singular_click_id | Singular가 할당한 클릭 ID입니다. | 문자열 |
is_reengagement | 리인게이지먼트로 어트리뷰트 된 경우 '1'을 반환, 아닌 경우 0을 반환합니다. | 숫자 |
click_ip | 광고가 클릭 된 때의 디바이스의 IP입니다. | 문자열 |
os_version | 광고가 클릭 된 때의 해당 디바이스의 OS 버전입니다. | 문자열 |
app_version | 인스톨/이벤트가 일어난 해당 디바이스의 앱 버전입니다. | 숫자 |
country | 인스톨한 유저의 나라입니다. | 문자열 |
city | 인스톨한 유저의 도시입니다. | 문자열 |
limit_ad_tracking | 추적하지 마시오 표시가 활성화되면 '1'을 반환, 아닌 경우 전부 '0'을 반환합니다. | 숫자 |
device_model | 디바이스 모델입니다. | 문자열 |
device_brand | 디바이스 브랜드입니다. | 문자열 |
match_type | 어트리뷰션이 오가닉 (null value), deterministic (디바이스 ID 매칭) 또는 핑거 프린트 메서드 인지 아닌지 표시합니다. | 문자열 |
amount | 매출 이벤트 포스트 백만 측정한 값입니다. 달러와 센트로 계산한 결제 금액입니다. | 숫자 |
currency | 매출 이벤트 포스트 백만 측정한 환율입니다. 세 자리 ISO 4217이 결제를 위한 환율 코드입니다. | 문자열 |
is_first_event | 처음 이벤트가 일어나면 '1'을 반환(매출 또는 커스텀), 그 이후 동일한 디바이스 ID로부터 모든 후속 이벤트들은 '0'을 반환합니다. | 문자열 |
fb_campaign_id | 숫자로 된 Facebook 캠페인 ID로서 Facebook의 서비스 약관에 기반하여 영향받는 제한사항입니다. | 숫자 |
fb_campaign_name | Facebook 캠페인 이름으로서 Facebook의 서비스 약관에 따른 제한이 적용. | 문자열 |
fb_adset_id | 숫자로 된 Facebook의 광고 세트 ID입니다. Facebook의 서비스 약관에 따른 제한이 적용. | 숫자 |
fb_adset_name | Facebook의 광고 설정 명입니다. Facebook의 서비스 약관에 따른 제한이 적용. | 문자열 |
fb_ad_id | 숫자로 된 Facebook 광고 ID입니다. Facebook의 서비스 약관에 따른 제한이 적용. | 숫자 |
fb_ad_name | Facebook 광고 명입니다. Facebook의 서비스 약관에 따른 제한이 적용. | 문자열 |
twitter_campaign_name | Twitter 캠페인 명입니다. Twitter의 서비스 약관에 따른 제한이 적용. | 문자열 |
twitter_campaign_id | Twitter의 영숫자 캠페인 ID입니다. Twitter의 서비스 약관에 따른 제한이 적용. | 문자열 |
twitter_line_id | Twitter의 영숫자 라인 아이템 ID입니다. Twitter의 서비스 약관에 따른 제한이 적용. | 문자열 |
fraud_status | 인스톨의 프러드 결정입니다. 프러드 포스트 백이 활성화된 경우에만 사용 가능합니다. 가능한 값은 "유효"/"의심스러운"/"거절됨"입니다. | 문자열 |
fraud_reason | 프러드 상태를 결정하는 룰들의 이름입니다. (예, 인스톨을 거절한 룰의 이름) 프러드 포스트 백이 활성화 된 경우에만 사용 가능합니다. | 문자열 |