연동 파트너 설정 가이드

보고 있는 파트너 설정 탭과 관계 없이, 파트너 헤더는 항상 페이지의 맨 위에 표시됩니다. 이를 통해 다음 작업을 수행할 수 있습니다.

1. 올바른 파트너의 설정 페이지인지 확인
2. 앱스플라이어에 파트너 담당자와의 연락 요청
3. 특정 파트너의 설정 지시 사항에 대해 확인합니다. (특별 안내가 있는 경우)

    

파트너 탭 하단 문구

 

파트너 탭 하단 문구는 항상 파트너 설정 창의 바닥에 있습니다. 이 탭에서는 다음 작업을 수행할 수 있습니다.

1. 목록으로 돌아가기 - 바로 직전 설정한 필터링이 적용된 연동 파트너 목록 으로 돌아갑니다.
2. 상태 메시지 - 탭 데이터의 현재 상태 (예: 저장 중, 저장 완료, 오류, 저장되지 않은 변경 사항이 있음)
3. Discard Changes - 저장하지 않고 마지막 변경 사항을 취소합니다.
4. 저장 - 오직 현재 탭만의 마지막 설정 변경을 저장합니다.

연동 탭은 여러 섹션으로 나뉘어져 있습니다. 파트너 연동은 파트너의 요구 사항에 따라 다르며, 일반적으로 아래 설명된 모든 섹션 중 일부가 포함됩니다.

일반 설정

이 섹션은 앱스플라이어와 파트너를 연결하는데 사용됩니다. 광고주를 위한 해당 파트너 관련 안내 메시지도 여기에 표시됩니다.

파트너 활성화

자세한 내용은 상단의 파트너 활성화 항목을 참조하십시오.

파트너 ID

일부 파트너는 해당 파트너가 광고주에게 제공한 고유 ID를 통해 앱스플라이어와 연결해야 합니다. 이 ID는 앱 ID, 계정 ID, 사용자 ID, 네트워크 ID 등으로 불릴 수 있습니다.

뷰-쓰루 어트리뷰션 활성화

이 파트너로 뷰-쓰루 인스톨을 어트리뷰션하기 희망하면, 아래 설정의 토글을 켭니다. SRN(Self Reporting Network)의 경우, 토글이 켜지면, 뷰-쓰루 룩백 윈도우 설정 슬라이더가 표시됩니다.
SRN이 아닌 경우, 토글이 활성화되지 않았더라도 어트리뷰션 링크 탭에서 이 슬라이더를 사용할 수 있습니다(아래 설명 참조). 그러나 이런 경우, 앱스플라이어는 뷰-쓰루 슬라이더의 설정 값을 무시합니다.

기본 포스트백

어트리뷰션/연동이 파트너에 대해 활성화된 경우, 앱스플라이어는 자동으로, 사용자 인스톨, 실행, 리인게이지먼트 및 거부된 인스톨에 대한 포스트백을 해당 파트너에게 전송합니다. 이 섹션을 사용하여 포스트백 보낼 사용자 소스를 설정합니다.

해당 파트너로 어트리뷰션된 사용자만을 위해서라면, 보내기 옵션에서 "Only events attributed to this partner"를 선택합니다. 전체 사용자 베이스가 해당 파트너에게 보고되도록 하려면 "Events attributed to any partner or organic"을 선택합니다.

인앱 이벤트 설정

이 섹션에서는 포스트백을 통해 앱스플라이어 이벤트를 파트너와 매핑할 수 있습니다.

1. 필요할 경우, 여기서 파트너 ID 를 다시 설정합니다.
2. 인앱 이벤트 포스트백을 ON으로 토글합니다.
3. 필요한 경우, 인앱 이벤트 포스트백 윈도우 를 설정합니다. (인앱 이벤트 포스트백 윈도우 설정 관련 더 읽기)
4. SDK 이벤트를 목록에 추가하려면 이벤트 추가를 클릭합니다.
5. 다음 파라미터를 선택하여 채웁니다.

파라미터 이름	설명
SDK 이벤트 이름	앱에 연동된 SDK 또는 서버 간(S2S) 이벤트로서 앱스플라이어가 수신한 이벤트의 이름입니다. 팁: 찾고있는 이벤트가 없습니까? 이벤트 이름 상자에 SDK에 설정된 이벤트 이름을 타이핑하고, 커스텀 생성을 클릭하여 보통 때처럼 매핑하십시오. 커스텀 이벤트 매핑에 대해 더 자세히 알아보십시오.
파트너 이벤트 식별자	파트너 측에 정의되어 있는 각 이벤트의 고유 이름 또는 ID입니다. 가능한 매핑 설정 방식은 다음과 같습니다: 텍스트 필드 - 파트너로부터 해당하는 이벤트 ID를 가져옵니다. 드롭다운 상자 - 사전에 정의된 이벤트 중에서 해당 이벤트에 가장 적합한 것으로 선택합니다. 있는 그대로 - 이름 매핑 없이, 이벤트를 있는 그대로 전송합니다.
보내기 옵션	SDK에 이벤트에 대한 보내기 옵션을 선택합니다. - Only events attributed to this partner 이벤트 중 오직 이 파트너에게 어트리뷰션 된 유저의 인앱 이벤트만 - Events attributed to any partner or organic 모든 유저 베이스가 이 파트너에게 리포트 될 수 있습니다.
매출 전송	No values & no revenue: 이벤트 값(event value)를 제외하고 이벤트만 전송합니다. Values & no revenue: 매출 값을 제외한 모든 파라미터를 전송합니다. Values & revenue: 매출 값(이벤트에 존재하는 경우)을 포함하여 모든 이벤트 파라미터를 전송합니다.

인앱 이벤트 포스트백 설정에 대해 더 자세한 내용은 여기를 참조하십시오.

이 탭에서는, 파트너에게 전할 수 있도록, 앱에 대한 어트리뷰션 링크를 생성합니다. 특정 캠페인, 광고 세트 또는 단일 광고를 어트리뷰션 하기 위해, 어트리뷰션 링크를 파트너에게 전달합니다.
앱스플라이어는 생성된 파트너 어트리뷰션 링크를 저장하지 않음을 주의하십시오.

어트리뷰션 링크 파라미터

이 탭은 여러 섹션으로 나눠집니다.

이 섹션에서는 어트리뷰션 링크에 추가하고 싶은 파라미터를 선택합니다.

여기서 파라미터를 어트리뷰션 링크에 추가하면, 나중에 심층 분석을 수행할 수 있습니다. 이미 어트리뷰션 링크에 정의된 파라미터의 경우 여기에서 파라미터를 추가하거나 새 값으로 수정할 수도 있습니다.

• 캠페인 - 미디어 소스에서 운영 중인 다양한 캠페인을 비교하기 위해 추가합니다.
  어트리뷰션 링크 파라미터: c
• 광고 세트 - 미디어소스의 특정 캠페인에서 다양한 광고 세트를 비교하기 위해 광고 세트 이름을 설정합니다.
  어트리뷰션 링크 파라미터: af_adset
• 광고 이름 - 미디어소스의 특정 캠페인에서 특정 광고 세트의 다양한 광고 소재를 비교하기 위해 광고의 이름을 설정합니다.
  어트리뷰션 링크 파라미터: af_ad
• 사이트 ID 및 하위 사이트 ID - 앱 설치를 특정 퍼블리셔로 어트리뷰션 하기위해 사이트 ID 파라미터를 설정합니다. 퍼블리셔가 많이 있는 경우에는 사이트 ID 제한을 초과하지 않도록, 사용한 사이트 ID 수를 제한하고 하위 사이트 ID 파라미터를 사용하는 것이 권장합니다.
  어트리뷰션 링크 파라미터: af_siteid 및 af_sub_siteid
• 가입자 파라미터 - 유용한 값을 삽입하기 위해 5개의 가입자 파라미터 중 하나를 사용합니다. 이러한 파라미터는 파싱(parse)되어 로데이터 리포트에 표시되므로, 데이터 통합 또는 필터링을 수행할 때 유용합니다.
  어트리뷰션 링크 파라미터: af_sub1, af_sub2, af_sub3, af_sub4, af_sub5

다른 파라미터를 새 파라미터 상자에 입력하기만 하면, 어트리뷰션 링크에 추가할 수 있습니다. 사용할 수 있는 모든 앱스플라이어 URL 파라미터는 앱스플라이어 어트리뷰션 링크 구조 및 파라미터를 참조하십시오.

리타겟팅 설정

설정이 활성화되면, &is_retargeting=true가 클릭 기록 링크에 추가되며, 앱스플라이어는 링크를, 유저 유입이 아닌, 리타겟팅 어트리뷰션 링크로 인식합니다. 리타겟팅은 현재 클릭-쓰루에서만 지원되고, 뷰-쓰루 어트리뷰션에서는 지원되지 않습니다.
어트리뷰션 링크 파라미터: is_retargeting

다음 설정은 리타겟팅이 활성화 되었을 때 표시됩니다.

1. 일반 링크 vs. 원링크

   다음의 경우에는 일반 어트리뷰션 링크 옵션을 선택합니다.

   • URL을 통해 딥링킹할 필요가 없는 경우, 또는
   • 딥링킹 시 URI 스킴만 사용하는 경우

   다음의 경우에는 원링크를 사용 합니다.

   • 안드로이드 및 iOS 앱 모두에 하나의 링크 사용
   • 유니버설 또는 앱 링크를 사용한 딥링킹 

   원링크를 선택하면 앱에 특정한 클릭 기록 링크가 원링크 URL로 변경됩니다.

2. 딥링크 URL

   링크가 사용자를 앱 내부의 특정 액티비티로 딥링킹하려는 경우, 이 필드를 사용합니다.
   어트리뷰션 링크 파라미터: af_dp
   더 자세한 정보는 앱스플라이어의 딥링킹 솔루션 가이드에서 확인할 수 있습니다.

3. 리인게이지먼트 윈도우

   리인게이지먼트 이후에 발생하는 인앱 이벤트들이 리타겟팅 미디어 소스로 어트리뷰션 되는 기간을 설정합니다. 그 값은 일 (1-90일), 시간 (최대 23시간), 또는 라이프타임으로 설정할 수 있습니다.

   어트리뷰션 링크 파라미터: af_reengagement_window

클릭쓰루 어트리뷰션

클릭에서 인스톨까지의 최대 시간을 이 슬라이더에서 설정할 수 있습니다. 룩백 윈도우 내에 수행되는 인스톨(첫 번째 앱 실행)만 파트너에게 어트리뷰션 됩니다.

어트리뷰션 링크 파라미터: af_click_lookback

클릭 룩백 윈도우 관련 상세 내용은 여기를 참조하십시오.

클릭 어트리뷰션 링크

이것은 설정해둔 모든 설정 정보를 포함하는 어트리뷰션 링크입니다.

앱스플라이어는 파트너의 어트리뷰션 링크를 저장하지 않으므로, 생성된 링크를 복사하여 파트너에게 전송하십시오. 유저가 링크 사용된 광고를 클릭할 때, 링크가 활성화됩니다.

뷰쓰루 어트리뷰션 룩백 기간

광고 노출에서 인스톨까지의 최대 시간을 이 슬라이더에서 설정할 수 있습니다. 다른 관련된 광고 클릭이 없는 경우에, 광고 노출 이후 룩백 윈도우 내에 수행되는 인스톨(첫 번째 앱 실행)만 파트너에게 어트리뷰션 됩니다.

이 값을 1-23 시간 또는 1-7 일로 맞춤 설정 할 수 있습니다. 

어트리뷰션 링크 파라미터: af_viewthrough_lookback

더 자세한 내용은 여기에서 뷰-쓰루 어트리뷰션 항목을 참조하십시오.

광고 노출 어트리뷰션 링크

광고 노출 어트리뷰션 링크에는 클릭 기록 링크와 유사한 어트리뷰션 데이터를 포함합니다(룩백 윈도우는 서로 다름). 일반적으로 1초 또는 그 이상 해당 광고가 시청되면, 파트너에게 전송되어 활성화됩니다.

• 비용 데이터는 클릭에 따르거나 비용 API에 의해, 연동 파트너에 의해 리포트 됩니다.
• 가장 좋은 방법은 비용 API를 구현하는 것입니다.
• 비용 API는 클릭과 노출 리포트를 포함합니다.

API에 의한 비용 데이터 활성화 하기

비용 연동 API를 활성화 하려면:

1. 파트너 연동의 비용 연동 탭에서, 비용 데이터 연동 을 활성화 합니다. 파트너에 연결하기 위해 인증 정보가 요구됩니다.
2. 파트너의 대시보드에서나 앱스플라이어 UI에 지시된대로, 요구된 인증 정보를 가져옵니다.
3. 인증 정보 필드를 완성합니다.
4. 비용 연동 저장 을 클릭합니다.
5. 연결 테스트 를 클릭합니다.
6. 메시지가 다음과 같은 경우:
   • API 연결 검증됨(API connection verified)이 표시되면:
     • 과정을 성공적으로 완료했습니다. API는 활성화 되었습니다. 앱스플라이어는 파트너로부터 하루에 6번, 평균 4시간에 한번씩 데이터를 가져옵니다. 
   • 잘못된 인증 정보(Invalid Credentials)가 표시되면, 인증 정보를 점검하고 과정을 다시 진행하십시오.
   • 무엇인가 잘못되었습니다(Something went wrong)이면 잠시 후 다시 시도해보십시오.

비용 데이터 동기화 상태

비용 연동 탭에는 비용 연동 상태와 앱스플라이어가 해당하는 비용 데이터를 가져온 마지막 시간이 표시됩니다. 이는 API를 통한 비용 정보 수신을 지원하는 네트워크와 관련이 있습니다.

아래 표에는 5 가지 상태 메시지와 이들이 비용 연동 탭에 표시되는 경우 수행할 작업이 나열되어 있습니다.

상태 메시지	설명	필요한 작업
활성 (Active)	파트너 API가 응답하고 데이터를 송신합니다.	없음.
활성 (Active)   표시되는 동기화 메시지: 비용 데이터가 성공적으로 추출되지 않았습니다. (Cost Data was never successfully pulled.)	다음 중 한 가지 일 수 있습니다. 지금 막 연동 설정을 완료하여, 앱스플라이어가 아직 데이터를 가져오지 않았습니다. 애드 네트워크로부터 유입된 인스톨에 대한 정보가 앱스플라이어에 없습니다.	앱스플라이어가 데이터를 가져오는 것을 기다립니다. 애드 네트워크에서 캠페인을 시작합니다.
일치하는 데이터 없음 (No Matching Data)	앱스플라이어는 파트너 API를 통하여 앱의 활성 캠페인에 대해 쿼리하였지만, 파트너 API가 해당 캠페인 데이터를 보내주지 않습니다.	이것은 캠페인이 아직 운영중일 때 캠페인 ID를 변경하면 발생할 수 있습니다.   비용 데이터를 의존하는 경우, 캠페인이 활성 상태로 운영 중인 동안에는 캠페인 ID를 변경하지 마십시오.   또한, 올바른 앱에 대한 정확한 API 정보를 입력하여 네트워크가 어트리뷰션 링크에 정확한 캠페인 ID를 전달하도록 하십시오.
파트너 API가 응답하지 않습니다.	애드 네트워크 비용 데이터 API가 다운되었거나 문제가 발생했을 수 있습니다.	네트워크 API가 응답할 때까지 기다립니다.
잘못된 로그인 ID (Invalid Credentials)	비용 API를 작동하기 위한 로그인 정보가 올바르지 않습니다. 앱스플라이어가 비용 데이터를 가져올 수 없습니다.	비용 API 키가 정확한지 확인하십시오.

마지막 데이터 연동 (Last successful data pull)

비용 연동 탭에는 마지막으로 비용 데이터를 가져온 시간이 표시됩니다. 비용 데이터를 한번도 가져 오지 못한 경우 동기화 메시지에 비용 데이터가 성공적으로 추출되지 않았습니다. (Cost Data was never successfully pulled.) 라고 표시됩니다.

OAuth 네트워크

OAuth 네트워크(구글, 페이스북)은 비용 데이터를 가져올 수 있도록 여러 계정을 동기화하는 것을 허용합니다. 동기화된 각 계정에 대해 앱스플라이어는 비용 연동 상태와 해당하는 비용 데이터를 앱스플라이어가 가져온 마지막 시간을 표시합니다.

앱에서 광고를 게재하는 퍼블리셔로도 활동하는 경우, 광고 수익 기능을 통해 유저를 유입시킨 미디어 소스에 광고 수익을 어트리뷰션 할 수 있습니다. 광고 수익 어트리뷰션 참고 문서. 

광고 수익 어트리뷰션 활성화 하기

광고 수익을 어트리뷰션 하는데 사용할 수 있는 여러 가지 옵션이 있습니다. 

• 파트너가 어떤 방법(통합 또는 사용자 수준 어트리뷰션)을 지원하는지 확인하십시오.
• 광고 수익 연동 가이드에 기록된 적합한 방법으로 진행하십시오.

권한 탭에서 다양한 권한을 활성화할 수 있습니다. 심지어 어트리뷰션이 활성화되어 있지 않은 경우에도, 권한을 부여할 수 있습니다. 권한 부여는 파트너 유형 - 애드 네트워크, 에이전시 또는 둘 다와 관계없이 부여됩니다. 

광고 네트워크 권한

설정을 시작하기 위해, 애드 네트워크 권한 을 활성화하십시오.

애드 네트워크 권한 을 켜고 나면:

• 앱이 애드 네트워크의 대시보드에 표시됩니다.
• 권한은 이 애드 네트워크에만 부여됩니다.
• 애드 네트워크 관리자는 앱에 대한 기본 데이터를 확인할 수 있습니다.

애드 네트워크 팀원에게 권한 부여하기

애드 네트워크 관리자는 기본적으로 앱에 액세스할 수 있지만, 애드 네트워크의 특정 팀원에게 앱을 관리할 수 있는 권한을 부여할 수 있습니다. 시작하기 전에, 애드 네트워크 팀원들의 이메일 주소를 받고, 이것이 정확한지 애드 네트워크와 확인하십시오.

팀 멤버를 추가하려면:

1. 팀멤버 추가하기 를 클릭합니다.
2. 애드 네트워크 팀원의 이메일을 입력합니다.
3. 추가 를 클릭합니다.
4. 필요한 경우, 이 과정을 반복하여 팀원을 더 추가하십시오.

애드 네트워크에 대한 권한을 활성화 하고 나면, 부여할 권한을 선택합니다.

이 토글을 사용하여, 앱에 대한 자체 설정 권한을 애드 네트워크에 부여할 수 있습니다.

• 파트너 연동 설정 허용 - 파트너가 연동 탭을 설정할 수 있도록 허용 (인앱 이벤트 포스트백 제외)
• 인앱 이벤트 포스트백 설정 허용 - 파트너가 연동 탭에서 인앱 이벤트 포스트백을 자사에게 매핑할 수 있도록 허용
• 리텐션 리포트 액세스 허용 - 파트너가 유입시킨 유저의 리텐션 데이터만 해당
• 종합 로열 유저 데이터 접근 허용 - 파트너 자사만의 로열 유저에만 해당
• 통합 인앱 이벤트 데이터 액세스 허용 - 파트너가 유입시킨 유저의 인앱 이벤트 데이터만 해당
• 종합 수익 데이터 접근 허용 - 파트너 자사에 어트리뷰션되는 수익 데이터만 해당
• 광고 비용 데이터 업로드 허용 - 앱 수준입니다. 
• 프로텍트360 대시보드 액세스 허용 - 파트너 자사의 프로텍트360 데이터에만 해당되며, 이 기능을 사용하고 있는 광고주만 부여 가능

애드 네트워크 권한 부여에 대해 자세히 알아보십시오.

에이전시 권한

아래 토글을 활용하여, 에이전시가 앱에 대해 직접 설정할 수 있는 권한을 에이전시 파트너에게 부여합니다.

• 메인 토글 - 이를 ON으로 켜면:
  
  • 에이전시 권한 옵션이 표시됩니다.
  • 에이전시에게 앱 인스톨이 어트리뷰션 가능해집니다.
  • 에이전시가 페이스북과 트위터 프로모션 데이터를 확인 가능해집니다.
  주의 - 토글이 꺼져있을 때 발생한 에이전시 유입 인스톨은 에이전시로 어트리뷰션 되지 않고, 에이전시의 대시보드 및 데이터에 표시되지 않습니다. (상세 내용)

• 프로텍트360 대시보드에 액세스 허용
• 리텐션 및 코호트 리포트 액세스 허용 - 해당 에이전시가 유입시킨 유저의 리텐션/코호트 데이터만 해당.
• 통합 오가닉 데이터에 액세스 허용
• 인앱 이벤트 포스트백 설정 허용 - 에이전시가 연동 탭에서 자체적으로 인앱 이벤트 포스트백 매핑을 설정 가능하도록 허용
  • 이벤트 공유 권한 - 아래 두가지의 옵션 중 하나를 선택하십시오.
    

    

    a) Only events attributed to this partner - 에이전시가 앱으로 유입시킨 트래픽에서 발생한 이벤트만 전송합니다.
    b) Events attributed to any partner or organic - 다른 미디어 소스, 다른 에이전시 및 오가닉 유저를 포함한 모든 트래픽에서 발생한 이벤트를 전송합니다.
  • 이벤트 매출 전송 허용 - 에이전시가 이벤트의 금전적 가치를 포함하여 이벤트 전송 설정하는 것을 허용
  • 에이전시에게 권한을 주고 싶은 특정 이벤트를 선택하십시오. 이벤트 추가 를 클릭하여 드롭다운 목록에서 이벤트를 선택합니다.  추가하고 싶은 각 이벤트에 대해 이 작업을 수행하십시오.

에이전시에 권한을 부여하고 나면, 다음 사항을 고려하십시오.

• 에이전시에 권한을 부여했을 때는, 에이전시도 그들이 협업하는 애드 네트워크에 앱 관리를 위해 권한을 부여할 수 있습니다. 이것은 애드 네트워크에 권한을 부여하는 것과 동일합니다.
• 광고주가 애드 네트워크와 협업하고 있는데, 에이전시 또한 해당 애드 네트워크와 협업한다면, 양쪽 모두에서 애드 네트워크 팀 멤버가 앱 대시보드를 볼 수 있는 권한을 수정할 수 있습니다.
• 광고주가 애드 네트워크 팀원을 추가 또는 제거하지 않았는데도, 애드 네트워크 팀멤버가 새로 추가되었거나 사라진 경우, 에이전시가 추가했거나 삭제했을 가능성이 있습니다.

더 자세한 내용은 에이전시와의 협업에서 확인하십시오.