OpenAI Ads 정보는 어디서 찾나요?
OpenAI Ads에는 Pixel ID와 Conversions API 키가 필요합니다. cPixel은 서버에서 구매를 전송하며, 테마 앱 임베드를 켜면 스토어의 탐색 이벤트도 브라우저 태그로 함께 전송합니다.
- Pixel ID 영문자와 숫자 22자, 예: CxHP7ickCLR1SJhZKZ61Hg
- Conversions API 키 sk-svcacct-…로 시작
스크린샷은 실제 계정에서 캡처한 것입니다. 계정 이름, ID, 토큰, 이메일 주소는 가려져 있습니다 — 실제 화면에는 이 자리에 진짜 값이 표시됩니다.
-
Tools → Conversions 열기
왼쪽 메뉴에서 Tools를 펼치고 Conversions를 선택하세요. 아래 내용은 모두 이 한 페이지에 있습니다.
Ads Manager 메뉴의 Tools → Conversions입니다. -
Data Source 탭에서 Pixel ID 복사하기
Data Source 탭에는 데이터 소스 목록이 표시되며, 각 이름 아래에 회색 글자로 ID가 표시됩니다. 이 회색 문자열이 cPixel에 필요한 Pixel ID입니다 — 주소창에 표시되는 광고 계정 ID가 아닙니다.
Pixel ID는 데이터 소스 이름 아래에 있습니다. -
Conversion keys 열기
페이지 헤더에서 Warnings 옆의 key 아이콘을 클릭하세요. 패널에 기존 키 목록이 마스킹된 상태로 표시됩니다 — OpenAI는 기존 키를 다시 보여주지 않으므로, 저장해 두지 않았다면 새로 만들어야 합니다.
기존 키는 앞뒤 일부 문자만 남기고 마스킹되어 표시됩니다. -
키를 생성하고 즉시 복사하기
Create new key를 클릭해 이름을 지정한 다음 대화상자에 표시되는 값을 복사하세요. 한 번만 표시됩니다. 이 값과 Pixel ID를 cPixel에 붙여넣으세요.
지금 복사해 두세요 — 이 대화상자는 다시 열리지 않습니다.
“Ads cannot serve until you finish account setup”는 지금 진행을 막는 메시지가 아닙니다
새로 만든 OpenAI Ads 계정에는 결제 정보와 로고를 설정하기 전까지 이 배너가 표시됩니다. 이는 광고 노출을 막는 것이지 Conversions API를 막는 것이 아닙니다 — 이 배너가 표시된 상태에서도 키를 생성하고 cPixel을 연결할 수 있습니다.
알아두면 좋은 점
- 체크아웃과 구매 이벤트는 항상 Conversions API에서만 전송되며 브라우저 태그에서는 절대 전송되지 않습니다: 테마는 Shopify의 체크아웃이나 감사 페이지에서 실행될 수 없으므로, 그렇지 않으면 이 두 이벤트는 OpenAI에 전혀 도달하지 못하게 됩니다. cPixel 테마 앱 임베드를 켜면 스토어에서 발생하는 페이지 조회, 상품 조회, 장바구니 담기 이벤트가 추가되는데, 이는 서버 측 전송 경로가 절대 전송하지 않는 이벤트이므로 둘이 같은 이벤트를 중복 보고하는 일은 없습니다.
- 쇼핑객의 브라우저가 광고 차단 프로그램이나 필터링된 네트워크 등으로 OpenAI 태그를 아예 불러오지 못하면, cPixel이 해당 페이지 조회나 장바구니 담기 이벤트를 저희 서버에서 대신 전송합니다. 이는 그럴 때만 해당됩니다: 태그가 이미 전송한 이벤트는 다시 전송되지 않으므로 중복 집계되지 않습니다. 브라우저 태그는 응답을 읽지 않고 전송하므로, cPixel은 OpenAI가 이벤트 자체를 거부하는 경우를 알 수 없습니다.
- OpenAI는 매칭 품질 점수를 공개하지 않습니다 — Events Manager에 해당하는 화면도, 진단 페이지도, cPixel이든 다른 어떤 앱이든 가져올 수 있는 수치도 없습니다. 대신 cPixel의 이벤트 품질 페이지가 이를 직접 측정합니다: 이벤트마다 실제로 전송된 매칭 식별자와 누락된 식별자를 보여주므로, OpenAI가 무엇을 기준으로 매칭해야 했는지 확인할 수 있습니다.
- OpenAI는 주로 랜딩 페이지 URL에 포함된 클릭 참조값으로 판매를 광고와 매칭합니다 — OpenAI 자체 가이드에서도 이를 해시 처리된 이메일보다 우선순위 높게 다룹니다. 테마 앱 임베드를 켜면 OpenAI 태그가 이 참조값을 스토어 도메인의 퍼스트파티 쿠키에 저장하며, cPixel은 URL뿐 아니라 이 쿠키에서도 값을 읽어오므로 쇼핑객이 저장소를 지우거나 www와 루트 도메인 사이를 오가도 값이 유지됩니다.
- 이벤트 타임스탬프는 최근 7일 이내여야 하며, 이는 cPixel의 재시도 기간보다 충분히 짧습니다.
- 이 패널에서 키를 삭제하면 즉시 폐기됩니다. 새 키를 먼저 만든 뒤 교체하세요.
서버 측 API 토큰 cPixel이 지금 사용 중
이미 가지고 있습니다 — 4단계에서 만든 Conversions API 키가 곧 서버 측 인증 정보이며, 구매를 전달하는 것이 바로 이 키입니다. 브라우저 태그에는 인증 정보가 필요 없습니다: Pixel ID만 있으면 충분하며, 스토어에서만, 그리고 테마에서 cPixel 앱 임베드가 켜져 있을 때만 실행됩니다. 이 키는 쇼핑객의 브라우저가 태그를 불러오지 못했을 때 cPixel이 재전송하는 스토어 이벤트도 함께 전달하므로, 키가 없으면 이 이벤트들도 함께 유실됩니다.
작동 확인하기
cPixel에서 라이브 세션을 시작하고 테스트 주문을 진행하세요. OpenAI로의 전송에서 응답을 확인할 수 있으며, Ads Manager의 Event Stream 탭에는 도착한 내용이 표시됩니다. 앱 임베드를 켜면 스토어의 페이지 조회도 여기에 표시됩니다 — 다만 스토어에서 발생한 것만 해당되므로 체크아웃 페이지의 조회는 표시되지 않습니다.
OpenAI Ads의 공식 문서
cPixel이란
cPixel은 스토어의 이벤트를 추적해 광고 플랫폼에 보고하는 Shopify 앱입니다 — 쇼핑객의 브라우저에서 그리고 각 플랫폼의 Conversions API를 통해 저희 서버에서도 전송합니다. 브라우저 추적은 모든 요금제에서 무료이며 제한이 없습니다. 서버 측 전송은 유료 요금제에서 추가되는 기능이며, 브라우저가 픽셀을 차단하거나 태그를 누락하거나 아예 실행하지 못할 때도 전환이 계속 도착하도록 해줍니다.
- 두 전송 경로 모두 동일한 이벤트 ID. 모든 구매는 브라우저와 서버에서 같은 결정론적 ID로 전송되므로, 플랫폼은 전환을 두 번 집계하지 않고 하나로 유지합니다.
- 모든 서버 전송을 실시간으로 확인. 디버그 세션을 열면 각 이벤트가 나가는 과정을 그대로 지켜볼 수 있습니다: 페이로드, 플랫폼의 응답, 중복 제거 여부, 그리고 정확히 어떤 매칭 파라미터가 포함되었는지까지. Free 요금제에서도 제공됩니다 — 비용을 지불하기 전에 cPixel이 무엇을 전송하는지 확인할 수 있습니다.
- 모든 요금제에서 모든 플랫폼 사용 가능. 요금제의 차이는 단 하나, 월간 포함되는 주문 수뿐입니다. 어떤 기능, 플랫폼, 계정 한도도 가격에 좌우되지 않으며, 모든 요금제에서 플랫폼당 최대 10개 계정을 연결할 수 있습니다.
- 테마에 설치할 것이 없습니다. 추적은 Shopify 자체의 웹 픽셀과 앱 임베드 기능을 통해 이루어집니다 — 스크립트 태그도, 테마 파일 수정도 없으며, 깔끔하게 제거됩니다.
요금은 월간 주문 수로만 결정됩니다 — 트래픽도, Shopify 요금제도, 연결한 플랫폼 수도 영향을 주지 않습니다. Free로 설치하면 처음 7일은 한도 없이 사용할 수 있으며, 유료 요금제에서는 한도를 초과해도 서버 측 전송이 절대 중단되지 않습니다.