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

どのように動作するか

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

ゲーマーフロー

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

収益化

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

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

使用に適した方

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

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

入手方法

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

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

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

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

  1. 作成者タグの付いたページが何処になるかを決定します：
    • ゲームインターフェースで
    • 広告ゲームサイトで
    • プレイヤーが購入代金を支払う際の決済インターフェースで
お知らせ
このコードがすべてのプレイヤーの購入時に自動的に適用されるように、ゲームインターフェイスに作成者タグの接続を実装することをお勧めします。
  1. csm@xsolla.comに作成者タグが接続されているページへのリンクを送信する（インターフェースやゲームのウェブサイトに仕組みが実装されている場合）。
  2. ゲーム内では、作成者タグと支援者の購入をリンクする、その購入を追跡する仕組みを導入します。

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

作成者タグを使ったプログラムを効果的に管理するには：
  1. 取引の作成メソッドを使って、購入した商品を定期的にエクソーラに送信してください。このデータを送信する推奨頻度は1日1回です。
お知らせ
作成者タグが適用された購入品の返金の場合は、取引のキャンセルメソッドでこの情報をエクソーラに伝えます。
  1. 新しいインフルエンサーをプログラムに追加します（任意）。
お知らせ
エクソーラでインフルエンサーを追加した場合は、作成者タグでインフルエンサーの獲得メソッドで、定期的にインフルエンサーのリストをアップロードします。データの取得頻度は、1日1回を推奨しています。
  1. 作成者タグによる統計情報の送信メソッドを利用して、支援者の統計情報をエクソーラに転送します（任意）。

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

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

自分で追加する

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

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

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

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

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

作成者タグを持っているプログラム内のインフルエンサーのリストを取得します。
パラメータ種類説明文
limit
integerリストに含まれるインフルエンサーの数（デフォルト：20、最大：100）。
offset
integerリストのインフルエンサーを読み込む際に発生するオフセットの値（デフォルト：0）。
Copy
Full screen
Small screen
  • http
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
  • http
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
  • http
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
  • http
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
  • http
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
  • http
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を押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました！