# cPixel에 TikTok 픽셀과 Events API 연결하기 {#doc-title}

작성자: [B2B Gold](/about/#how-we-write) 업데이트: 2026년 9월 26일 [AI 도구로 영어에서 번역](/docs/cpixel/connect-tiktok/) [cPixel 페이지](/shopify/cpixel/) [Shopify App Store의 cPixel](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=ko/docs/cpixel/connect-tiktok&utm_term=docs-header)

## cPixel에 TikTok은 어떻게 연결하나요? {#how-do-i-connect-tiktok-to-cpixel}

스토어의 Ads Manager 계정에서 TikTok 이벤트 관리자를 열고 Datasets overview에서 픽셀 ID를 복사한 뒤, 데이터 세트의 Settings, Data connection을 열어 TikTok Pixel 옵션 두 가지를 지나쳐 Events API까지 스크롤해 액세스 토큰을 발급받습니다. 둘 다 cPixel에 붙여넣으세요. 토큰이 없으면 cPixel은 TikTok에 아무것도 전송하지 않습니다.

### cPixel에 붙여넣기 {#paste-them-into-cpixel}

1. cPixel에서 **전송 대상**을 열고 **플랫폼 연결** 아래 TikTok 아이콘을 클릭합니다. **TikTok 설정**이 **ID 붙여넣기**에서 열립니다.
2. 픽셀 ID를 **픽셀 코드**에, 토큰을 **Events API 액세스 토큰**에 붙여넣습니다. 토큰은 필수입니다: TikTok의 픽셀은 Shopify의 웹 픽셀 샌드박스에서 실행될 수 없기 때문입니다. 원한다면 **이 계정의 이름(선택 사항)**에 이름을 붙인 뒤 **계속**을 클릭합니다.
3. **옵션 선택하기**에서 **서버에서 이벤트 전송**을 켠 상태로 둡니다. **브라우저에서 이벤트 전송**을 켜면 cPixel 앱 임베드가 필요한 TikTok의 스토어프론트 태그가 추가됩니다. Shopify의 TikTok 앱이 이 픽셀로 전송하고 있지 않다면 **아니요 — cPixel이 TikTok을 처리합니다(추천)**를 유지하세요: 이름과 달리 **예 — 그대로 두고, cPixel은 TikTok 서버 측 전송을 중단합니다**를 선택하면 cPixel의 브라우저·서버 전송이 모두 중단됩니다.
4. **저장하고 계속**을 클릭합니다. **테스트하기**를 하면 **TikTok 연결 완료**가 확인됩니다.

> **참고:** **테스트 이벤트 코드(선택 사항)**는 오직 **연결 테스트**에만 사용되며, 실제 테스트 이벤트 1건을 픽셀의 **Test Events** 탭으로 전송합니다(`TEST`로 시작하는 코드를 그곳에서 복사하세요). 그리고 7일간 활동이 없는 계정에 대한 cPixel의 야간 점검에도 사용됩니다. 필드의 안내 문구와 무관하게 실제 이벤트에는 이 코드가 절대 붙지 않습니다.

## 내 TikTok 픽셀 ID는 어디서 찾나요? {#where-do-i-find-my-tiktok-pixel-id}

TikTok 이벤트 관리자에서 각 데이터 세트 이름 아래에 20자리 영문자와 숫자로 표시됩니다. TikTok의 메뉴를 사용하세요: 이벤트 관리자 주소를 직접 입력하면 종종 “Page not found”로 끝납니다.

1. [TikTok Ads Manager](https://ads.tiktok.com/)에 로그인합니다. **Select an account**에서 이 스토어의 소유주인 **Business Center**가 아니라 **Ads Manager** 계정을 선택합니다.
2. 왼쪽 상단의 그리드 아이콘을 열고 **Events Manager**를 선택합니다.
3. 이벤트 관리자 홈 페이지의 **Datasets overview**에는 각 데이터 세트 이름 아래 Pixel ID가 표시됩니다.
4. 왼쪽 메뉴의 **Data sources**에는 모든 데이터 세트가 Pixel ID와 생성 시각과 함께 나열됩니다.

## Events API 액세스 토큰은 어떻게 발급받나요? {#how-do-i-get-an-events-api-access-token}

데이터 세트 설정의 TikTok Pixel 옵션 아래에 있는 **Events API** 블록에서 발급합니다. TikTok 자체 가이드: [Get started with Events API](https://ads.tiktok.com/help/article/getting-started-events-api).

1. 데이터 세트를 클릭한 뒤 **Settings** → **Data connection**을 엽니다.
2. **Partner integration**과 TikTok Pixel의 두 옵션, *Option 1: With Event Builder*와 *Option 2: With custom code*를 지나쳐 **Events API**까지 스크롤합니다.
3. **Generate access token**을 클릭하고 긴 토큰을 cPixel에 복사합니다.

## Events API 섹션을 찾을 수 없는 이유는 무엇인가요? {#why-cant-i-find-the-events-api-section}

대개는 생각보다 더 아래에 있으니 계속 스크롤하세요. 정말 없다면 픽셀을 관리할 권한이 없는 것입니다.

**TikTok Pixel**의 두 옵션이 화면을 가득 채워 페이지가 일찍 끝난 것처럼 보입니다. 맨 아래에 블록이 전혀 없다면 광고 계정에 대한 TikTok의 필수 [Admin 또는 Operator 권한](https://business-api.tiktok.com/portal/docs?id=1771101130925058)이 없는 것입니다. Business Center가 픽셀을 소유하고 있다면 관리자에게 [픽셀을 공유](https://ads.tiktok.com/help/article/how-to-share-a-pixel-in-business-center-with-a-member)해 관리 권한을 달라고 요청하세요.

## cPixel은 TikTok에 무엇을 전송하나요? {#what-does-cpixel-send-to-tiktok}

cPixel의 서버는 Events API를 통해 모든 것을 전송합니다: Pageview, ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, 그리고 Shopify 주문으로 구성한 구매인 CompletePayment까지. 앱 임베드가 켜져 있으면 TikTok의 스토어프론트 태그도 각 Pageview를 브라우저에서 전송하며 서버 사본과 이벤트 ID를 공유합니다.

CompletePayment는 TikTok이 Purchase에 붙였던 예전 이름입니다. TikTok은 여전히 이를 받아들이며 Purchase로 보고합니다([TikTok](https://ads.tiktok.com/resources/help/article/how-to-adopt-tiktoks-updated-standard-events?lang=en)).

서버 이벤트에는 알고 있는 경우 해시 처리된 이메일과 전화번호, 해시 처리된 Shopify 고객 및 기기 ID, TikTok의 `_ttp` 쿠키와 `ttclid` 클릭 ID, IP 주소와 사용자 에이전트가 포함됩니다. 두 경로 모두 마케팅 동의가 필요합니다. 브라우저에서 cPixel 자체 요청을 막는 광고 차단 프로그램은 열람 이벤트를 막지만, 구매는 Shopify의 주문에서 옵니다.

TikTok은 같은 픽셀, 이벤트, 이벤트 ID를 가진 첫 이벤트를 유지하고 48시간 동안 반복분을 제거하며, 5분 이내에 도착한 이벤트는 병합을 시도합니다([TikTok](https://business-api.tiktok.com/portal/docs/event-deduplication/v1.3)).

> **중요:** Shopify의 TikTok 앱도 자체 픽셀로 전송하며, Enhanced와 Maximum 데이터 공유 수준에서는 Events API도 추가합니다([TikTok](https://ads.tiktok.com/help/article/data-sharing-tiktok-app-shopify)). 이벤트 ID가 cPixel의 것과 다르므로 [픽셀 하나에 전송 주체 하나](/ko/docs/cpixel/official-channel-apps/)를 유지하세요.

## 작동했는지는 어떻게 확인하나요? {#how-do-i-check-it-worked}

cPixel의 **라이브**에서 각 전송과 TikTok의 응답을 확인한 뒤 TikTok 이벤트 관리자를 확인하세요.

1. cPixel에서 **라이브**를 열고 **세션 시작**을 클릭한 뒤 다른 탭에서 스토어를 둘러봅니다. **서버** 행을 엽니다: **수락됨**은 TikTok의 성공 코드인 코드 0을 반환했다는 뜻입니다([TikTok](https://business-api.tiktok.com/portal/docs/responses-and-errors/v1.3)).
2. 구매를 보려면 실제 주문을 하세요. 테스트 주문은 기본적으로 건너뜁니다.
3. 이벤트 관리자에서 픽셀의 **Overview**를 엽니다: cPixel의 이벤트는 연결 방식 **Server**로 표시되고, 스토어프론트 태그가 켜져 있으면 페이지 조회는 **Server & Browser**로 표시됩니다([TikTok](https://business-api.tiktok.com/portal/docs/events-api-v2-web-setup-verification/v1.3)). 집계에는 최대 10분, 처리에는 최대 2시간이 걸릴 수 있습니다([TikTok](https://ads.tiktok.com/resources/help/article/how-to-troubleshoot-pixel-visibility-in-tiktok-ads-manager)).

**전송 대상**은 첫 성공적인 서버 전송 이후 계정을 **확인됨**으로 표시합니다. **Test Events**에는 **연결 테스트**의 이벤트만 표시되며 실제 트래픽은 절대 나타나지 않습니다.

## 작동하지 않으면 어떻게 하나요? {#what-if-it-doesnt-work}

TikTok이 cPixel의 이벤트를 받지 못하고 있다면 **홈**을 확인한 뒤, TikTok의 코드와 메시지가 표시되는 **라이브**의 TikTok 행을 확인하세요.

| 화면에 표시되는 내용 | 의미 | 해야 할 일 |
| --- | --- | --- |
| 토큰 또는 권한 오류와 함께 **거부됨**; 홈에는 계정에 **확인이 필요합니다**로 표시됨 | TikTok이 토큰을 거부했습니다: 취소되었거나 다른 광고 계정의 것입니다(코드 40001은 권한 없음을 의미). cPixel은 해당 계정으로의 서버 전송을 일시중지하고 스토어 연락처 주소로 이메일을 보냅니다 | 이 픽셀의 **Settings**에서 새 토큰을 발급받으세요. **홈**의 **TikTok 수정**을 클릭하거나 **전송 대상**에서 계정 옆 **관리**를 클릭한 뒤 붙여넣고 **계속**과 **저장하고 계속**을 클릭합니다 |
| 코드 40002, 잘못된 페이로드와 함께 **거부됨** | TikTok이 이벤트 1건을 거부했습니다: 이후 이벤트는 계속 전송됩니다 | 반복되면 **홈** → **도움 받기** → **지원팀에 문의** |
| 사유와 함께 **건너뜀** | cPixel이 전송하지 않기로 선택했습니다. 예: 동의 없음 또는 테스트 주문 | 실제로 결제하거나 **설정** → **테스트 주문**의 선택을 해제하세요 |
| 브라우저 페이지 조회가 없음 | 앱 임베드가 꺼져 있고 홈에 **스토어에서 향상된 추적이 꺼져 있습니다**가 표시됨 | **켜기**를 클릭하세요. 서버 전송은 계속됩니다 |
| 라이브에서 **수락됨**이지만 2시간 후에도 TikTok에 나타나지 않음 | 이벤트가 다른 데이터 세트로 전송되었습니다 | **픽셀 코드**를 **Datasets overview**의 Pixel ID와 비교하세요 |

**TikTok 관리**의 **제거**는 해당 계정으로의 전송을 중단하고 토큰을 삭제합니다.

## 관련 문서 {#related}

- [Shopify에 TikTok 픽셀과 Events API 설정하기](/blog/tiktok-pixel-shopify/)
- [라이브에서 각 전송 확인하기](/ko/docs/cpixel/live-events/)
- [픽셀 하나에 전송 주체 하나](/ko/docs/cpixel/official-channel-apps/)
- [cPixel이 각 구매를 한 번만 집계하는 방법](/ko/docs/cpixel/deduplication/)

[cPixel Facebook Pixel CAPI GA4](/shopify/cpixel/)

[Shopify App Store에서 무료로 설치](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=ko/docs/cpixel/connect-tiktok&utm_term=card) [요금제 및 가격](/shopify/cpixel/#pricing)

cPixel 관련 도움이 필요하신가요? [support@b2bgold.app](mailto:support@b2bgold.app)(으)로 이메일을 보내 주세요.