> ## Documentation Index
> Fetch the complete documentation index at: https://www.mellowtel.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mellowtelであなたのウェブサイトを収益化

> 訪問者が未使用の帯域幅を共有することを選択してあなたをサポートできるように、1つのスクリプトタグを追加します。

Mellowtelは、訪問者が未使用の帯域幅を共有することを選択してあなたをサポートできるようにします。あなたはサイトに小さなウィジェットを追加し、訪問者はコンパニオン拡張機能をインストールすることを選び、彼らのブラウザが処理するリクエストに基づいて収益を得ます。

<Info>
  **推定時間:** 5〜10分。 **必要なもの:** [Mellowtelアカウント](https://www.mellowtel.com/mellowtel-auth/)とサイトのHTML（または同等のフレームワーク）へのアクセス。
</Info>

## 仕組み

<Steps>
  <Step title="ウィジェットを埋め込む">
    スクリプトタグがあなたのサイトにボタン、アイコン、またはバナーを表示します。
  </Step>

  <Step title="訪問者がクリックする">
    彼らはMellowtelコンパニオン拡張機能をインストールするページに移動します。
  </Step>

  <Step title="あなたにクレジットが付与される">
    あなたの`invite_id`がその訪問者をあなたのアカウントにリンクし、彼らのブラウザが処理するリクエストがあなたに帰属します。
  </Step>
</Steps>

## 始める前に

* Mellowtelアカウント。[こちらでサインアップ](https://www.mellowtel.com/mellowtel-auth/)してください。
* サポートリンクを作成した後に[ダッシュボード](https://www.mellowtel.com/mellowtel-auth/)で見つかるあなたの`invite_id`。
* サイトのHTMLへのアクセス、またはフレームワークやCMSを通じて`<script>`タグを追加する能力。

## ウィジェットのインストール

これをサイトに貼り付け、ダッシュボードからの値で`INVITE_ID`を置き換えます。ページレンダリングをブロックしないように`</body>`の直前に配置することをお勧めします。

<CodeGroup>
  ```html HTML theme={null}
  <script
    src="https://cdn.mellow.tel/widget.js?type=button&position=bottom-right&invite_id=INVITE_ID"
    async>
  </script>
  ```

  ```jsx Next.js (App Router) theme={null}
  import Script from 'next/script'

  export default function Layout({ children }) {
    return (
      <html>
        <body>
          {children}
          <Script
            src="https://cdn.mellow.tel/widget.js?type=button&position=bottom-right&invite_id=INVITE_ID"
            strategy="afterInteractive"
          />
        </body>
      </html>
    )
  }
  ```

  ```jsx React (Vite / CRA) theme={null}
  import { useEffect } from 'react'

  export function MellowtelWidget() {
    useEffect(() => {
      const s = document.createElement('script')
      s.src = 'https://cdn.mellow.tel/widget.js?type=button&position=bottom-right&invite_id=INVITE_ID'
      s.async = true
      document.body.appendChild(s)
      return () => { s.remove() }
    }, [])
    return null
  }
  ```

  ```html WordPress theme={null}
  <!-- テーマのfooter.phpに</body>の直前に追加するか、 -->
  <!-- "Header & Footer Scripts"プラグインを使用してフッターフィールドに貼り付けます。 -->
  <script
    src="https://cdn.mellow.tel/widget.js?type=button&position=bottom-right&invite_id=INVITE_ID"
    async>
  </script>
  ```

  ```html Webflow / Shopify theme={null}
  <!-- Webflow: プロジェクト設定 > カスタムコード > フッターコード -->
  <!-- Shopify: オンラインストア > テーマ > コードを編集 > theme.liquid（</body>の前） -->
  <script
    src="https://cdn.mellow.tel/widget.js?type=button&position=bottom-right&invite_id=INVITE_ID"
    async>
  </script>
  ```
</CodeGroup>

## 設定オプション

スクリプトURLのクエリパラメータを通じてウィジェットの外観を制御します。

| パラメータ       | 必須 | 値                                                      | 説明                       |
| ----------- | -- | ------------------------------------------------------ | ------------------------ |
| `invite_id` | はい | ダッシュボードからのあなたのID                                       | 収益をあなたのアカウントに帰属させます。     |
| `type`      | はい | `button`, `icon`, `banner`                             | あなたのサイトに表示されるウィジェットスタイル。 |
| `position`  | はい | `bottom-right`, `bottom-left`, `top-right`, `top-left` | ページ上でのウィジェットの位置。         |

<Tip>
  出荷前にすべての組み合わせをライブでプレビュー: [ウィジェットプレビューを開く](https://cdn.mellow.tel/preview?position=bottom-right\&type=button\&invite_id=ijxf49s9h2f)。URLの`type`と`position`パラメータを入れ替えて各バリエーションを確認してください。
</Tip>

## 動作確認

<Steps>
  <Step title="サイトを読み込む">
    新しいブラウザタブ（またはキャッシュをバイパスするためのシークレットウィンドウ）でページを開きます。
  </Step>

  <Step title="ウィジェットが表示されることを確認する">
    選択した位置にボタン、アイコン、またはバナーが表示されるはずです。表示されない場合は、ブラウザコンソールでブロックされたリクエストを確認してください。
  </Step>

  <Step title="フローをクリックして進む">
    ウィジェットをクリックすると、`invite_id`が付いた拡張機能インストールページに移動するはずです。
  </Step>

  <Step title="ダッシュボードを確認する">
    訪問者がインストールしてオプトインすると、そのアクティビティがあなたのMellowtelダッシュボードに表示されます。
  </Step>
</Steps>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="ウィジェットが表示されない">
    * スクリプトタグが`<body>`内にあり、`invite_id`が入力されていることを確認してください。
    * DevToolsを開き、ネットワークタブで`cdn.mellow.tel/widget.js`へのリクエストを確認してください。ブロックされている場合、広告ブロッカーやコンテンツフィルターが原因である可能性があります。
    * コンテンツセキュリティポリシーを確認してください。`script-src`で`https://cdn.mellow.tel`を許可する必要があるかもしれません。
  </Accordion>

  <Accordion title="「missing invite_id」警告が表示される">
    `invite_id`パラメータが空であるか、リテラルの`INVITE_ID`プレースホルダーがまだ含まれています。ダッシュボードから実際の値をコピーしてURLに貼り付けてください。
  </Accordion>

  <Accordion title="ローカルでは動作するが本番環境では動作しない">
    多くの場合、CSPまたはCDNルールがスクリプトを削除しています。本番ホストのレスポンスヘッダーを確認し、`cdn.mellow.tel`を許可リストに追加してください。
  </Accordion>

  <Accordion title="ウィジェットを削除するにはどうすればよいですか？">
    `<script>`タグ（またはそれをラップするフレームワークコンポーネント）を削除してください。他にクリーンアップするものはありません。
  </Accordion>
</AccordionGroup>

## 訪問者への開示

訪問者がオプトインの意味を理解できるように、プライバシーポリシーに短い注意書きを追加することをお勧めします。例えば：

> このサイトはMellowtelと提携しています。拡張機能をインストールすることを選択した場合、ブラウザはこのサイトをサポートするために未使用の帯域幅を共有することがあります。インストールは任意であり、いつでもオプトアウトできます。

完全な詳細については、[プライバシー](/concepts/privacy)および[オプトイン/オプトアウト](/concepts/opt-in-out)をご覧ください。

## 助けが必要ですか？

[info@mellowtel.com](mailto:info@mellowtel.com)までお問い合わせいただくか、[Discord](https://discord.gg/mellowtel)に参加してください。
