TikTok 웹 이벤트 API 확장 개요

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

개발자

TikTok Edge Network API는 웹 사이트에서 사용자 작업에 대한 정보를 TikTok과(와) 직접 공유할 수 있는 보안 이벤트 서버 API 인터페이스입니다. 이벤트 전달 규칙을 사용하여 TikTok 웹 이벤트 API 확장을 사용하여 Adobe Experience Platform Edge Network에서 TikTok (으)로 데이터를 보낼 수 있습니다.

TikTok개 필수 구성 요소 prerequisites

TikTok 이벤트 API를 사용하도록 TikTok 웹 이벤트 API를 구성하려면 TikTok 픽셀 코드와 액세스 토큰을 생성해야 합니다.

파트너 설정을 사용하여 TikTok픽셀을 만들려면 비즈니스 계정에 대해 올바른 TikTok이(가) 있어야 합니다. 아직 계정이 없는 경우 등록하고 계정을 만들려면 TikTok 비즈니스 등록 페이지(으)로 이동하십시오.

파트너 설정을 사용하여 TikTok픽셀을 설정하려면 비즈니스 계정에 로그인해야 합니다. 이렇게 하려면 아래 단계를 수행합니다.

Assets 탭으로 이동하여 이벤트 를 선택합니다.
웹 이벤트에서 관리 를 선택합니다.
웹 이벤트 설정 을 선택합니다.
연결 방법으로 파트너 설정 을(를) 선택하십시오.

TikTok 픽셀을 설정하는 방법에 대한 자세한 내용은 픽셀 시작하기 안내서를 참조하십시오.

픽셀이 성공적으로 생성되면 액세스 토큰을 생성할 수 있습니다. 이렇게 하려면 픽셀로 이동하여 설정 탭을 선택합니다. Events API에서 액세스 토큰 생성 을 선택합니다.

픽셀 코드 및 액세스 토큰을 설정하는 방법에 대한 자세한 내용은 TikTok 시작 안내서를 참조하십시오.

TikTok 웹 이벤트 API 확장 설치 및 구성 install

확장을 설치하려면 왼쪽 탐색에서 확장 을 선택합니다. 카탈로그 탭에서 TikTok 웹 이벤트 API 확장 을 선택한 다음 설치 를 선택합니다.

설치를 강조 표시하는 TikTok 확장 카드를 표시하는 확장 카탈로그입니다.

다음 화면에서는 TikTok Ads Manager에서 이전에 생성한 다음 구성 값을 입력합니다.

픽셀 코드
액세스 토큰

완료되면 저장 을 선택합니다.

TikTok 웹 이벤트 API 확장에 대한 TikTok 구성 화면입니다.

이벤트 전달 규칙 구성 config-rule

모든 데이터 요소가 설정되면 이벤트가 TikTok에 전송되는 시기와 방법을 결정하는 이벤트 전달 규칙을 만들 수 있습니다.

이벤트 전달 속성에 새 규칙을(를) 만듭니다. 작업 에서 새 작업을 추가하고 확장을 TikTok 웹 이벤트 API 확장(으)로 설정합니다. Edge Network 이벤트를 TikTok에 보내려면 작업 유형 을(를) TikTok 웹 이벤트 API 이벤트 보내기.(으)로 설정하십시오.

데이터 수집 UI에서 TikTok 규칙에 대해 TikTok 웹 이벤트 API 이벤트 보내기 작업 유형을 선택하고 있습니다.

선택 후 아래 설명된 대로 이벤트를 추가로 구성하는 추가 제어 기능이 나타납니다. 완료되면 변경 내용 유지 를 선택하여 규칙을 저장합니다.

웹 이벤트 및 매개 변수

웹 이벤트와 매개 변수에는 이벤트에 대한 일반 정보가 포함되어 있습니다. 표준 이벤트는 TikTok 통합 도구에서 지원되며 보고, 전환 최적화 및 대상 작성에 사용할 수 있습니다.

입력

설명

이벤트 이름

이벤트의 이름입니다. TikTok에서 만든 미리 정의된 이름을 사용하는 작업이며 필수 필드입니다. 지원되는 이벤트에 대한 자세한 내용은 TikTok 마케팅 API 설명서를 참조하세요.

이벤트 시간

ISO 8601 또는 yyyy-MM-dd'T'HH:mm:ss:SSSZ 형식의 문자열로 표시된 날짜-시간입니다. 필수 필드입니다.

이벤트 ID

광고주가 각 이벤트를 표시하기 위해 생성한 고유 ID. 이 필드는 선택 사항이며 중복 제거에 사용됩니다.

필드에 입력된 데이터 예제를 보여 주는 Web Events and Parameters 섹션입니다.

사용자 컨텍스트 매개 변수

사용자 컨텍스트 매개 변수에는 웹 방문자 이벤트를 TikTok 사용자와 일치시키는 데 사용되는 고객 정보가 포함되어 있습니다. 여러 유형의 일치하는 데이터를 포함하면 타깃팅 및 최적화 모델의 정확도를 높일 수 있습니다.

입력

설명

IP 주소

해시되지 않은 브라우저의 공개 IP 주소입니다. IPv4 및 IPv6 주소에 대한 지원이 제공됩니다. IPv6 주소의 전체 형식과 압축 형식은 모두 인식됩니다.

사용자 에이전트

사용자 디바이스에서 해시되지 않은 사용자 에이전트.

이메일

전환 이벤트와 연계된 연락처의 이메일 주소.

휴대폰

해싱하기 전에 전화번호는 E164 형식 [+][국가 코드][지역 코드][local phone number]여야 합니다.

쿠키 ID

Pixel SDK를 사용하는 경우 쿠키가 활성화되면 _ttp 쿠키에 고유 식별자가 자동으로 저장됩니다. 이 필드에 대해 _ttp 값을 추출하여 사용할 수 있습니다.

외부 ID

사용자 ID, 외부 쿠키 ID 등과 같은 모든 고유 식별자는 SHA256으로 해시해야 합니다.

TikTok 클릭 ID

TikTok에서 광고를 선택할 때마다 랜딩 페이지의 URL에 추가되는 ttclid입니다.

페이지 URL

이벤트 시 페이지 URL입니다.

페이지 레퍼러 URL

페이지 레퍼러의 URL입니다.

필드에 입력된 데이터 예제를 보여 주는 User Context Parameters 섹션입니다.

속성 매개 변수

지원되는 추가 속성을 구성하려면 속성 매개 변수를 사용하십시오.

입력

설명

가격

단일 항목의 비용.

수량

이벤트에서 구매 중인 항목 수입니다. 0보다 큰 양수여야 합니다.

콘텐츠 유형

제품 카탈로그를 설정할 때 데이터 피드를 구성하는 방법에 따라 product 또는 product_group 값을 content_type 개체 속성에 할당해야 합니다.

컨텐츠 ID

제품 항목에 대한 고유 식별자.

컨텐츠 범주

페이지/제품 범주.

컨텐츠 이름

페이지/제품 이름.

통화

이벤트에서 구매 중인 항목의 통화입니다. 이는 ISO-4217에 표시되어 있습니다.

값

주문의 총 가격. 이 값은 가격 * 수량과 같습니다.

설명

항목 또는 페이지에 대한 설명.

쿼리

제품을 조회하는 데 사용된 텍스트 문자열입니다.

상태

주문, 품목 또는 서비스의 상태. 예: "제출됨".

필드에 입력된 데이터 예제를 보여 주는 Properties Parameters 섹션입니다.

이벤트 중복 제거 deduplication

TikTok픽셀 SDK와 TikTok 웹 이벤트 API 확장을 모두 사용하여 동일한 이벤트를 TikTok에 보내는 경우 중복 제거에 대해 TikTok픽셀을 설정해야 합니다.

클라이언트 및 서버에서 중복되지 않고 개별 이벤트 유형을 보내는 경우에는 중복 제거가 필요하지 않습니다. 보고에 부정적인 영향을 주지 않도록 하려면 TikTok 픽셀 SDK 및 TikTok 웹 이벤트 API 확장에서 공유하는 단일 이벤트가 중복 제거되었는지 확인해야 합니다.

공유 이벤트를 보낼 때 모든 이벤트에 픽셀 ID, 이벤트 ID 및 이름이 포함되어 있는지 확인하십시오. 서로 5분 이내에 도착하는 중복 이벤트는 병합됩니다. 데이터 필드가 첫 번째 이벤트에 없으면 후속 이벤트와 결합됩니다. 48시간 이내에 수신되는 중복 이벤트는 모두 제거됩니다.

이 프로세스에 대한 자세한 내용은 이벤트 중복 제거의 TikTok 설명서를 참조하십시오.

다음 단계

이 안내서에서는 TikTok 웹 이벤트 API 확장을 사용하여 서버측 이벤트 데이터를 TikTok에 보내는 방법을 다룹니다. Adobe Experience Platform의 이벤트 전달 기능에 대한 자세한 내용은 이벤트 전달 개요를 참조하세요.

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743