グローブの共有とウィジェットの埋め込み

公開リンクでライブ3Dグローブを共有するか、シンプルなHTML訪問者ウィジェットをウェブサイトに埋め込みます。

公開リンクによるグローブの共有

3Dグローブはリアルタイムの訪問者データを表示するフルページの公開リンクとして共有できます。これはiframe埋め込みではなく、リンクを持つ誰でも閲覧できるスタンドアロンページです。

グローブ共有を有効にする方法

1. 1

   グローブビューを開く

   ウェブサイトのダッシュボードを開き、Globe タブを選択します。

2. 2

   共有ボタンをクリック

   グローブコントロールバーにある共有ボタンをクリックします。

3. 3

   共有を有効にする

   共有モーダルで共有を有効にするをクリックします。ユニークな共有トークンが自動的に生成されます。

4. 4

   リンクをコピー

   生成された公開リンクをコピーして誰とでも共有します。

共有リンクの形式

https://app.zenovay.com/share/globe/YOUR_TOKEN

共有グローブページには以下が表示されます：

• DiceBearアバター付きリアルタイム訪問者マーカー
• 最近の訪問者を表示するアクティビティフィード
• トップ統計オーバーレイ（ライブ訪問者数、トップリファラー、国、デバイス）
• アンビエントバックグラウンドオーディオ用ミュージックプレーヤー
• グローブコントロール（共有、音楽、リロード、フルスクリーン）

共有の無効化

いつでもグローブ共有を無効にできます：

1. Globe タブを開き、共有ボタンをクリック
2. 共有をオフに切り替える
3. 既存の共有リンクは即座に機能しなくなります

共有ページのホワイトラベル

Enterprise プラン

Enterpriseのお客様は共有グローブページをカスタマイズできます：

オプション	説明
ブランドを削除	「Powered by Zenovay」フッターを非表示にする
カスタムプライマリカラー	ブランドカラーをUI要素に適用する

ホワイトラベル設定はワークスペースの Agency エリアで構成され、共有グローブページと埋め込みウィジェットに自動的に適用されます。

セキュリティ

• 共有リンクは公開です — リンクを持つ誰でもグローブを閲覧できます
• 集計された訪問者データのみ表示されます（場所、訪問ページ、時刻）
• 個人を特定できる情報は公開されません
• いつでも共有を無効にしてアクセスを取り消せます

HTML ウィジェット埋め込み（グローブとは別）

グローブ共有に加えて、Zenovayは訪問者統計を表示するシンプルなHTMLウィジェットを提供しています。これらは軽量な埋め込みコンポーネントです — 3Dグローブの埋め込みではありません。

ウィジェットの種類

ウィジェット	エンドポイント	説明
リアルタイム	/widgets/:trackingCode/realtime	点滅インジケーター付きライブ訪問者数
プレビュー	/widgets/:trackingCode/preview	24時間の訪問者タイムライングラフ
チャート	/widgets/:trackingCode/recent	30分間の国別内訳

ウィジェットの埋め込み

ウィジェットはiframeを使用して埋め込みます。ドメイン設定の Widgets タブで設定し、生成された埋め込みコードをコピーします。

<iframe
  src="https://api.zenovay.com/widgets/ZV_XXXXXXXXXXX/realtime?theme=dark&primaryColor=%236366f1"
  width="200"
  height="120"
  frameborder="0"
  style="border-radius: 12px; overflow: hidden;"
></iframe>

ウィジェットのカスタマイズ

ウィジェットは以下のパラメータをサポートします：

パラメータ	型	デフォルト	説明
primaryColor	string	#e78468	プライマリアクセントカラー（16進数）
secondaryColor	string	#8dcdff	チャート用セカンダリカラー（16進数）
theme	string	system	テーマ：light、dark、またはsystem
mainTextSize	number	16	メインディスプレイのフォントサイズ（ピクセル）（10～32）
hideBranding	boolean	false	「Powered by Zenovay」フッターを非表示（ホワイトラベルブランド削除が有効な場合は自動的に設定）

dashboard でのウィジェット設定

1. ドメイン設定に移動
2. Widgets タブに移動
3. ウィジェットをオンにする
4. ウィジェットの種類を選択（リアルタイム、プレビュー、またはチャート）
5. 色、テーマ、テキストサイズをカスタマイズ
6. ウィジェットをライブでプレビュー
7. iframe埋め込みコードをコピー

ユースケース

マーケティングウェブサイト

ライブグローブリンクを共有してグローバルリーチをアピール：

• 外部リンクとして会社概要ページに掲載
• クライアントミーティングやプレゼンテーションで表示
• オフィスディスプレイにはフルスクリーンモードを使用

クライアントレポート

クライアントとグローブを共有：

• レポートやメールに公開リンクを送信
• Enterpriseのホワイトラベルでプロフェッショナルな外観のためにZenovayブランドを削除

オフィスディスプレイ

オフィスの画面にグローブを表示：

• 共有リンクをフルスクリーンモードで開く
• アンビエントバックグラウンドオーディオのためにミュージックプレーヤーを有効にする
• グローブは自動的にリアルタイムで更新されます

ウェブサイト訪問者数

HTMLウィジェットをサイトに埋め込む：

• リアルタイムウィジェットでライブ訪問者数を表示
• プレビューウィジェットで24時間のトレンドを表示
• チャートウィジェットで地理的内訳を表示

トラブルシューティング

グローブ共有リンクが機能しない

• Globe タブで共有がまだ有効になっているか確認（共有パネルを開く）
• 共有パネルから現在のリンクをコピーし直す（変更された場合に備えて）
• シークレットウィンドウでリンクを開いてブラウザの問題を除外する

ウィジェットが読み込まれない

• ドメイン設定でウィジェットが有効になっているか確認
• iframe URLのトラッキングコードがウェブサイトと一致しているか確認
• iframe コンテンツをブロックする可能性のある広告ブロッカーを確認
• ウィジェットエンドポイントURLが正しいか確認

パフォーマンスのヒント

• HTMLウィジェットは軽量で素早く読み込まれます
• 共有グローブページは閲覧者のブラウザでWebGLサポートが必要です
• グローブのパフォーマンスは閲覧者のデバイスとブラウザの性能によって異なります

次のステップ

• グローブの外観をカスタマイズする
• API統合オプション