Internal BI 포스트 백 : FAQ 및 문제 해결

팔로우
Avatar
Raghu Verma
Updated

싱귤러는 앱 설치, 리인게이지먼트, 인앱 이벤트 및 기타 이벤트에 대한 실시간 알림을 BI 플랫폼으로 전송할 수 있습니다. Internal BI 포스트백(또는 콜백)으로 알려진 이러한 알림은 파트너 구성 페이지를 통해 설정할 수 있습니다.

문제 해결

Internal BI 포스트백을 구성했습니다. 성공적으로 전송되었는지 확인하려면 어떻게 해야 하나요?
#

Singular가 전송한 포스트백의 로그를 확인하려면 다음과 같이 하세요:

  1. Singular에서 어트리뷰션 > Export Logs(로그 내보내기)로 이동하여 관련 날짜 범위와 포스트백 로그 유형을 선택합니다.
  2. 로그에 포함될 필드 목록에서 응답 HTTP 코드와 응답 HTTP 본문을 선택해야 합니다.
  3. 다운로드 파일에서 포스트백이 성공적으로 전송되었는지 확인하고, 그렇지 않은 경우 그 이유를 파악할 수 있는지 확인하세요:
    • 응답 HTTP 코드 필드는 포스트백이 성공적으로 전송되었는지 여부를 알려줍니다. 200 코드는 전송에 성공했음을 의미하며, 그 외의 값은 오류가 있음을 의미합니다. 전송에 오류가 있는 경우 Singular는 1분, 5분, 15분, 30분, 60분 간격으로 포스트백을 5회 더 재시도합니다.
    • 응답 HTTP 본문 필드에는 오류에 대한 추가 세부 정보가 포함될 수 있습니다.

문제가 있는 경우 설정을 확인하고 Singular 지원팀에 문의하세요.

참고: Singular는 플랫폼에서 데이터가 처리되는 방식을 제어하지 않습니다. 로그에 표시되는 데이터는 Singular가 BI에 포스트백으로 전송한 데이터와 동일한 데이터입니다.

FAQ

Internal BI 포스트백을 설정하기 전에 고려해야 할 사항은 무엇인가요?
#

시스템이 포스트백(콜백이라고도 함)을 수신하고 데이터를 올바르게 수집할 수 있어야 합니다. 고객사 개발담당자가 계획에 참여해야 합니다.

참고: 싱귤러에서 사용자 레벨 어트리뷰션 데이터를 가져오는 다른 방법도 있습니다:

내부 BI 포스트백은 어떻게 설정하나요?
#
  1. 싱귤러 계정에 로그인하고 어트리뷰션 > 파트너 구성으로 이동한 후 내부 BI 파트너를 선택합니다.
  2. 구성 창에서 포스트백 URL (예: https://my_company_name.com/bi/event_endpoint?app=12)을 입력하세요 . 이 URL을 입력하면 싱귤러가 POST 요청을 통해 포스트백을 전송합니다.
  3. 다른 포스트백 설정은 파트너 포스트백 설정과 동일한 방식으로 구성합니다( 어트리뷰션 파트너 구성 방법 참조).

일부 네트워크는 데이터 공유에 특별한 제한이 있다는 점에 유의하세요.

포스트백은 어떻게 전송되나요? 문제가 있는 경우 Singular는 얼마나 자주 전송을 다시 시도하나요?
#
  • 싱귤러는 데이터 페이로드를 JSON 형식으로 HTTP POST 요청을 합니다(아래 구조 참조).
  • 500에서 599 사이의 HTTPS 응답 코드를 받으면 Singular는 포스트백 전송을 재시도합니다(최대 5회까지 재시도 가능).
  • 재시도는 최초 전송 시도 후 1분, 5분, 15분, 30분, 60분 후에 시도됩니다.
  • 포스트백이 전송되는 IP 주소의 최신 목록은 포스트백 서버 IP 주소를 참조하세요.
싱귤러 포스트백의 구조는 무엇인가요?

싱귤러 포스트백은 다음 필드가 포함된 JSON 객체로 포스트백을 보냅니다:

Key Value  
app_name Display Name of application string
longname Long name (bundle ID) of application string
platform iOS or Android string
event_name Name of the event. Some events sent in postbacks are auto-tracked or generated events. These events include installs, sessions, uninstalls, reinstalls, and revenue events. See Auto-Tracked Events. string
idfa Unhashed iOS advertising identifier of device string
idfv Unhashed iOS identifier for vendor string
aifa Unhashed Android advertising identifier of device string
android_id Unhashed Android ID. Available only if aifa (android advertising ID) is not available string
singular_id Deprecated - Used when LAT is enabled for iOS devices. Use IDFV. Singular internal ID string
event_utc_timestamp Event UNIX Timestamp number
click_utc_timestamp Click UNIX Timestamp number
install_utc_timestamp Install UNIX Timestamp number
is_organic 1 if event is Organic, 0 if attributed number
is_viewthrough 1 if attributed event is a view-through conversion, 0 otherwise number
network Name of network to which install is attributed, when available string
network_tiktok_restricted For view-through campaigns, subject to restrictions based on TikTok Ads' terms of service string
campaign Campaign name as specified in Attribution Tracking Tags string
campaign_group Campaign Group Name (available for certain Self-Attributing Partners) string
campaign_tiktok_restricted For view-through campaigns, subject to restrictions based on TikTok Ads' terms of service string
tracker_campaign_name Campaign Name as passed by the network. Available if passed in click in the pcn string
tracker_campaign_id Campaign ID as passed by the network. Available if passed in click in the pcid string
tracker_sub_ campaign_name Sub-campaign name as passed by the network. Available if passed in click in the pscn string
tracker_sub_ campaign_id Sub-campaign ID as passed by the network. Available if passed in click in the pscid string
tracker_creative_name Campaign creative name as passed by the network. Available if passed in click in the pcrn string
tracker_creative_id Campaign creative ID as passed by the network. Available if passed in click in the pcrid string
tracker_publisher_id Publisher ID as passed by the network. Available if passed in the click in ps string
tracker_publisher_ sub_id Publisher SUB ID as passed by the network. Available if passed in the click in pssn string
tracker_publisher_ site_name Publisher name as passed by the network. Available if passed in click in the psn string
tracker_publisher_ site_id Publisher ID as passed by the network. Available if passed in click in the psid string
tracker_publisher_ sub_site_name Sub-publisher name as passed by the network. Available if passed in click in the pssn string
tracker_publisher_ sub_site_id Sub-publisher ID as passed by the network. Available if passed in click in the pssid string
tracker_name Campaign name as specified in Attribution Tracking Tags string
partner_campaign Deprecated - Use tracker_campaign_name or tracker_campaign_id Campaign ID or Name as passed by the network. Available if passed in click string
partner_sub_campaign Deprecated - Use tracker_sub_campaign_name or tracker_sub_campaign_id Sub Campaign Name or ID as passed by the network. Available if passed in click string
partner_site Deprecated - Use tracker_publisher_site_name or tracker_publisher_site_id Source site or application for click. Available if passed in click string
partner_sub_site Deprecated - Use tracker_publisher_sub_site_name or tracker_publisher_sub_site_id Source sub site or application for click. Available if passed in click string
creative Creative Name or ID. Available only if provided in click string
site Source site & Sub Site for click. Available if passed in click string
user_id Custom user ID. Available if passed by the SDK string
singular_click_id Singular assigned click ID string
is_reengagement Will return '1' if attributed to a re-engagement campaign, '0' if not number
click_ip IP of the device at the time of the clicked ad string
os_version OS version of the device at the time of the clicked ad string
app_version App version of the device at the time of the install/event number
country Country from which user installed string
city City from which user installed string
limit_ad_tracking Do not track flag is set active will return '1', all other conditions will return '0' number
device_model Device model string
device_brand Device Brand string
match_type Whether the attribution is deterministic (device ID matching), probabilistic (Android only), or none (null value indicates an organic install). string
amount Revenue event postbacks only - The transaction amount in dollars and cents number
currency Revenue event postbacks only - The three-letter ISO 4217 currency code for the transaction string
is_first_event Returns '1' for first occurrence of an event (revenue or custom), '0' for every subsequent event from the same device ID number
fb_campaign_id Numeric Facebook Campaign ID. Subject to restrictions based on Facebook's terms of service number
fb_campaign_name Facebook Campaign name. Subject to restrictions based on Facebook's terms of service string
fb_adset_id Numeric Facebook Ad Set ID. Subject to restrictions based on Facebook's terms of service number
fb_adset_name Facebook Ad Set name. Subject to restrictions based on Facebook's terms of service string
fb_ad_id Numeric Facebook Ad ID. Subject to restrictions based on Facebook's terms of service number
fb_ad_name Facebook Ad name. Subject to restrictions based on Facebook's terms of service string
twitter_campaign_name Twitter Campaign Name. Subject to restrictions based on Twitter's terms of service string
twitter_campaign_id Twitter alphanumeric Campaign ID. Subject to restrictions based on Twitter's terms of service string
twitter_line_id Twitter alphanumeric Line Item ID. Subject to restrictions based on Twitter's terms of service string
fraud_status Fraud decision for installation. Available only when fraud postbacks are enabled. Possible values are "valid"/"suspicious"/"rejected" string
fraud_reason Name of rule that decided the fraud status (for example, the name of the rule that rejected the install). Available only when fraud postbacks are enabled. string
다양한 수익 이벤트(__IAP__, __REVENUE__, __ADMON_ USER_LEVEL_REVENUE__)란 무엇인가요? 어떤 이벤트에 대해 포스트백을 구성해야 하나요?
#

인앱(SDK) 이벤트 드롭다운에는 여러 가지 수익 관련 이벤트가 표시되며, 이 중 일부는 중복되는 이벤트도 있습니다.

동일한 인앱 이벤트에 대해 중복 포스트백이 전송되는 것을 방지하려면 아래 지침을 따르세요.

수익 이벤트 이름
 설명

__IAP__

 An event triggered by any in-app purchases that have not been given a custom name in the SDK/S2S implementation.

(Custom revenue events)

 In-app purchase events that have been given custom names in the SDK/S2S implementation also appear in the list.
__ADMON_ USER_LEVEL_REVENUE__ An event triggered by revenue gained from ad monetization (if you have set up ad revenue attribution using the method of sending SDK events).
__REVENUE__

An event triggered by any revenue coming into the app (including __IAP__, purchase events with custom names, and ad revenue events). See warning below.

인앱 구매 수익만 있는 경우 수행해야 할 작업입니다:

  • IAP__ 및 모든 사용자 지정 구매 이벤트에 대한 매핑을 설정합니다.
  • 또는 모든 인앱 구매 이벤트를 포괄하는 __REVENUE__를 사용하세요.

인앱 구매 수익(Revenue)과 광고 수익(Ad Revenue)가 모두 있는 경우 어떻게 해야 하나요?

  • IAP__, 모든 사용자 지정 구매 이벤트 및 __ADMON_USER_LEVEL_REVENUE__에 대한 매핑을 설정합니다.
  • 이 경우 일반 이벤트 __REVENUE__에는 구매 및 광고 수익 이벤트가 모두 포함되며, 두 가지 유형의 수익을 네트워크 측의 동일한 수익 이벤트에 매핑하면 문제가 발생할 수 있으므로 사용하지 않는 것이 좋습니다.
  • 대신 인앱 구매 이벤트는 네트워크의 구매 이벤트에, __ADMON_USER_LEVEL_REVENUE__ 이벤트는 네트워크의 애드몬 또는 광고 수익 이벤트에 매핑하세요.
  • 네트워크 측에서 어떤 이벤트를 사용해야 할지 잘 모르겠다면 네트워크에 문의하여 자세한 내용을 확인하세요.

경고: 파트너에 대한 기존 구성이 __REVENUE__ 포스트백을 전송하고 있는데 인앱 구매 이벤트 외에 광고 수익 이벤트를 추가하기 시작한 경우, 파트너 네트워크가 광고 수익 이벤트를 수신하도록 설정되어 있지 않거나 별도의 이벤트에 매핑해야 하는 경우 문제가 발생할 수 있습니다. 광고 수익 포스트백을 보내야 하는지 여부와 방법은 해당 네트워크에 문의하세요.