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

どのように動作するか

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

ゲーマーフロー

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

収益化

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

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

使用に適した方

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

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

入手方法

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

自分で追加する

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

  1. インフルエンサー用の作成者タグの作成プログラムにインフルエンサーの追加メソッドを順次呼び出します。
  2. インフルエンサーをプログラムに招待するには、インフルエンサーの作成者タグの作成方法で使用したインフルエンサーのメール、ソーシャルネットワークチャンネル、作成者タグを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
レスポンス
{
  "items": [
    {
      "creator_tag": "creatorOne",
      "revenue_share_percent": 5
    },
    {
      "creator_tag": "creatorTwo",
      "revenue_share_percent": 10
    },
    {
      "creator_tag": "creatorThree",
      "revenue_share_percent": 50
    }
  ],
  "total_count": 32
}

取引の作成

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

パラメータ種類説明文
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"
  ]
}

この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
このページを評価する
このページを評価する
改善できることはありますか?

答えたくない

ご意見ありがとうございました!
最終更新日: 2021年7月20日

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

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