내부 BI 포스트 백 FAQ

Singular는 앱 인스톨, 리인게이지먼트, 그리고 인앱 이벤트들에 대한 알림을 귀사의 BI 플랫폼에 실시간으로 전송할 수 있습니다. 이 알림들은 "내부 BI 포스트 백"으로 알려져 있으며, 파트너 컨피규레이션 페이지에서 설정하실 수 있습니다. 포스트 백 옵션 설정에 대한 세부사항을 보시려면, 어트리뷰션 파트너 설정하는 방법 페이지를 참조하세요.  

 

BI 포스트 백을 설정하기 위해서 무엇을 고려해야 할까요?

귀사의 시스템은 포스트 백을 수신하고 올바르게 자료를 수집할 수 있어야 합니다. 이 계획을 수립하는 과정에 있어 귀사의 테크니컬 팀 멤버와 상의하세요. 

주의: Singular로부터 유저 레벨 어트리뷰션을 얻는 다른 방법들도 있습니다.

어떻게 내부 BI 포스트 백을 설정할까요?

  1. Singular 어카운트로 로그인하셔서, Attribution > Partner Configuration, 그리고 Internal BI partner를 선택하세요.
  2. 컨피규레이션 윈도우에서, 포스트 백 URL을 반드시 작성하세요. (예, https://my_company_name.com/bi/event_endpoint?app=12) 이 포스트 백 URL이 Singular가 POST request를 통해 포스트 백을 전송하는 곳입니다. 
  3. 파트너 포스트 백을 위해 다른 포스트 백 설정도 같은 방식으로 설정하세요. (어트리뷰션 파트너 설정하기를 참조하세요).

몇몇 특정한 네트워크에는 데이터 공유의 제한이 있을 수 있음에 주의하세요.

포스트 백은 어떻게 전송될까요? 만약 문제가 있다면 얼마나 자주 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 프러드 상태를 결정하는 룰들의 이름입니다. (예, 인스톨을 거절한 룰의 이름) 프러드 포스트 백이 활성화 된 경우에만 사용 가능합니다. 문자열