광고 플랫폼 연동 가이드

Shoplive Player를 광고 플랫폼과 연동할 때, 광고 트래킹 정보를 정확하게 수집하기 위해 다음 사항들을 꼭 확인해 주세요.

1. 광고 트래킹 정보의 Query 파라미터 전달

광고 플랫폼에서 Shoplive 링크로 이동 시, URL에는 다양한 트래킹 정보가 query string 형태로 포함됩니다.

광고 LINK 예시:

https://shoplive.show/player.html?ak={ACCESS_KEY}&ck={CAMPAIGN_KEY}&ad_id={ad_id}&campaign=2505_shoplive_crocs&click_tracking_template_id=ABCDEFG&ad_type=click&bz_tracking_id={bz_tracking_id}&package_name=shoplive1&utm_source=BUZZVIL

중요 파라미터 예시:

• ad_id

• utm_source

• bz_tracking_id

• ad_type

• 기타 광고 플랫폼에서 요구하는 트래킹 파라미터들

이러한 파라미터들은 광고 성과 측정 및 리타게팅에 반드시 필요하므로, Shoplive Player 실행 시 반드시 함께 전달되어야 합니다.

2. Web 환경

Shoplive Web Player는 현재 페이지의 URL에 포함된 모든 query 파라미터를 자동으로 파싱하여 처리합니다.

• 광고 랜딩 페이지는 즉시 Shoplive Player를 실행하는 형태로 구성하는것을 권장합니다.

• 광고 클릭 시 연결되는 링크 주소에 Shoplive Player가 바로 실행되는지 확인해 주세요.

3. 하이브리드 앱 (WebView 기반 앱)

하이브리드 앱에서 광고 클릭 후 Shoplive Web Player 페이지를 WebView 또는 In-App Browser로 여는 경우, 광고 링크에 포함된 모든 query 파라미터들을 그대로 전달해야 합니다.

  예시 코드 (Javascript)

const url = new URL('YOUR_APP://shoplive-player');
const sp = new URLSearchParams(location.search);
for (const key of sp.keys()) {
  url.searchParams.set(key, sp.get(key));
}
window.open(url); // 또는 WebView.open(url.href)

4. Shoplive SDK 를 사용한 Native App

Native 앱에서 Shoplive SDK를 통해 플레이어를 직접 띄우는 경우, 광고 트래킹 파라미터를 SDK 초기화 시점에 함께 전달해야 합니다.

📎 자세한 연동 방법은 LINK 를 참고해주세요.

Android LINK

IOS LINK