어떻게 도와드릴까요?

검색

비용 데이터를 측정하기 위한 ROI360 비용 API 설정

  • 업데이트 시간

한눈에 보기: 앱 또는 미디어 소스 계정 수준에서 비용 API를 사용해 집계된 마케팅 비용 데이터(비용 관련 LTV 지표 포함)를 확인하세요.

개요

ROI360은 앱 및 계정 수준 모두에서 비용 측정을 제공하므로, 이해관계자는 개별 애플리케이션별 또는 전체 미디어 소스 계정 전반에 걸쳐 지출을 세부적으로 분석할 수 있습니다.

비용 연동은 미디어 소스에 따라 두 가지 서로 다른 위치에서 관리됩니다.

  • 계정 수준 연동은 비용 설정에서 관리됩니다. 이 연동은 광고 계정 수준에서 구성됩니다. 지원되는 광고 네트워크 목록을 참조하세요.
  • 앱 수준 연동은 비용 탭에서 관리됩니다. 이러한 연동은 각 앱별로 개별 설정됩니다. 비용 설정에서 미디어 소스를 사용할 수 없는 경우 앱 수준의 비용 탭에서 비용 연동을 구성하세요.

참고

비용 설정에 대한 액세스는 역할 권한에 의해 제어됩니다. 비용 설정을 열 수 없는 경우, 관리자에게 사용자 관리 페이지에서 본인의 역할 권한을 업데이트해 달라고 요청하십시오. 관련 기능은비용 연결입니다.

비용 API 활성화: 

비용 연동을 활성화하는 방법은 앱 수준과 계정 수준의 두 가지가 있습니다.

앱 수준에서 비용 연동 활성화 (비용 탭)

개별 앱에 대해 특정 미디어 소스와 전용 비용 연동을 설정하려면 다음 단계를 따르세요.

  1. 앱스플라이어의 사이드 메뉴에서 협업 > 활성 연동을 선택한 후, 파트너를 선택하십시오.
  2. 연동 관리를 클릭합니다.
  3. 연동 파트너 비용 탭을 엽니다.
  4. 비용 데이터 가져오기를 켭니다. 파트너와 연결하기 위한 요구 사항이 표시됩니다.
  5. 파트너와의 연동을 구성하고 인증합니다. 인증 방법은 미디어 소스에 따라 다릅니다. 아래에서 비용 연동 방법을 참조하세요.
  6. 파트너의 비용 구성에 사이트 ID 매핑 항목이 있는 경우, 드롭다운에서 필요한 사이트 ID 구성을 선택하십시오. 아래에서 사이트 ID 매핑을 참조하십시오.
  7. 비용 저장을 클릭합니다.
    • 비용 데이터는 5-6시간 이내에 대시보드에 표시되기 시작합니다.
    • 앱스플라이어는 파트너로부터 하루 평균 6회, 4시간마다 한 번씩 데이터를 수집합니다.
    • 비용 설정 섹션의 미디어 소스 계정은 앱 수준의 비용 탭에서 수행한 작업에 따라 업데이트됩니다.

계정 수준에서 비용 연동 활성화 (비용 설정)

앱스플라이어 계정 내의 여러 앱 또는 모든 앱에 대한 비용을 활성화하려면, 각 미디어 소스 계정을 한 번만 연동하면 됩니다.

계정 수준에서 비용 연동을 활성화하려면 다음 단계를 따르세요.

  1. 앱스플라이어의 사이드 메뉴에서 설정 > ROI360 > 비용 설정을 엽니다.
  2. 비용 데이터를 검색할 미디어 소스를 선택한 후 다음을 클릭합니다.
  3. 미디어 소스에 대한 비용 연동을 구성하고 인증하세요. 인증 방법은 미디어 소스에 따라 다릅니다. 아래의 비용 연동 방법을 참조하세요.
  4. 비용 연동 이름을 입력(또는 사용자 정의)합니다.
  5. 이 비용 연동에 포함할 앱을 선택합니다.
  6. 연동 저장을 클릭합니다.
    • 비용 데이터는 5-6시간 이내에 대시보드에 표시되기 시작합니다.
    • 앱스플라이어는 미디어 소스로부터 하루 평균 6회, 4시간마다 한 번씩 데이터를 수집합니다.
    • 비용 설정에서 계정 수준에서 반영된 업데이트 사항은 관련 앱 및 미디어 소스의 활성 연동 내 비용 탭에 자동으로 적용됩니다.

참고

광고주가 대행사를 통해 캠페인을 집행하는 경우, 광고주가 아닌 대행사가 직접 관련 파트너와 연동을 진행하는 것을 권장합니다. 그렇지 않고 광고주와 대행사가 동일한 앱에 대해 동일한 자격 증명을 사용하여 미디어 소스와 연동할 경우, 비용 데이터가 중복 발생합니다.

비용 연동 방법

비용 연동을 활성화하는 방식은 해당 미디어 소스가 앱스플라이어와 연동된 모드에 따라 달라집니다. 다음 중 하나일 수 있습니다.

  • 로그인: <미디어 소스>에 로그인을 클릭하여 미디어 소스 로그인 창을 엽니다. 그런 다음 미디어 소스의 로그인 안내를 따르세요.
  • 자격 증명: 미디어 소스별 매개변수 값을 입력합니다. 예: API 키.
  • 없음: 위의 지침에 따라 비용 데이터 가져오기를 켜는 것 외에는 연결 구성이 필요하지 않습니다.

특정 미디어 소스가 사용하는 방법을 알아보려면 연동 방법 열을 미디어 소스 비용 연동 표에서 확인할 수 있습니다.

사이트 ID 매핑

일부 미디어 소스 연동은 비용 데이터를 보고할 때 사이트 ID 필드가 채워지는 방식을 선택할 수 있습니다. 이를 통해 앱스플라이어 어트리뷰션 링크 site-id 매크로가 미디어 소스에서 기대하는 값과 정확히 일치하도록 보장합니다.

  • 기본적으로 사이트 ID 매핑은 어트리뷰션 링크의 앱스플라이어 매크로와 정렬됩니다.
  • 어트리뷰션 링크에서 사이트 ID 매핑 옵션과 다른 매크로를 사용할 경우 사이트 ID 데이터가 정상적으로 집계되지 않습니다.

앱 수준에서 사이트 ID 매핑을 설정하려면 다음 단계를 따르세요:

  1. 연동 파트너 비용 탭에서 사이트 ID 매핑으로 이동하고 드롭다운 메뉴에서 구성을 선택합니다.
  2. 비용 저장을 클릭합니다. 변경 사항은 다음 날(UTC)부터 적용됩니다.

비용 연동 삭제

앱 또는 계정 수준에서 비용 연동을 삭제할 수 있습니다. 삭제된 후에는 앱스플라이어가 해당 계정에서 비용 데이터를 더 이상 가져올 수 없습니다. 연동을 삭제해도 이전 데이터에는 영향이 없습니다.

앱 수준(비용 탭)에서 비용 연동을 삭제하십시오.

언제든지 연동을 삭제할 수 있습니다.

앱 수준에서 비용 연동을 삭제하려면 다음 단계를 따르세요.

  1. 앱스플라이어의 사이드 메뉴에서 협업 > 활성 연동으로 이동합니다.
  2. 연동 파트너(예: Meta Ads)를 선택합니다.
  3. 연동 관리를 클릭합니다.
  4. 비용 탭을 엽니다. 연결된 계정 목록이 표시됩니다.
  5. 작업 열에서 삭제를 원하는 계정에 마우스 커서를 이동하고 연결 삭제를 클릭합니다.
  6. 확인 프롬프트에 응답하여 예, 삭제합니다를 클릭합니다.

이전에 앱 수준에서 설정된 비용 연동이 앱 및 계정 수준 모두에서 제거되었습니다. 그 결과, 비용 데이터 수집이 즉시 중단됩니다. 이 변경 사항은 이미 수집된 모든 역사적 비용 데이터에 영향을 미치지 않습니다.

계정 수준에서(비용 설정) 비용 연동을 삭제하세요

계정 수준에서 비용 연동을 삭제하려면 다음 단계를 따르세요:

  1. 앱스플라이어 사이드 메뉴에서 설정 > ROI360 > 비용 설정을 선택하고 연동을 삭제할 미디어 소스를 선택합니다.
  2. 미디어 소스의 연동 목록에서 연동 레코드를 클릭합니다.
  3. 확인 프롬프트에 응답하여 예, 삭제합니다를 클릭합니다.

이전에 계정 수준에서 설정된 비용 연동이 앱 및 계정 수준 모두에서 제거되었습니다. 그 결과, 비용 데이터 수집이 즉시 중단됩니다. 이 변경 사항은 이미 수집된 모든 역사적 비용 데이터에 영향을 미치지 않습니다.

비용 API 비활성화 하기

비용 API 비활성화는 앱 수준에서만 가능합니다.

비용 API를 끄려면 다음 단계를 따르세요:

  1. 활성 연동으로 이동하여 미디어 소스를 선택합니다.
  2. 비용 탭으로 이동합니다.
  3. 비용 데이터 가져오기를 끕니다.
  4. 비용 저장을 클릭합니다.

참고

광고주가 대행사와의 협업을 중단하고 앱 수준에서 대행사 권한을 비활성화하더라도, 대행사 측에 해당 앱의 비용 연동이 설정되어 있다면 비용 데이터는 계속 수집됩니다. 이 데이터 수집을 중단하려면 광고주가 대행사에 비용 연동을 비활성화해 달라고 요청해야 합니다.

비용 API 상태

비용 연동의 운영 상태는 다음과 같습니다:

  • 비용 및 광고 수익 연동 상태 대시보드: 계정 내 하나 이상의 앱에 대해 비용 연동이 활성화된 미디어 소스의 중앙 집중식 목록입니다.
  • 연동 파트너: 개별 앱의 컨텍스트에서 사용할 수 있는 상태입니다.
  • 비용 설정: 비용 설정 페이지에서는 계정 및 앱 수준 모두에서 비용 API 상태를 볼 수 있습니다. 자세한 내용은 아래의 파트너 비용 집계 연동 현황 보기를 참조하세요.

미디어 소스 비용 연동 현황 보기(비용 탭)

미디어 소스 비용 탭의 활성 연동 페이지(비용 데이터를 API를 통해 가져오는 미디어 소스에 해당)에는 다음이 표시됩니다.

  • 선택한 앱의 비용 연동 상태입니다.
  • 지난번 앱스플라이어가 해당 앱의 매칭되는 비용 데이터를 성공적으로 수집했습니다.

선택한 앱의 개별 미디어 소스 비용 연동 현황을 확인하려면 다음 단계를 수행하세요.

  1. 앱스플라이어의 사이드 메뉴에서 협업 > 활성 연동으로 이동합니다.
  2. 미디어 소스를 선택합니다.
  3. 미디어 소스 활성 연동 페이지에서 탭 바 위의 앱 목록에서 비용 상태를 보려는 앱을 선택합니다.
  4. 비용 탭을 클릭합니다. 상태와 마지막 동기화 시간이 표시됩니다.

미디어 소스 집계 비용 연동 상태 보기(비용 설정)

미디어 소스 집계 비용 연동 상태를 보려면 다음 단계를 따르세요.

  1. 앱스플라이어 사이드 메뉴에서 설정 > ROI360 > 비용 설정을 선택합니다.
  2. 관련 미디어 소스를 선택합니다.
  3. 미디어 소스 페이지에서 상태 열에서 미디어 소스 계정 상태를 확인할 수 있습니다. 계정과 연결된 모든 앱의 상태가 동일한 경우 해당 상태가 표시됩니다. 앱 상태가 다르면 상태가 혼합 상태로 표시됩니다.
  4. 미디어 소스 계정과 연결된 특정 앱의 상태를 확인하려면, 미디어 소스 계정 행을 클릭하여 비용 연동 페이지를 표시하세요.
  5. 미디어 소스와 연결된 앱 목록에서 앱 상태를 확인합니다.

상태 테이블

상태 비고/필요한 조치
활성화됨 연동이 활성화되었으며 미디어 소스에 성공적으로 연결되었습니다.
API가 일치하는 비용 데이터를 반환하지 않음 이런 일이 발생할 수 있는 이유는 다음과 같습니다.
• 캠페인 ID가 제공되지 않아 비용을 캠페인과 매칭할 수 없습니다.

• 앱스플라이어를 통해 파트너에 로그인할 때 다른 파트너 광고 계정을 연동함(예: 다른 Meta 광고 계정). 올바른 파트너 광고 계정을 연결했는지 확인하세요.

• 파트너 비용 연동의 자격 증명 필드 중 하나가 올바르지 않습니다. 예를 들어 번들 ID입니다. 연동 자격 증명을 검토하고 수정하세요.

• 캠페인이 일시 중지되어 데이터가 없습니다.
파트너 API가 응답하지 않습니다. • 연동된 파트너의 서버가 앱스플라이어에 응답하지 않고 있습니다.
• 6시간 동안 기다리세요. 상태 메시지가 계속 표시되면 앱스플라이어 지원팀에 문의하세요.
잘못된 자격 증명 • 자격 증명이 유효하지 않아 앱스플라이어가 API를 통해 데이터를 가져올 수 없습니다.
• 올바른 자격 증명을 사용하여 다시 연결하세요.
리포팅된 API에 액세스하려면 광고 네트워크 계정 관리자로 이동하세요. 파트너 계정 관리자와 협력하여 파트너 시스템에서 비용 연동을 사용하도록 설정합니다.
파트너 API가 데이터를 반환하지 않습니다. 연동을 검토하세요. 이는 다음과 같은 이유로 발생합니다.
• 캠페인이 일시 중지되어 데이터가 없습니다.
비용 데이터를 가져오기 위한 계정이 파트너 시스템에서 활성화되어 있지 않습니다. 파트너에게 연락하세요.
혼합 상태 상태는 연결된 앱의 상태가 다른 경우에만 비용 설정 > 미디어 소스 페이지에 표시됩니다. 미디어 소스 페이지에서 연동 페이지를 열어 개별 앱의 상태를 확인합니다. 이 상태는 상태 대시보드에 표시되지 않습니다.

계정 수준 비용 설정을 지원하는 미디어 소스

ROI360 고객은 비용 설정 및 비용 탭의 계정 수준에서 비용 연동을 생성하고 수정할 수 있습니다. 다음 미디어 소스는 계정 수준 비용 설정을 지원합니다.

지원되는 미디어 소스

표시 이름 연동 ID
AdAction3 adaction5_int
Adbloom adbloom_int
AdColony adcolony_int
AdGate Media adgatemedia_int
adjoe GmbH adjoe_int
Adikteev Retargeting trademob_int
Apple Search Ads iossearchads_int
AppLift applift_int
AppLovin applovin_int
Aura aura_int
Blind Ferret Agency blindferret_int
Bluestacks bluestacks_int
ByteDance bytedance_int
Chartboost chartboost_int
Dataseat dataseat_int
Digital Turbine Legacy appia_int
Digital Turbine On Device digitalturbine_int
Domob domobc_int
DV360 시리즈 dv360_int
GlobalWide Media globalwide_int
Google Ads googleadwords_int
InMobi inmobi_int
InMobi DSP inmobidsp_int
Liftoff Influence jetfuelit_int
Mediaforce mediaforce_int
Meta ads facebook
Mintegral mintegral_int
Mobupps mobupps_int
Moloco moloco_int
MoPub Acquire crossinstall_int
Opera Mobile operaevent_int
Persona.ly RTB personalyrtb_int
Pinterest pinterest_int
Pinsight pinsight_int
Point2Web point2web_int
Reddit reddit_int
Smadex smadex_int
Snapchat snapchat_int
Tapjoy tapjoy_int
Taptica taptica_int
TikTok tiktokglobal_int
TUNE hasoffers_int
Unity Ads unityads_int
X (Twitter) twitter

참고

InCost 광고 네트워크를 통해 추가 미디어 소스를 사용할 수 있습니다. 지원되는 InCost 광고 네트워크의 전체 목록을 확인하시려면 담당 CSM에게 문의하세요.

특징 및 제한 사항

특징 비고
에이전시 에이전시는 비용 설정을 사용하여 여러 앱에서 동시에 비용 연동을 수행할 수 없습니다.
미래 앱 자동으로 계정 수준 비용 설정 기능 상속 현재 지원되지 않음
광고주와 에이전시가 동일한 광고 네트워크에 연결될 때 비용 데이터 동작
동일한 광고 네트워크 계정(예: Google Ads)에 대해 광고주와 대행사가 모두 비용 연동을 연결한 경우, 기여를 받는 계정에서 비용 데이터를 가져옵니다.

예제 시나리오:
  • 광고주는 광고주 자격 증명을 사용하여 비용 연동에 연결합니다.
  • 에이전시는 에이전시 자격 증명을 사용하여 비용 연동에 연결합니다.
  • 에이전시 계정에 어트리뷰션이 할당되었습니다.

결과:

  • ROI360은 대행사 연결에서 비용 데이터를 가져옵니다.
  • 광고주 연결은 데이터 없음으로 표시됩니다.
Google 비용 연동 자동 연결 해제 365일 이상 연속으로 데이터 없음 또는 유효하지 않은 자격 증명 상태를 보이는 비용 연동은 자동으로 연결이 해제됩니다. Google 연동에만 적용됩니다.
TikTok 광고주 ID 목록 설정

광고 네트워크의 틱톡 사용자에게 연결된 광고주 ID만 사용하여 계정 수준에서 광고주 ID 목록을 구성하십시오.

광고 네트워크의 사용자 계정과 일치하지 않는 광고주 ID를 목록에 추가할 경우 비용 데이터가 반환되지 않습니다.

Tags