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를 사용하세요. 아래 웹과 모바일 앱에 별도의 Pixel ID가 필요한가요?를 참조하세요.
   
   
5. 필요한 경우 OpenAI로 전송할 추가 이벤트를 설정하고 "OpenAI Event Name"에 매핑하세요
   
   
6. " Save "를 클릭해 완료하세요.

"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 링크 생성

1. 다음으로 이동하세요: Singular > Attribution > Manage Links
2. 왼쪽 앱 목록에서 모바일 앱을 선택하세요
3. 다음을 선택하세요: "Create Link" -> Link Type "Partner" -> Source Name "OpenAI Ads (ChatGPT)"
4. 단계별 링크 생성 절차를 따라 진행하세요.
5. 리디렉션 대상을 설정하세요. 앱이 설치되어 있지 않은 유저가 이동하게 되는 위치입니다. 기본값은 앱의 스토어 URL입니다. 해당 유저를 웹사이트로 보내려면 Web URL 옵션을 선택하고 대상 주소를 입력하세요. 사이트에서 전환이 발생하는 웹 캠페인은 이 옵션을 사용합니다.
6. (선택) 필요한 추가 파라미터나 매크로는 Additional Parameters 섹션에서 추가하세요. 생성된 링크를 나중에 직접 수정하는 대신 여기에서 추가해야 합니다.
7. 다음을 클릭하세요: "Generate"
8. 다음 단계를 위해 "Click-through Tracking Link" 를 복사하세요

생성된 링크에는 캠페인 파라미터와 OpenAI Ads 동적 매크로가 이미 포함되어 있습니다. 모든 파라미터는 리디렉션 대상으로 전달되며, Singular Web SDK가 이를 읽어 웹 전환을 어트리뷰션합니다. 생성된 링크는 다음과 같은 형태입니다:

https://yourapp.sng.link/XXXXX/YYYY?_dl=yourapp%3A%2F%2Fmy_default_deeplink&_smtype=3&wpcl={oppref}&wpscid={ad_group_id}&pcid={campaign_id}&_forward_params=1&pscid={ad_group_id}&pcrid={ad_id}&wpcrid={ad_id}&cl={oppref}&wpsrc=ChatGPT%20Web%20CAPI&wpcid={campaign_id}

OpenAI Ads(ChatGPT Ads) 캠페인 설정

1. OpenAI Ads Manager에서 캠페인을 생성한 후 Ad Group 단계로 진행하세요.
2. 위에서 생성한 Singular 링크를 "Default Ad Destination URL"에 입력하세요:
   
3. 링크에 포함된 매크로는 그대로 두세요. OpenAI Ads가 클릭 시점에 {campaign_id}, {ad_group_id}, {ad_id}, {oppref} 를 치환하므로, 별도의 수동 작업 없이 캠페인 분류가 Singular로 전달됩니다.

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

• Source = "ChatGPT"
• Tracker Source Name = "ChatGPT"

1. 다음 페이지로 이동하세요: OpenAI Conversions 페이지.
2. " Create "를 선택한 후 "Data Source"를 선택하세요:
3. 완료되면 새로 생성된 Pixel ID를 복사하세요:
   

아니요. OpenAI Pixel ID는 플랫폼별이 아니라 광고주, 브랜드 또는 연동 파트너 대상별로 하나씩 사용하세요. Singular에서는 웹, iOS, Android 측정에 동일한 Pixel ID와 Conversions API Key를 사용합니다.

Singular는 각 이벤트에 플랫폼을 자동으로 설정합니다. 웹 이벤트에는 action_source: "web", iOS 및 Android 이벤트에는 action_source: "mobile_app" 이 사용됩니다. 이를 위해 별도로 설정할 항목은 없습니다.

OpenAI는 현재 네이티브 모바일 데이터 소스를 지원하지 않으므로, 앱 유형의 데이터 소스를 만들 수 없습니다. 웹 데이터 소스를 생성한 뒤 해당 Pixel ID를 측정하는 모든 플랫폼에 사용하세요.

1. 다음 페이지로 이동하세요: OpenAI Conversions 페이지.
2. " Conversion keys "를 선택한 후 "Create new key"를 선택하세요:
   
   
3. 새로 생성한 키를 Singular의 Partner Configuration에 복사하세요:
   
   

각 캠페인 기준은 링크에 두 번씩 나타납니다. 앱 측 파라미터는 앱 인스톨을 어트리뷰션하고, 웹 측 파라미터는 Singular Web SDK가 웹사이트에서 발생한 전환을 어트리뷰션할 때 읽는 값입니다. 하나의 링크가 두 가지 결과를 모두 처리합니다.

링크에는 다음 제어 파라미터도 포함됩니다:

• wpsrc=ChatGPT%20Web%20CAPI 는 Singular 웹 어트리뷰션의 Source를 지정하며, OpenAI Ads 포스트백이 작동하려면 반드시 필요합니다. 변경하지 마세요.
• _forward_params=1 은 링크 파라미터를 스토어 및 웹 리디렉션 대상으로 전달합니다.
• _dl 에는 앱이 설치되어 있을 때 링크가 여는 딥링크 대상이 들어갑니다.
• _smtype=3 은 트래킹 링크에 확률적 어트리뷰션이 활성화된 경우에 적용됩니다. 해당 링크에서 확률적 어트리뷰션을 비활성화하면 이 파라미터는 추가되지 않습니다.

트래킹 링크는 캠페인, 광고 그룹, 광고의 ID를 수집하며 이름은 수집하지 않습니다. Singular는 OpenAI Ads Data Connector에서 이름을 가져와 링크에서 수집된 ID와 매칭하므로, 리포트에서는 클릭과 인스톨에 대해 읽기 쉬운 이름이 표시됩니다.

이 때문에 이름은 링크에 포함되지 않습니다. ID는 안정적인 조인 키이므로, 캠페인 이름이 변경되어도 과거 클릭에 대해 계속 정확하게 리포팅됩니다.