How can we help?

검색

애드 네트워크용 InCost API

  • 업데이트 시간

한눈에 보기: 앱스플라이어 ROI360의 일부인 InCost API를 사용하면 애드 네트워크가 프로그래밍 방식으로 광고 비용 데이터를 앱스플라이어로 전송할 수 있습니다. 그러면 광고주에게 종합적인 비용 데이터가 제공되어 광고주가 네트워크의 실제 영향력을 파악할 수 있습니다.

InCost API 소개

InCost API는 애드 네트워크가 앱스플라이어에 비용 데이터를 전송할 수 있는 최적의 솔루션입니다. 애드 네트워크 파트너는 이 API를 사용하여 앱스플라이어에 자세한 광고 비용 데이터를 전송합니다. 앱스플라이어는 데이터를 수집하고 처리하여 대시보드와 리포트를 통해 광고주와 파트너에게 제공합니다.

장점

  • 원활한 비용 리포팅을 통해 고객이 네트워크의 실제 영향을 이해하는 데 도움이 됩니다. 비용 데이터가 없으면 고객은 측정 문제에서 중요한 사항을 놓치게 되고 ROAS를 정확하게 측정할 수 없습니다. 따라서 다른 미디어소스에 잘못 투자하여 수익에 부정적인 영향을 미칠 수 있습니다.
  • 정확하고 완벽한 실시간 비용 측정을 보장하는 솔루션으로 ROI를 입증하세요.
  • InCost API는 빠르고 간단하게 배포할 수 있으며, 그 영향은 거의 즉각적입니다. 또한 최대 90일 전의 비용 데이터를 전송할 수 있는 기능을 포함하여 데이터를 전송하는 방법과 시기를 완벽하게 제어할 수 있습니다.
  • InCost API는 (클릭당 비용 전송 시 사용할 수 있는 유일한 모델인) CPI뿐만 아니라 모든 캠페인 과금 정책 모델을 지원합니다.
  • 앱스플라이어 파트너 마켓플레이스에서 귀사가 지원하는 기능임을 나타내는 "비용" 배지로 이목을 끌어 보세요.

InCost API 구현

선행 조건: InCost API 자격을 갖추려면 애드 네트워크에 다음이 필요합니다.

  • 캠페인의 90%가 어트리뷰션에 캠페인 ID를 포함해야 합니다.
  • 데이터의 최신성을 높이기 위해 하루에 6회 이상 데이터를 전송할 수 있어야 합니다. 구체적인 횟수는 애드 네트워크에 따라 다릅니다.
  • [애드 네트워크가 데이터를 소급하여 업데이트하는 경우] 데이터 완성도를 높이기 위해 매번 지난 7일 동안의 데이터를 전송할 수 있어야 합니다.

InCost API를 구현하고 앱스플라이어에 비용 데이터를 전송하기 시작합니다.

  • 다음 표의 단계를 따르세요.
단계 번호 작업 
1

InCost를 신청합니다.

  1. 앱스플라이어의 상단 메뉴에서 도움말 > 팀에 문의를 선택합니다.
    파트너 도우미 위젯이 열립니다.
  2. 비용 측정 활성화를 선택하고 정보를 제출합니다.
    티켓을 제출하면 티켓이 열리고 앱스플라이어 파트너 솔루션 엔지니어가 연락을 드릴 것입니다.
2 트래픽의 90% 이상에 대한 어트리뷰션 링크에 캠페인 계층 구조(캠페인 ID와 선택 사항으로서 광고 세트 ID 및 광고 ID)가 포함되어 있는지 확인하세요.
3

앱스플라이어 대시보드에서 앱스플라이어 API 토큰을 받습니다.
4

개발자에게 API 권한 부여 헤더에 사용할 API 토큰을 제공하고 개발자의 지침에 따라 3가지 API 메서드를 구현하도록 요청합니다.

  1. 앱 목록을 가져옵니다.
  2. InCost 업로드: 개발자에게 어떤 필드로 JSON을 채울지 알려줍니다.
    • 필수 필드는 반드시 입력해야 합니다. 즉, 빈 필드를 보내지 마세요. 
    • 미디어소스는 애드 네트워크 계정과 연결된(해당 계정하에 등록된) 미디어소스로 제한됩니다. 파트너 개발 관리자로부터 목록을 받습니다.
    • 앱 시간대(앱 권한 목록 가져오기 API를 통해 리포팅된 대로)를 고려하여 비용 데이터 날짜를 앱의 시간대에 맞춰 조정합니다.
    • 캠페인 비용 리포팅 계층 구조에 포함되지 않은 필드가 있는 경우 해당 필드는 포함하지 마세요. 예: 광고 세트 ID, 애셋 이름, 광고 ID, 광고 이름.
  3. 작업 상태를 가져옵니다.
6

(1단계의) 티켓 스레드에서 앱스플라이어에 API 구현이 완료되었음을 알리고 연동이 작동하는지 확인할 때까지 기다립니다.
7

광고주가 앱스플라이어 연동 파트너 페이지의 비용 탭에서 비용 데이터 가져오기를 활성화했는지 확인합니다. 그러면 비용 데이터를 받기 시작합니다.

InCost 업로드 JSON 필드

필드

필수적

설명

날짜

예
  • 지출 날짜
  • 형식: YYYY-MM-DD
  • 예시:2019-12-30
app_id

예
  • 앱스플라이어 플랫폼에 표시되는 앱 ID
  • 형식: 최대 250자의 문자열
  • 예시: 안드로이드:com.app.name, iOS: id123456789

media_source

예
  • 앱스플라이어에서 애드 네트워크 파트너 계정과 연결된 광고를 표시하는 네트워크 이름(ID)
  • 형식: 50자의 문자열
  • 예시: network_int

af_prt

번호*
  • 에이전시 어트리뷰션 및 비용 데이터에 필요합니다.
  • 어트리뷰션 링크에 표시되고 앱스플라이어의 에이전시 계정과 연결되는 에이전시 이름입니다.
  • 형식: 50자의 문자열
  • 예시: agencya

campaign_id

예
  • 어트리뷰션 링크를 통해 전송된 af_c_id 파라미터와 동일해야 합니다.
  • 빈 문자열은 허용되지 않습니다.
  • 형식: 24자의 문자열
  • 예시: 123abc

campaign_name

예
  • 형식: 100자의 문자열
  • 예시: my_campaign123

adset_id

 번호*
  • adset_name을 보내는 경우 필수
  • 어트리뷰션 링크를 통해 전송된 af_adset_id 파라미터와 동일해야 합니다.
  • 비용 리포팅이 adset_id를 지원하지 않는 경우 절대로 보내지 마세요.
  • 형식: 24자의 문자열
  • 예시: 123A

adset_name

아니오
  • 이 필드를 전송하는 경우 adset_id도 함께 보내야 합니다.
  • 형식: 100자의 문자열
  • 예시:my_adset_name

ad_id

번호*
  • ad_name을 보내는 경우 필수입니다.
  • 이 필드는 어트리뷰션 링크를 통해 전송된 af_ad_id 파라미터와 동일해야 합니다.
  • 비용 리포팅이 adset_id를 지원하지 않는 경우 절대로 보내지 마세요.
  • 형식: 24자의 문자열
  • 예:123AB

site_id

아니오
  • 광고를 표시하는 퍼블리셔를 식별하는 고유 ID.
  • 형식: 24자의 문자열.

ad_name

아니오
  • 이 필드를 전송하는 경우 ad_id도 함께 보내야 합니다.
  • 형식: 100자의 문자열
  • 예:Ad-name

지역

아니오
  • 비용과 관련된 것으로 기록한 국가
  • 가능한 경우 광고가 게재된 국가를 표시해야 합니다.
  • 형식: ISO 3166 2자 국가 코드
  • 예시:US, CN, ZA
currency

예
  • 지출 통화 유형
  • 형식: ISO 4217 3자 통화 코드
  • 예시: USD, EUR, ZAR
지출 예
  • 지정된 통화를 사용한 지출 금액 
  • 소수점 뒤에 5자리 숫자 허용
  • 값 0(영)이 허용됩니다
  • 음수의 값이 허용되지 않습니다.
  • , 구분 기호를 보내지 마세요.
  • 값을 따옴표로 묶어 보내지 마세요. 
  • 형식: 십진수
  • 예시 값: 1 1.2 1234.20
채널 아니오
  • 어트리뷰션 링크를 통해 전송된 af_channel 파라미터와 동일해야 합니다.
  • 형식: 20자의 문자열
  • 예:my_channel
키워드 아니오
  • 형식: 100자의 문자열
  • 예:abc app

* 경우에 따라 이 필드를 보내야 하는 경우도 있으므로 비고란을 참조하세요.

관련 대상

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.

Share article: