이 문서에서는 모바일 앱 캠페인, PC/콘솔 인스톨, 웹 캠페인을 대상으로 Singular의 어트리뷰션 및 Conversions API를 사용해 OpenAI Ads(ChatGPT) 캠페인을 설정하는 방법을 설명합니다.
개요
Singular의 웹-투-앱 어트리뷰션 솔루션을 사용하면 마케터가 모바일, PC, 콘솔 플랫폼에서 앱 인스톨을 유도하는 웹 캠페인을 운영할 수 있습니다. Singular의 OpenAI Ads 웹-투-앱 연동은 다음 문서에서 설명하는 Direct to Store 플로우를 지원합니다: 웹-투-앱 가이드 보기 .
Singular에서 ChatGPT 파트너 설정 추가
Singular에서 ChatGPT Ads 파트너 설정 추가
- 다음으로 이동하세요: Singular > Attribution > Partner Configuration
- " Add a Partner "를 클릭한 후 다음을 입력하고 선택하세요: " OpenAI Ads (ChatGPT) "
- 대화 상자에서 설정할 앱과 앱/웹사이트(플랫폼)를 선택하세요. 이 연동은 모바일, 웹, PC, 콘솔 앱을 지원합니다
-
앱의 "
Pixel ID
" 및 "
Conversions API Key
" 값을 다음에서 복사해 붙여넣으세요:
OpenAI Ads Manager
.
-
필요한 경우 OpenAI로 전송할 추가 이벤트를 설정하고 "OpenAI Event Name"에 매핑하세요
- " Save "를 클릭해 완료하세요.
"OpenAI Ads (ChatGPT)"에 필요한 이벤트 속성
"OpenAI Ads (ChatGPT)" 연동에 필요한 이벤트 속성
OpenAI Ads(ChatGPT) 연동을 활성화하려면 다음 이벤트 속성을 구현하여 전송하세요. 대소문자를 구분합니다.
모바일
다음 이벤트 속성을 전송하세요:
-
ehash: 사용자 이메일 주소의 앞뒤 공백을 제거하고 소문자로 변환한 후 SHA-256으로 해시한 값입니다. -
external_id_hash(선택): 고객사 시스템에서 사용하는 안정적인 가명 고객 식별자를 SHA-256으로 해시한 값입니다.-
가능하다면 매칭률을 높이기 위해
ehash와external_id_hash를 모두 전송하세요. 만약ehash를 사용할 수 없다면 최소한external_id_hash를 전송하세요.
-
가능하다면 매칭률을 높이기 위해
웹
다음 이벤트 속성을 전송하세요:
-
page_url(필수): 이벤트가 발생한 페이지의 전체 URL입니다(예:https://shop.example.com/checkout/confirmation). -
ehash: 사용자 이메일 주소의 앞뒤 공백을 제거하고 소문자로 변환한 후 SHA-256으로 해시한 값입니다. -
external_id_hash(선택): 고객사 시스템에서 사용하는 안정적인 가명 고객 식별자를 SHA-256으로 해시한 값입니다.-
page_url는 필수입니다. 사용자 관련 필드의 경우, 가능하다면 매칭률을 높이기 위해ehash와external_id_hash를 모두 전송하세요. 만약ehash를 사용할 수 없다면 최소한external_id_hash를 전송하세요.
-
"ChatGPT Ads"용 Singular 링크 생성
"ChatGPT Ads"용 Singular 링크 생성
- 다음으로 이동하세요: Singular > Attribution > Manage Links
- 왼쪽 앱 목록에서 모바일 앱을 선택하세요
- 다음을 선택하세요: "Create Link" -> Link Type "Partner" -> Source Name "OpenAI Ads (ChatGPT)"
- 단계별 링크 생성 절차를 따라 진행하세요.
- 다음을 클릭하세요: "Generate"
- 다음 단계를 위해 "Click-through Tracking Link" 를 복사하세요
OpenAI Ads(ChatGPT Ads) 캠페인 설정
OpenAI Ads(ChatGPT Ads) 캠페인 설정
- OpenAI Ads Manager에서 캠페인을 생성한 후 Ad Group 단계로 진행하세요.
-
위에서 생성한 Singular 링크를 "Default Ad Destination URL"에 입력하세요:
자주 묻는 질문
Singular는 ChatGPT 어트리뷰션을 어떻게 리포팅하나요?
Pixel ID는 어디에서 확인할 수 있나요?
- 다음 페이지로 이동하세요: OpenAI Conversions 페이지.
-
"
Create
"를 선택한 후 "Data Source"를 선택하세요:
-
완료되면 새로 생성된 Pixel ID를 복사하세요:
Conversions API Key는 어디에서 확인할 수 있나요?
- 다음 페이지로 이동하세요: OpenAI Conversions 페이지.
-
"
Conversion keys
"를 선택한 후 "Create new key"를 선택하세요:
-
새로 생성한 키를 Singular의 Partner Configuration에 복사하세요:
Singular는 API를 통해 어떤 데이터를 전송하나요?
| 파라미터 | 상세 정보 |
|---|---|
| event_name |
|
| 해시된 이메일 |
|
| 해시된 외부 유저 ID |
|
| IP 주소 |
|
| 유저 에이전트 |
|
| 이벤트 중복 제거용(선택) | |
| event_id |
|