광고 플랫폼 연동

레퍼런스

개발팀이 연동을 적용할 때 참고하는 가이드입니다. 어드민을 운영하는 데에는 필요하지 않습니다.

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

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

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

광고 LINK 예시:

https://shoplive.show/player.html?ak={ACCESS_KEY}&ck={CAMPAIGN_KEY}&utm_source=targetads&ad_id={ad_id}&bz_tracking_id={bz_tracking_id}&package_name={package_name}

중요 파라미터 예시:

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

이러한 파라미터들은 광고 성과 측정 및 리타게팅에 반드시 필요하므로, 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

Flutter LINK