広告プラットフォーム連携

リファレンス

開発チームが連携を適用する際に参照するガイドです。管理画面の運用には必要ありません。

Shoplive Player を広告プラットフォームと連携する際は、広告のトラッキング情報を正確に収集するために、次の点を必ず確認してください。

1. 広告トラッキング情報のクエリパラメータの受け渡し

広告プラットフォームから Shoplive のリンクへ移動する際、URL にはさまざまなトラッキング情報がクエリ文字列の形で含まれます。

広告リンクの例:

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 に含まれるすべてのクエリパラメータを自動で解析して処理します。

広告のランディングページはすぐに Shoplive Player を起動する構成にすることを推奨します。
広告クリック時に遷移するリンク先で Shoplive Player がすぐに起動するか確認してください。

3. ハイブリッドアプリ(WebView ベースのアプリ)

ハイブリッドアプリで広告クリック後にShoplive Web Player のページを WebView またはアプリ内ブラウザで開く場合、広告リンクに含まれるすべてのクエリパラメータをそのまま渡す必要があります。

サンプルコード(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 を使用したネイティブアプリ

ネイティブアプリで Shoplive SDK を通じてプレーヤーを直接起動する場合は、広告のトラッキングパラメータを SDK の初期化時に一緒に渡す必要があります。

📎 詳しい連携方法は LINK を参照してください。

Android LINK

iOS LINK

Flutter LINK