作成者タグを使ったプログラムの設定方法

どのように動作するか

作成者タグは、YouTubeやTwitch、またはその他の形式やサービスでストリームを視聴するときにプレーヤーが受け取ることができる一意のコードです。プレイヤー（サポーター）は、ゲーム内の購入時にこのタグを使用して、お気に入りのインフルエンサーを支援することができます。このソリューションにより、インフルエンサーとの信頼関係を構築し、すべてのゲーム内購入のアトリビューション（追跡）を通じて収入を増やすことができます。

ゲーマーフロー

プレイヤーは、インフルエンサーがコードを共有したサービスから、作成者タグをコピーするか、リンクをたどって接続します。インフルエンサーは以下のサービスを利用できます：
- Twitch
- YouTube
- Facebook Gaming
- その他のソーシャルネットワーク
プレイヤーは、その接続を実装したページのフィールドに作成者タグを入力します。プレイヤーがそのリンクをクリックすると、作成者タグが自動的に適用されます。

収益化

すべてのゲーム内の購入から収入が得られます。インフルエンサーの利益の一部は、購入時に作成者タグが適用された各購入者から差し引かれます。

ゲームプラットフォームや決済システムでは、決済時に追加の手数料がかかることがあります。

使用に適した方

以下のゲームを持つパートナー：

予想される月収が20,000ドル以上の方
ゲーム内でのみ購入可能な商品

入手方法

作成者タグを使ったプログラムを設定する

作成者タグを使って番組を設定するには：

csm@xsolla.com（エクソーラ製品を初めて導入する場合はbizdev@xsolla.com）に申請書を送り、提出を待ちます。アプリケーションで以下の情報を指定します：
- ゲーム名。
- ジャンル。
- 開発者（任意）。
- パブリッシャー（任意）。
- ゲームの公式サイト。
- ゲームの説明。
- SteamアプリID（任意）。
- ゲームがまだ公開されていない場合は、発売日（任意）。
- プロモーション資料へのリンク（任意）。
- ビジネスモデル：
  - プレミアム
  - 無料プレイ
- ゲームプラットフォーム：
  - PC
  - Steam
  - モバイル
  - ウェブ
- プログラム参加期間。
- 収益シェアの割合。
- 収益分配の終了。参加したインフルエンサーが収益分配を受けられなくなる日です。
- インフルエンサーのリスト。各インフルエンサーについて、メールアドレス、ソーシャルネットワークチャンネル、作成者タグを指定します。インフルエンサーを選ぶ際には、以下の制限事項を考慮してください：
  - 残高からの資金の引き出しは、18歳以上のインフルエンサーのみが利用できます。
  - エクソーラは、米国の制裁対象国に銀行口座が登録されているインフルエンサーとは連携していません。

以下のいずれかの方法で、プレーヤーによる作成者タグの接続仕組みを実装します：
- リンクをクリックすることにより。この場合、作成者タグの値は、特定の入力フィールドに自動的に読み込まれます。
- 手動入力の使用。

作成者タグの付いたページが何処になるかを決定します：
- ゲームインターフェースで
- 広告ゲームサイトで
- プレイヤーが購入代金を支払う際の決済インターフェースで

このコードがすべてのプレイヤーの購入時に自動的に適用されるように、ゲームインターフェイスに作成者タグの接続を実装することをお勧めします。

csm@xsolla.comに作成者タグが接続されているページへのリンクを送信する（インターフェースやゲームのウェブサイトに仕組みが実装されている場合）。
ゲーム内では、作成者タグと支援者の購入をリンクする、その購入を追跡する仕組みを導入します。

作成者タグで番組を管理する

作成者タグを使ったプログラムを効果的に管理するには：

取引の作成メソッドを使って、購入した商品を定期的にエクソーラに送信してください。このデータを送信する推奨頻度は1日1回です。

作成者タグが適用された購入品の返金の場合は、取引のキャンセルメソッドでこの情報をエクソーラに伝えます。

新しいインフルエンサーをプログラムに追加します（任意）。

エクソーラでインフルエンサーを追加した場合は、作成者タグでインフルエンサーの獲得メソッドで、定期的にインフルエンサーのリストをアップロードします。データの取得頻度は、1日1回を推奨しています。

作成者タグによる統計情報の送信メソッドを利用して、支援者の統計情報をエクソーラに転送します（任意）。

プログラムにインフルエンサーを追加する

インフルエンサーを番組に追加するには、以下のいずれかの方法があります：

自分
エクソーラ経由

自分で追加する

自分でインフルエンサーを番組に追加するには：

インフルエンサー用の作成者タグの作成とプログラムにインフルエンサーの追加メソッドを順次呼び出します。
インフルエンサーをプログラムに招待するには、インフルエンサーの作成者タグの作成方法で使用したインフルエンサーのメール、ソーシャルネットワークチャンネル、作成者タグを influencer@xsolla.comにメッセージで送信してください。

エクソーラ経由で追加する

エクソーラを介してインフルエンサーをプログラムに追加するには、influencer@xsolla.comにメッセージを送信し、メール、ソーシャルネットワークチャンネルまたはインフルエンサーに割り当てたい作成者タグを指定します。

作成者タグを扱うAPIメソッド

作成者タグでインフルエンサーを獲得する

作成者タグを持っているプログラム内のインフルエンサーのリストを取得します。

パラメータ	種類	説明文
limit	integer	リストに含まれるインフルエンサーの数（デフォルト：`20`、最大：`100`）。
offset	integer	リストのインフルエンサーを読み込む際に発生するオフセットの値（デフォルト：`0`）。

Copy

Full screen

Small screen

GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1

取引の作成

作成者タグが適用されたトランザクションを作成/更新します。リクエストボディには、以下のオブジェクトの配列が渡されます：

パラメータ	種類	説明文
creator_tag	string	番組内でのインフルエンサーの固有コード。必須。
transaction_id	string	取引ID。必須。
transaction_currency	string	取引が行われた通貨のコード。ISO 4217に基づく3文字の通貨コード。必須。
transaction_value	number	取引量。必須。
transaction_date	string	取引日付は`YYYY-MM-DD’T’HH:MM:SS`形式。必須。
platform_id	string	取引が行われたプラットフォーム。必須。
user_id	string	ゲーマーID。必須。
item_id	string	購入したアイテムID。必須。
item_name	string	購入したアイテム名。必須。

Copy

Full screen

Small screen

PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "transaction_id": "123456789",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "user_id": "0123456",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 5
  },
  {
    "transaction_id": "123456788",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_2",
    "item_name": "hk416",
    "transaction_currency_code": "EUR",
    "transaction_value": 10
  },
  {
    "transaction_id": "123456781",
    "creator_tag": "creatorOne",
    "platform_id": "xbox",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 3
  }
]

取引のキャンセル

作成者タグが適用されたトランザクションをキャンセルします。リクエストボディには、以下のオブジェクトの配列が渡されます：

パラメータ	種類	説明文
transaction_id	string	キャンセルしたい取引のID必須。
refund_id	string	決済返金の外部ID。
reason	string	返金の理由。
refund_date	string	返金日付は`YYYY-MM-DD’T’HH:MM:SS` 形式。必須。

Copy

Full screen

Small screen

PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "transaction_id": "123456789",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "user_id": "0123456",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 5
  },
  {
    "transaction_id": "123456788",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_2",
    "item_name": "hk416",
    "transaction_currency_code": "EUR",
    "transaction_value": 10
  },
  {
    "transaction_id": "123456781",
    "creator_tag": "creatorOne",
    "platform_id": "xbox",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 3
  }
]

作成者タグによる統計情報の送信

インフルエンサーの作成者タグ接続に関する統計情報の送信を許可します（日別）。この情報はインフルエンサーアカウントの統計情報に掲載されます。リクエストボディには、以下のオブジェクトの配列が渡されます：

パラメータ	種類	説明文
date	string	作成者に関する統計情報の送信日は`YYYY-MM-DD`形式。必須。
creator_tag	string	番組内でのインフルエンサーの固有コード。必須。
new_supporters	integer	インフルエンサーの作成者タグを使用した新規プレイヤーの数。必須。
total_supporters	integer	インフルエンサーの作成者タグを使用した全部プレイヤーの数。必須。

Copy

Full screen

Small screen

PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "date": "2020-04-10",
    "creator_tag": "creatorOne",
    "new_supporters": 125,
    "total_supporters": 35900
  },
  {
    "date": "2020-04-10",
    "creator_tag": "creatorTwo",
    "new_supporters": 123,
    "total_supporters": 34567
  }
]

インフルエンサー用の作成者タグの作成

プログラムの新しいインフルエンサーに作成者タグの作成を許可します。リクエストボディには、以下のオブジェクトの配列が渡されます：

パラメータ	種類	説明文
creator_tag	string	番組内でのインフルエンサーの固有コード。必須。
creator_email	string	インフルエンサーのメール。必須。
creator_channels	array of strings	ソーシャルネットワーク内のインフルエンサーのチャンネルにリンクします。チャンネルは複数あっても構いません。必須。

Copy

Full screen

Small screen

PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

{
  "creator_tag": "creatorOne",
  "creator_email": "influencer@example.com",
  "creator_channels": [
    "https://www.twitch.tv/creatorOne"
  ]
}

プログラムにインフルエンサーの追加

新しいインフルエンサーをプログラムに追加することを許可します。リクエストボディには、以下のオブジェクトの配列が渡されます：

パラメータ	種類	説明文
creator_tag	string	番組内でのインフルエンサーの固有コード。必須。
revenue_share	integer	インフルエンサーの作成者タグが適用された1回の購入につき、インフルエンサーが獲得する利益の割合。必須。

Copy

Full screen

Small screen

PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

{
  "creator_tag": "creatorOne",
  "creator_email": "influencer@example.com",
  "creator_channels": [
    "https://www.twitch.tv/creatorOne"
  ]
}

ご意見ありがとうございました！

あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

最終更新日: 2024年1月22日

誤字脱字などのテキストエラーを見つけましたか？テキストを選択し、Ctrl+Enterを押します。

Your browser is not supported. Please try a different browser

以下の出典に基づく回答:

ご意見・ご感想をお寄せください（任意）

ご意見・ご感想をお寄せください（任意）

パートナーネットワーク

作成者タグを使ったプログラムの設定方法

どのように動作するか

ゲーマーフロー

収益化

使用に適した方

入手方法

作成者タグを使ったプログラムを設定する

作成者タグで番組を管理する

プログラムにインフルエンサーを追加する

自分で追加する

エクソーラ経由で追加する

作成者タグを扱うAPIメソッド

作成者タグでインフルエンサーを獲得する

limit

offset

取引の作成

creator_tag

transaction_id

transaction_currency

transaction_value

transaction_date

platform_id

user_id

item_id

item_name

取引のキャンセル

transaction_id

refund_id

reason

refund_date

作成者タグによる統計情報の送信

date

creator_tag

new_supporters

total_supporters

インフルエンサー用の作成者タグの作成

creator_tag

creator_email

creator_channels

プログラムにインフルエンサーの追加

creator_tag

revenue_share