Pinterest 모듈 설정 가이드
Pinterest은(는) Adjust와 연동된 광고 네트워크입니다. Adjust와의 연동을 통해 Pinterest은(는) 어트리뷰션과 인앱 이벤트 데이터를 콜백으로 수신합니다.
이 페이지에서는 Pinterest와(과)의 설정 방법을 확인하실 수 있습니다. Pinterest 활성화, 캠페인 링크 생성, Adjust가 공유할 수 있는 데이터 선택 방법을 아래에서 확인하시기 바랍니다.
시작에 앞서
요구 사항
- Adjust의 관리자, 편집자 또는 사용자 지정 편집자 권한 .
- Adjust SDK v4.0.0 이상 버전에서 SDK 파라미터를 Pinterest 파라미터에 매핑하시기 바랍니다. 자세한 내용은 아래 링크된 가이드를 통해 확인하실 수 있습니다.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
인증 정보
TAG ID (required for events), Pinterest Account ID, Pinterest Authentication Token
- 인증 정보를 찾는 데 도움이 필요한 경우에는 Pinterest 담당자에게 문의하시기 바랍니다.
Pinterest 대시보드
Adjust S2S 클릭 링크는 Pinterest에서 parallel click trackers 로 설정되어야 합니다. 자세한 정보는 여기에서 확인하실 수 있습니다.
Campaign Lab에서 Pinterest과 앱 선택
- Campaign Labs 에서 파트너 를 선택합니다.
- 새 파트너 > Pinterest 을 선택합니다. 다음 을 선택하여 다음 화면으로 이동합니다.
- 앱 선택 화면에서 링크를 생성하고자 하는 앱을 선택하고, Pinterest를(을) 활성화하여 파트너와 데이터를 공유합니다.
- 다음 을 선택합니다.
데이터 공유 활성화
Pinterest와(과)의 연동을 활성화하려면 다음의 단계를 수행하시기 바랍니다.
- TAG ID (required for events), Pinterest Account ID, Pinterest Authentication Token을 입력합니다.
Pinterest와(과)의 데이터 공유가 활성화되면, Adjust는 기본 설정에 따라 다음의 데이터를 자동으로 Pinterest에 전송합니다.
- 이벤트
데이터 공유 옵션 설정
멀티 플랫폼에 대해 데이터 공유가 활성화된 멀티 플랫폼 앱인 경우, 다음이 가능합니다:
- 플랫폼별 설정 사용 을 선택하여 플랫폼 수준에서 데이터 공유 옵션을 구분.
- 글로벌 설정 사용 을 선택하여 여러 플랫폼에 대해 동일한 데이터 공유 설정을 적용.
기본 설정으로 공유되는 데이터 에서 Adjust가 Pinterest과 디폴트로 공유하는 활동을 확인하시기 바랍니다.
- 이벤트
추가 데이터 전송
콜백을 통해 Pinterest과(와) 공유하고자 하는 데이터의 양과 유형을 선택합니다. Pinterest은(는) 퍼포먼스 최적화를 위해 이 정보를 사용할 수 있습니다.
- 공유하고자 하는 데이터 소스 에서 Pinterest과(와) 공유하는 데이터의 어트리뷰션 소스를 선택합니다.
- 모든 어트리뷰션 소스의 데이터
- Pinterest에게 어트리뷰션된 데이터
인앱 매출 (인앱 구매로부터의 매출)
인앱 매출 공유가 활성화되면 Pinterest에 매출 금액과 매출 이벤트 데이터를 전송할 수 있습니다. 이 데이터를 공유하려면 매출을 창출하는 이벤트를 매핑 해야 합니다.
이벤트 매핑
공유하고자 하는 이벤트를 Pinterest이(가) 수신할 수 있는 값에 매핑합니다. 매핑되지 않은 이벤트는 Pinterest 에 공유되지 않습니다.
개별 이벤트 매핑
멀티 플랫폼 앱의 경우, Pinterest과(와) 플랫폼별로 다른 이벤트를 공유할 수 있습니다. 이를 통해서,
- 개별 이벤트를 설정하여 각 플랫폼에 대한 캠페인 전략을 관리할 수 있습니다.
- 플랫폼별로 데이터 공유를 맞춤화할 수 있습니다.
이벤트 매핑 에서 다음의 단계를 수행하여 Pinterest에 직접 전송하고자 하는 인앱 이벤트를 선택합니다.
이벤트 매핑 을 선택합니다.
Adjust 이벤트 목록에서 Pinterest과(와) 공유하고자 하는 Adjust 이벤트를 선택합니다.
파트너 이벤트 에서 Adjust 이벤트에 상응하는 Pinterest 이벤트를 선택해야 합니다.
단일 플랫폼 앱 및 단일 플랫폼에 대해서만 데이터 공유가 활성화된 멀티 플랫폼 앱의 경우, 해당 플랫폼에 대해서만 데이터 공유 옵션을 설정합니다. 멀티 플랫폼에 대한 데이터 공유가 활성화되어 있는 멀티 플랫폼 앱의 경우 다음을 설정할 수 있습니다.
- 플랫폼별 매핑 사용 을 선택하여 플랫폼 수준에서 개별 이벤트를 매핑하거나 특정 플랫폼에 대한 이벤트를 매핑하지 않을 수 있습니다.
- 모든 플랫폼에 대해 동일한 이벤트를 매핑하려면 글로벌 매핑 사용 을 선택합니다.
파트너 이벤트 목록에서 Adjust 이벤트를 매핑하고자 하는 커스텀 이벤트 이름을 선택하거나 입력합니다.
적용 을 선택합니다.
이제 연결된 이벤트 데이터가 Pinterest에게 전송됩니다.
모든 이벤트 매핑
Pinterest이(가) 모든 이벤트 자동 매핑을 지원하는 경우 이벤트 매핑 에서 모든 이벤트 매핑 을 선택 합니다. 이를 통해 개별 이벤트를 매핑하는 시간을 절약할 수 있습니다.
이제 연결된 인앱 이벤트 데이터가 Pinterest에게 전송됩니다.
파라미터 매핑
Pinterest에 커스텀 데이터를 공유하려면 일반적으로 파라미터 매핑이 필요합니다.
파트너 파라미터(Adjust SDK 버전 4.0+에서 이용 가능)를 통해 Adjust는 앱에서 커스텀 데이터 포인트를 수집하여 Pinterest에 전송할 수 있습니다. 이를 통해 Pinterest은(는) 연결된 개별 이벤트에 대한 커스텀 이벤트 상세 정보를 수신할 수 있습니다.
Adjust SDK에 새로운 파트너 파라미터를 추가하기 전, 요구 사항을 충족하는 파트너 파라미터가 이미 존재하는지 확인하시기 바랍니다.
파트너 파라미터를 Pinterest에 공유하려면 다음의 단계를 수행하시기 바랍니다.
Adjust SDK 내에서 파트너 파라미터를 설정합니다.
- 시작하기 전에 모든 SDK 개발 플랫폼 링크를 확인하시기 바랍니다.
데이터 공유 옵션 설정 에서 파라미터 를 선택합니다.
파라미터 매핑 에서는 SDK에서 정의된 파트너 파라미터를 네트워크에 어떠한 방식으로 보낼지 지정할 수 있습니다.
- 파라미터 매핑 을 선택합니다.
- SDK 파라미터 필드에 네트워크와 공유하고자 하는 SDK 파라미터 이름을 입력합니다.
- 네트워크 파라미터 영역에 SDK 파라미터에 상응하는 네트워크 파라미터를 입력합니다.
대시보드에서 파라미터 공유를 설정하지 않고 Adjust SDK 내에서 파트너 파라미터를 설정한 경우, Adjust는 Adjust SDK에 설정된 파라미터명을 그대로 전송합니다.
링크 및 설정 구성
다음을 설정할 수 있습니다.
링크 생성 및 Pinterest에게 공유
설정 검토 화면에서는 선택 사항을 검토할 수 있습니다. 이전 페이지로 돌아가서 다음을 변경할 수도 있습니다.
- 선택한 앱
- 데이터 공유 옵션
- 링크 구조 파라미터
- 사용자 이동 위치
- 어트리뷰션 설정
링크 생성 을 선택하여 클릭 URL, 노출 URL, QR 코드 및 링크 토큰을 생성합니다. 링크를 생성하면 Pinterest과(와)의 데이터 공유 및 연동이 활성화 됩니다.
링크가 생성되면 Pinterest에 공유하여 캠페인에 배치할 수 있습니다.
파트너별 설정 가이드
개요
인앱 이벤트를 Pinterest로 전송하기 위해 필요한 인증 정보는 사용 중인 API 버전에 따라 달라집니다.
API v5(권장):
- 광고 계정 ID
- 액세스 토큰
레거시 API:
- 태그 ID
액세스 토큰 은 Pinterest Ads Manager : Ad Account Overview> Conversions> Set Up API 에서 조회할 수 있습니다.
레거시 API에서 API v5로 전환
Pinterest는 API v5 를 위해 레거시 API 지원을 중단합니다. 본 문서는 인증, 이벤트 매핑, 레거시 구성 삭제 등의 설정 과정을 안내합니다.
1. 인증 정보 입력
Campaign Lab에서 Pinterest와 앱을 선택한 후 다음의 세부 정보를 입력합니다.
- 계정 ID
- 액세스 토큰
두 필드 모두 API v5에서 필수입니다. 올바른 계정 ID에 대한 액세스 토큰을 찾는 방법은 여기에서 확인할 수 있습니다.
2. 이벤트 매핑
이벤트 매핑 필드 이해하기
- 이름(레거시) – 레거시 API에만 사용됩니다.
- 새 이름(API v5) – API v5에 필요한 이벤트 값입니다.
Adjust 이벤트 필드에서 매핑하고자 하는 Adjust 인앱 이벤트를 선택하고 새 이름 드롭다운의 값에 매핑합니다.
레거시 API(이름)에서 API v5(새 이름)로의 이벤트 이름 매핑 권장 사항은 다음과 같습니다. 또한 레거시 API(이름) 이벤트를 Pinterest에 대해 사용 가능한 다른 API v5(새 이름) 이벤트에 매핑할 수 있습니다.
| 이름(레거시) | 새 이름(API v5) |
| Add to cart | Add to cart |
| Purchase | Checkout |
| Registration | Signup |
| Search | Search |
| Lead | Lead |
| Page visit | Page visit |
3. 레거시 태그 ID 삭제(선택)
API v5에서는 태그 ID가 더 이상 필요하지 않습니다. 구성에서 태그 ID를 안전하게 삭제할 수 있습니다. 계정 ID 및 액세스 토큰 과 함께 태그 ID와 새 이름 필드 값을 제공하는 경우, 시스템은 API v5 를 우선시하며 레거시 API에 대한 태그 ID를 무시합니다.
모범 사례
Pinterest는 iOS 및 Android '딥링킹' 전환 캠페인을 모두 지원합니다. 연동을 활성화하기 전에 Pinterest에 문의 하여 캠페인 설정을 지원받으시기 바랍니다.
사전 정의된 파라미터
Adjust SDK를 사용하여 이벤트와 함께 사전 정의된 파라미터 를 전송할 수 있습니다. 올바르게 첨부된 파라미터는 Pinterest로 전송됩니다.
이벤트에 파트너 파라미터 를 첨부하는 올바른 방법은 SDK 문서를 참조하시기 바랍니다.
| 파라미터 | 설명 | API v5에서 지원 | 형식/메모 |
| external_id | 외부 사용자 ID | ✅ | 쉼표 또는 세미콜론으로 구분된 문자열 목록 |
| event_source_url | 이벤트가 발생한 웹페이지의 URL | ✅ | 문자열(URL 형식) |
| em | 이메일 주소 해시 | ✅ | 소문자 이메일 주소의 SHA256 해시 |
| ph | 전화번호 해시 | ✅ | 전화번호(숫자만)의 SHA256 해시 (국가 및 지역 코드 포함) |
| event_id | 특별한 이벤트 식별자 | ✅ | String |
| content_ids | 제품 또는 콘텐츠 식별자 | ✅ | 쉼표 또는 세미콜론으로 구분된 문자열 목록 |
| order_id | 주문 식별자 | ✅ | String |
| value | 구매 또는 장바구니 담기의 값 | ✅ | 숫자(이전 API에서도 지원) |
| 통화(currency) | 값 필드의 통화 | ✅ | ISO 4217 코드(예: USD, EUR) — 이전 API에서도 지원 |
external_id, em, ph 형식에 대한 자세한 내용은 Pinterest API 문서를 참조하시기 바랍니다.
값 및 통화 파라미터의 값은 대체값 으로 사용되며, Adjust가 SDK로부터 인앱 이벤트에 대한 매출 데이터를 직접 수신하지 않는 경우 에만 Pinterest에 전송됩니다.
이벤트 매출 기록에 대한 자세한 정보는 Adjust 문서를 참조하시기 바랍니다.
그룹화된 아이템 레벨 파라미터
다음 파라미터는 아이템 레벨 메타데이터 를 설명하며 이벤트 페이로드 전체에서 순서대로 정렬 되어야 합니다.
| 파라미터 | 설명 | 형식/메모 |
| id | 아이템에 대한 고유 식별자 | 정렬된 문자열 목록(쉼표 또는 세미콜론으로 구분) |
| quantity | 각 아이템의 수량 | 정렬된 문자열 목록 |
| item_name | 각 아이템의 이름 | 정렬된 문자열 목록 |
| item_price | 각 아이템의 가격 | 정렬된 문자열 목록 |
| item_category | 각 아이템의 카테고리 | 정렬된 문자열 목록 |
| item_brand | 각 아이템의 브랜드 | 정렬된 문자열 목록 |
모든 필드에서 값의 순서 가 일치해야 합니다.
(예: item_price의 첫 번째 값은 item_name, id 등의 첫 번째 값과 일치해야 함)
Pinterest에 전송되는 모든 파라미터 목록
Adjust는 Pinterest의 콜백에 다음의 파라미터(데이터 포인트)를 전송합니다.
| 플레이스홀더 | 정보 |
{city} | 기기 도시 |
{country} | 기기 국가 코드(두 자릿수) |
{currency} | Adjust SDK에서 전송된 ISO 4217 고유 통화 코드 |
{device_name} | 기기 모델 번호 |
{gps_adid} | Google Play Store 광고 ID |
{idfa} | 광고주 ID (iOS 만 해당) |
{ip_address} | 기기 IP 주소 |
{isp} | 기기 인터넷 서비스 공급자 |
{language} | 기기 언어 코드(두 자릿수) |
{os_name} | 기기 운영 체제 |
{os_version} | 운영 체제 버전 번호 |
{partner_parameters} | Adjust SDK나 S2S 요청에 의해 수집되고, 포스트백을 통해 서드파티 제공자에게 전송된 맞춤 파트너 파라미터 |
{revenue_usd} | 수익 미국 달러 표기 |
{revenue} | Adjust SDK에서 전송된 매출(센트) |
{sdk_version} | Adjust SDK 버전(앱 당) |
{tracking_limited} | 트래킹이 제한되어 있으면 1, 제한되지 않은 경우 0 |
{user_agent} | 수신되는 미가공 유저 에이전트 |
{app_id} | Store App ID 또는 Google Play Store |
{app_name} | 앱 이름 |
{app_version_short} | 앱 버전 번호(안드로이드), 번들용 릴리즈 버전 번호(iOS) |
{created_at} | 활동 타임스탬프 |
{impression_based} | 노출 기반 인게이지먼트면 1, 그 외는 0 |