파트너 콘솔 사용법
파트너 콘솔이란?
디파이너리에서는 파트너를 위한 별도의 콘솔을 제공합니다.
파트너 콘솔에서 직접 채널을 관리하고, 포스트백을 수신할 엔드포인트를 등록하거나 수정할 수 있습니다.
My Profile
[파트너 콘솔 > 좌측 하단의 계정명 클릭 > My Profile] 메뉴를 통해 계정의 이름과 비밀번호를 변경할 수 있습니다.
Templates
템플릿 메뉴에서는 다음 기능을 제공합니다.
- 트래킹링크 클릭 파라미터 관리
- 포스트백 엔드포인트 설정
- 어트리뷰션 및 이벤트 포스트백 관리
- 커스텀 이벤트명 매핑
Tracking URL
광고주가 파트너를 선택하고 트래킹링크를 생성했을 때 클릭 파라미터를 자동 추가하도록 설정할 수 있습니다.
Template Code 에 "디파이너리 클릭 파라미터={파트너에서 사용하는 매크로}" 형식으로 설정을 하면 해당 값이 트래킹링크에 추가됩니다.
지원 중인 클릭 파라미터 리스트와 자세한 정보는 [트래킹링크 추가 파라미터] 가이드를 참고 바랍니다.
위와 같이 Template Code를 설정했을 때 트래킹링크는 다음과 같이 생성됩니다.
Postback EndPoint
포스트백을 수신하는 엔드포인트를 생성하고 수정할 수 있습니다.
Create Postback EndPoint
포스트백을 수신할 엔드포인트의 정보를 입력하고 등록합니다.
- EndPoint Name : 관리를 위한 포스트백 엔드포인트의 이름입니다.
- Method : HTTP Request 방식을 선택합니다. (Get, Post, Put)
- Url : 포스트백 리퀘스트를 수신할 엔드포인트의 url 정보를 입력합니다. 전송방식에 따라 쿼리스트링을 포함합니다.
- Body : 포스트백 리퀘스트의 Body로 전달받고 싶은 정보를 설정합니다.
- Header : 포스트백 리퀘스트의 Header로 전달받고 싶은 정보를 설정합니다.
- Ping Test : 작성된 정보를 이용하여 Ping Test를 진행합니다.
* Get 방식에서는 URL에 전달받고자하는 데이터를 key=value 형태로 설정합니다.
* Post 방식에서는 Body에 전달받고자하는 데이터를 key=value 형태로 설정합니다.
* 디파이너리가 포스트백으로 제공하는 데이터에 대한 안내는 [포스트백 매크로 안내] 를 참고합니다.
Attribution Postback
어트리뷰션 포스트백을 설정합니다.
각 어트리뷰션 이벤트에 대해서 전송 여부를 설정하고 이벤트 따라 다른 엔드포인트로 포스트백을 전송하도록 재정의(Override)할 수도 있습니다.
- Default EndPoint : 어트리뷰션 포스트백을 수신할 엔드포인트를 선택합니다.
- Default Scope : 어트리뷰션 포스트백 전송 조건을 선택합니다. (Only or All)
- Target Attribution Event : 전송할 어트리뷰션 이벤트를 선택합니다.
- 선택한 어트리뷰션 이벤트는 광고주가 내 채널을 조회할 때에 지원 가능한 이벤트로 표기됩니다.
Event Postback
이벤트 포스트백을 설정합니다.
이벤트 포스트백을 수신할 엔드포인트를 설정하고 룩백윈도우, 지원 가능 이벤트 등을 설정할 수 있으며, 이벤트에 따라 다른 엔드포인트로 포스트백을 전송하도록 재정의(Override)할 수 있습니다.
- Default EndPoint : 이벤트 포스트백을 수신할 엔드포인트를 선택합니다.
- Default Scope : 이벤트 포스트백 전송 조건을 선택합니다. (only or all)
- Entry Attribution Types : 이벤트 포스트백의 어트리뷰션 타입과 룩백윈도우를 설정합니다.
- Target Attribution Event : 지원 가능한 인앱 이벤트를 선택합니다.
- 선택한 이벤트는 광고주가 내 채널을 조회할 때에 지원 가능한 이벤트로 표기됩니다.
Custom Event Name Mapping
디파이너리에서는 사전 정의된 인앱 이벤트를 제공하고 있습니다.
예) abx:sign_up, abx:purchase
광고주가 사전에 정의된 이벤트를 사용할 경우, 포스트백으로 전송되는 이벤트명은 디파이너리에서 설정한 이벤트명 그대로 전송됩니다.
Custom Event Name Mapping 기능은 위와 같은 사전 정의된 이벤트명을 파트너에서 원하는 값으로 변경하여 받을 수 있습니다. 상세 설정 방법은 다음과 같습니다.
- 추가 버튼을 클릭 해 Adbrix Predefined Event Name에서 변경할 이벤트를 선택합니다.
- Replace Text에 변경할 이벤트명을 설정합니다.
- 포스트백 url에 {replaced_event_name} 매크로를 추가합니다.
예시) event_name={req.evt.event_name} → event_name=abx:purchase
event_name={replaced_event_name} → event_name=purchase
Settings
파트너 정보를 수정하거나 Credentials 매크로를 설정할 수 있습니다.
Details
Settings>Details 메뉴에서 광고주 콘솔에 노출되는 파트너명과 이미지를 설정할 수 있습니다.
Credentials
광고주 인증용 파라미터를 설정하고 이를 포스트백으로 전송하는 기능입니다.
파트너에서 광고주에게 발급한 고객사 코드 혹은 전환 추적 코드를 포스트백으로 전송할 수 있습니다.
상세 설정 방법은 다음과 같습니다
1. Credentials 설정 Settings>Credentials 메뉴에서 Credentials 값을 전송할 매크로를 생성합니다.
- Name : Credentials 매크로 이름을 설정합니다.
- Macro : 포스트백 엔드포인트에 사용할 매크로 키를 설정합니다. 매크로는 소문자, 숫자, 마침표(.), 언더스코어(_)만 사용할 수 있습니다. 예를 들어 conversion_code 라는 매크로를 입력했다면, 포스트백 엔드포인트에는 {credentials.conversion_code}로 설정합니다.
- Description(옵션) : 매크로에 대한 설명을 입력합니다.
- Platforms : 적용 플랫폼을 선택합니다.
- Required Field : 필수 여부를 설정합니다.
- Validation Rule : value 검증 규칙을 설정합니다.
2. 포스트백 엔드포인트에 포스트백 매크로 추가
엔드포인트에 포스트백 매크로를 추가해 광고주가 설정한 Credentials 파라미터 데이터를 전달받습니다.
만약 conversion_code 라는 매크로명을 입력했다면, 포스트백 엔드포인트에는 {credentials.conversion_code}로 설정합니다.
예시) code={credentials.conversion_code}
3. 광고주 콘솔 설정
광고주 콘솔(디파이너리 콘솔)>Attribution>Ad Partner Settings>파트너 설정 메뉴에서 파트너로 전달할 credentials 값을 설정합니다.
- 1~3 설정을 모두 완료하면 파트너는 고객사 코드를 포스트백으로 받을 수 있습니다.
FAQs
Q. 포스트백 url key값이 변경되었을 때 어디서 어떻게 수정할 수 있나요?
: 포스트백 url은 파트너 콘솔에서 직접 수정할 수 있습니다.
1. 파트너 콘솔>Templates>Postback Endpoint>수정이 필요한 포스트백 URL 확인>도구 버튼>Edit 선택
2. 포스트백 url 수정 > 콘솔 내 우측 하단 저장 버튼 클릭
Q. 포스트백 url이 수정되었을 때 반영은 얼마나 소요되나요?
: 수정된 포스트백 url은 10분 이내로 반영됩니다.
Q. 특정 광고주만 포스트백 데이터가 다르게 확인됩니다.
: 포스트백 url 설정은 파트너 콘솔 외에도 광고주 콘솔(디파이너리 콘솔)에서 포스트백 url을 재정의(Overriding)하여 사용할 수 있습니다.
특정 광고주만 포스트백 데이터가 다르다면 광고주 콘솔의 포스트백 설정 상태를 확인바랍니다.
문의
파트너 콘솔에 대한 이용 문의는 디파이너리 서포트 엔지니어링 팀으로 연락 주시기 바랍니다.
메일 : partner-support@adbrixsupport.zendesk.com