OpenAI Ads(ChatGPT) 어트리뷰션 및 CAPI

이 문서에서는 모바일 앱 캠페인, PC/콘솔 인스톨, 웹 캠페인을 대상으로 Singular의 어트리뷰션 및 Conversions API를 사용해 OpenAI Ads(ChatGPT) 캠페인을 설정하는 방법을 설명합니다.

개요

Singular의 웹-투-앱 어트리뷰션 솔루션을 사용하면 마케터가 모바일, PC, 콘솔 플랫폼에서 앱 인스톨을 유도하는 웹 캠페인을 운영할 수 있습니다. Singular의 OpenAI Ads 웹-투-앱 연동은 다음 문서에서 설명하는 Direct to Store 플로우를 지원합니다: 웹-투-앱 가이드 보기 .

Singular에서 ChatGPT 파트너 설정 추가

Singular에서 ChatGPT Ads 파트너 설정 추가

  1. 다음으로 이동하세요: Singular > Attribution > Partner Configuration
  2. " Add a Partner "를 클릭한 후 다음을 입력하고 선택하세요: " OpenAI Ads (ChatGPT) "
  3. 대화 상자에서 설정할 앱과 앱/웹사이트(플랫폼)를 선택하세요. 이 연동은 모바일, 웹, PC, 콘솔 앱을 지원합니다
  4. 앱의 " Pixel ID " 및 " Conversions API Key " 값을 다음에서 복사해 붙여넣으세요: OpenAI Ads Manager .
    Pixel ID와 Conversions API Key 필드가 입력된 Singular의 OpenAI Ads(ChatGPT) 파트너 설정
  5. 필요한 경우 OpenAI로 전송할 추가 이벤트를 설정하고 "OpenAI Event Name"에 매핑하세요
    매출 이벤트와 인앱 이벤트를 OpenAI 이벤트 이름에 매핑하고 Send All 및 Include Revenue를 활성화한 Singular 포스트백 설정
  6. " Save "를 클릭해 완료하세요.
"OpenAI Ads (ChatGPT)"에 필요한 이벤트 속성

"OpenAI Ads (ChatGPT)" 연동에 필요한 이벤트 속성

OpenAI Ads(ChatGPT) 연동을 활성화하려면 다음 이벤트 속성을 구현하여 전송하세요. 대소문자를 구분합니다.

모바일

다음 이벤트 속성을 전송하세요:

  • ehash : 사용자 이메일 주소의 앞뒤 공백을 제거하고 소문자로 변환한 후 SHA-256으로 해시한 값입니다.
  • external_id_hash (선택): 고객사 시스템에서 사용하는 안정적인 가명 고객 식별자를 SHA-256으로 해시한 값입니다.
    • 가능하다면 매칭률을 높이기 위해 ehashexternal_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 는 필수입니다. 사용자 관련 필드의 경우, 가능하다면 매칭률을 높이기 위해 ehashexternal_id_hash 를 모두 전송하세요. 만약 ehash 를 사용할 수 없다면 최소한 external_id_hash 를 전송하세요.
"ChatGPT Ads"용 Singular 링크 생성

"ChatGPT Ads"용 Singular 링크 생성

  1. 다음으로 이동하세요: Singular > Attribution > Manage Links
  2. 왼쪽 앱 목록에서 모바일 앱을 선택하세요
  3. 다음을 선택하세요: "Create Link" -> Link Type "Partner" -> Source Name "OpenAI Ads (ChatGPT)"
  4. 단계별 링크 생성 절차를 따라 진행하세요.
  5. 다음을 클릭하세요: "Generate"
  6. 다음 단계를 위해 "Click-through Tracking Link" 를 복사하세요
OpenAI Ads(ChatGPT Ads) 캠페인 설정

OpenAI Ads(ChatGPT Ads) 캠페인 설정

  1. OpenAI Ads Manager에서 캠페인을 생성한 후 Ad Group 단계로 진행하세요.
  2. 위에서 생성한 Singular 링크를 "Default Ad Destination URL"에 입력하세요:
    Default Ad Destination URL에 Singular sng.link 트래킹 링크를 입력한 OpenAI Ads 신규 캠페인 광고 그룹 설정

자주 묻는 질문

Singular는 ChatGPT 어트리뷰션을 어떻게 리포팅하나요?

어트리뷰션이 트래킹되면 ChatGPT 어트리뷰션은 다음과 같이 리포팅됩니다:

  • Source = "ChatGPT"
  • Tracker Source Name = "ChatGPT"
Pixel ID는 어디에서 확인할 수 있나요?
  1. 다음 페이지로 이동하세요: OpenAI Conversions 페이지.
  2. " Create "를 선택한 후 "Data Source"를 선택하세요: OpenAI Ads Manager의 Conversions 페이지. Create new data source 창에서 Web 데이터 소스 이름을 Singular Pixel로 지정하고 있습니다
  3. 완료되면 새로 생성된 Pixel ID를 복사하세요:
    이름 아래에 Pixel ID가 표시된 OpenAI Ads Manager의 Singular Pixel 데이터 소스 목록
Conversions API Key는 어디에서 확인할 수 있나요?
  1. 다음 페이지로 이동하세요: OpenAI Conversions 페이지.
  2. " Conversion keys "를 선택한 후 "Create new key"를 선택하세요:
    이름이 Singular Conversions API Key로 입력된 OpenAI Ads Manager의 Create New Conversion Key 창
  3. 새로 생성한 키를 Singular의 Partner Configuration에 복사하세요:
    생성된 키와 Copy, Download 버튼이 표시된 OpenAI Ads Manager의 Save your key 창
Singular는 API를 통해 어떤 데이터를 전송하나요?
파라미터 상세 정보
event_name
  • 표준 이벤트 또는 커스텀 이벤트 이름입니다. 이 필드는 Singular Event Name에 자동으로 매핑됩니다. 이 값은 OpenAI가 이벤트를 중복 제거하는 데 사용됩니다. event_id 파라미터도 중복 제거에 사용됩니다.
해시된 이메일
  • 선택
  • 해시된 이메일은 Singular에서 계측한 이벤트 속성 "ehash"로 전달할 수 있습니다
  • 해시된 이메일 값은 정규화한 후 SHA-256으로 해시해야 합니다
해시된 외부 유저 ID
  • 선택
  • 해시된 외부 ID는 Singular에서 계측한 이벤트 속성 "external_id_hash"로 전달할 수 있습니다
IP 주소
  • 클라이언트 IP 주소
유저 에이전트
  • 클라이언트 User-Agent
이벤트 중복 제거용(선택)
event_id
  • 중복 제거에 필요한 파라미터
  • event_id 값을 다음 속성 이름을 사용해 Event Arguments로 Singular에 전달하세요: " eventId ".
  • event_id 파라미터는 Conversions API와 OpenAI Pixel 양쪽 모두에서 이벤트에 추가해야 합니다.
  • event_id 파라미터는 유사한 이벤트를 고유하게 구분할 수 있는 식별자입니다.