한국어
광고 생성

웹 측정

  1. 측정 /
  2. 웹 측정 /
  3. 웹 이벤트 및 파라미터 /

파라미터 정보

마지막 업데이트: 2025 년 4 월

파라미터는 어떠한 이벤트와도 쌍으로 구성하여 캠페인 성과에 영향을 줄 수 있는 속성입니다. 특정 파라미터가 필요하며 다른 파라미터는 성과를 개선하기 위해 적극 권장됩니다.


파라미터 실행을 위한 개발자 설명서에 대해 자세히 알아보세요.


사용 가능한 파라미터:

  • content_type: "product" 또는 "product_group"으로 설정되어야 하는 값입니다. sku_id를 "content_ids" 또는 "contend_id"로 사용하는 경우 "product"를 사용하고, item_group_id를 "content_ids" 또는 "contend_id"로 사용하는 경우 "product_group"을 사용합니다. 이 필드는 동영상 쇼핑 광고(VSA)에 필요합니다.

  • contents: 제품 정보와 함께 웹 이벤트에서 관련 제품을 나타내는 콘텐츠 개체 목록입니다. 값은 개체의 배열이어야 합니다. 이 필드는 동영상 쇼핑 광고(VSA)에 필요합니다.

  • content_ids: 고유한 ID 또는 제품이나 콘텐츠의 여러 ID의 배열입니다(예: ['987','654']). 하나의 ID 또는 ID의 배열 전송 여부에 관계없이 'content_ids'에 's'를 포함해야 합니다. 사용 가능한 경우 카탈로그에서 설정한 sku_id/item_group_id와 매칭되는 sku_id 또는 item_group_id를 사용하는 것을 권장합니다. 이 필드는 동영상 쇼핑 광고(VSA)에 필요합니다.

  • delivery_category: 파라미터 delivery_category를 사용하여 온라인 구매의 배송 방법을 나타낼 수 있습니다. 이 파라미터는 커브사이드 픽업, 매장 내 픽업 또는 가정 배송과 같은 배송 방법에 따른 구매를 추적하는 데 도움이 됩니다.

  • price value: price는 단일 품목의 가격이고, value는 주문의 총 가격입니다. 예를 들어, 각각 $10에 판매되는 2개의 품목이 있는 경우 price 파라미터는 10을, value 파라미터는 20을 전달합니다. 값 유형은 숫자여야 합니다. 이 필드는 ROAS 및 가치 기반 최적화(VBO)에 필요합니다.

  • quantity: 결제 시작 시 품목의 수량을 지정하는 데 사용합니다.

  • content_name: 페이지, 제품의 이름입니다. 값 유형은 문자열이어야 합니다.

  • content_category: 제품/페이지의 분류입니다. 값 유형은 문자열이어야 합니다.

  • currency: ISO 4127 코드입니다. 다음 섹션에는 현재 지원되는 통화의 목록이 포함되어 있습니다. 값 유형은 enum(문자열)이어야 합니다. 이 필드는 ROAS에 필요합니다.

  • search_string: 사용자가 검색을 위해 입력한 문자열로 검색 이벤트와 함께 사용합니다.

  • description: 품목 또는 페이지의 설명 문자열입니다.

  • status: 주문, 품목 또는 서비스의 상태입니다. 값 유형은 문자열이어야 합니다.

    • 참고: 'status'의 사용에 따라 TikTok에 상태 변경을 공유하기 위해 이벤트 API가 필요할 수 있습니다.


현재 TikTok이 지원하는 통화: AED, ARS, AUD, BDT, BHD, BIF, BOB, BRL, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DZD, EGP, EUR, GBP, GTQ, HKD, HNL, HUF, IDR, ILS, INR, ISK, JPY, KES, KHR, KRW, KWD, KZT, MAD, MOP, MXN, MYR, NGN, NIO, NOK, NZD, OMR, PEN, PHP, PKR, PLN, PYG, QAR, RON, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, VES, VND, ZAR


동적 이벤트 관련 값을 TikTok에 전달하는 동적 값을 설정할 수 있습니다. 웹사이트 개발자에게 확인하여 동적 값을 설정하거나 TikTok 자체 서비스 이벤트 작성기 도구를 사용하세요. 설정된 값을 사용하는 대신 이 동적 코드가 구매 가격과 같은 올바른 이벤트 값을 자동으로 결정합니다. 당사의 기술 가이드를 사용해 코드로 동적 값을 설정할 수도 있습니다.


예를 들어 방문자가 웹사이트에 랜딩하여 장바구니에 드레스를 담는 경우가 있습니다. 다음은 정적 또는 설정된 값이 어떻게 나타나는지 보여줍니다.

Standard Events and Parameters - Code 1

이러한 값을 동적으로 만들려면 'dress' 또는 '8'과 같은 올바른 값을 자동으로 전달하는 코드로 설정 값을 교체합니다.

Standard Events and Parameters - Code 2

관련 기사
Integrace partnerů pro webové události
Jak nastavit TikTok Pixel se Správcem značek Google ve Správci událostí TikTok
Tvůrce událostí TikTok