クリエイタータグ付きキャンペーンを設定する方法
どのように動作するか
クリエイタータグは、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メソッド
クリエイタータグでクリエイターを取得する
クリエイタータグを持っているキャンペーン内のクリエイターのリストを取得します。
| パラメータ | 種類 | 説明文 |
|---|---|---|
| integer | リストに含まれるクリエイターの数（デフォルト：20、最大：100）。 |
| integer | リストのクリエイターを読み込む際に発生するオフセットの値（デフォルト：0）。 |
リクエストの例：
Copy
- http
1GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1
応答の例：
Copy
- json
1{
2 "items": [
3 {
4 "creator_tag": "creatorOne",
5 "revenue_share_percent": 5
6 },
7 {
8 "creator_tag": "creatorTwo",
9 "revenue_share_percent": 10
10 },
11 {
12 "creator_tag": "creatorThree",
13 "revenue_share_percent": 50
14 }
15 ],
16 "total_count": 32
17}
取引の作成
クリエイタータグが適用されたトランザクションを作成/更新します。リクエスト本文には、以下のオブジェクトの配列が渡されます：
| パラメータ | 種類 | 説明文 |
|---|---|---|
| string | キャンペーン内でのクリエイターの固有コード。必須。 |
| string | 取引ID。必須。 |
| string | 取引が行われた通貨のコード。ISO 4217に基づく3文字の通貨コード。必須。 |
| number | 取引量。必須。 |
| string | 取引日付はYYYY-MM-DD’T’HH:MM:SS形式。必須。 |
| string | 取引が行われたプラットフォーム。必須。 |
| string | ゲーマーID。必須。 |
| string | 購入したアイテムID。必須。 |
| string | 購入したアイテム名。必須。 |
リクエストの例：
Copy
- http
1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
2
3X-API-key: {YOUR_API_KEY}
4Content-Type: application/json
5
6[
7 {
8 "transaction_id": "123456789",
9 "creator_tag": "creatorOne",
10 "platform_id": "steam",
11 "user_id": "0123456",
12 "transaction_date": "2020-04-10T06:06:24.830Z",
13 "item_id": "GAME_sku_1",
14 "item_name": "hk416",
15 "transaction_currency_code": "USD",
16 "transaction_value": 5
17 },
18 {
19 "transaction_id": "123456788",
20 "creator_tag": "creatorOne",
21 "platform_id": "steam",
22 "transaction_date": "2020-04-10T06:06:24.830Z",
23 "item_id": "GAME_sku_2",
24 "item_name": "hk416",
25 "transaction_currency_code": "EUR",
26 "transaction_value": 10
27 },
28 {
29 "transaction_id": "123456781",
30 "creator_tag": "creatorOne",
31 "platform_id": "xbox",
32 "transaction_date": "2020-04-10T06:06:24.830Z",
33 "item_id": "GAME_sku_1",
34 "item_name": "hk416",
35 "transaction_currency_code": "USD",
36 "transaction_value": 3
37 }
38]
取引のキャンセル
クリエイタータグが適用されたトランザクションをキャンセルします。リクエスト本文には、以下のオブジェクトの配列が渡されます：
| パラメータ | 種類 | 説明文 |
|---|---|---|
| string | キャンセルしたい取引のID必須。 |
| string | 決済返金の外部ID。 |
| string | 返金の理由。 |
| string | 返金日付はYYYY-MM-DD’T’HH:MM:SS 形式。必須。 |
リクエストの例：
Copy
- http
1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
2
3X-API-key: {YOUR_API_KEY}
4Content-Type: application/json
5
6[
7 {
8 "transaction_id": "123456789",
9 "creator_tag": "creatorOne",
10 "platform_id": "steam",
11 "user_id": "0123456",
12 "transaction_date": "2020-04-10T06:06:24.830Z",
13 "item_id": "GAME_sku_1",
14 "item_name": "hk416",
15 "transaction_currency_code": "USD",
16 "transaction_value": 5
17 },
18 {
19 "transaction_id": "123456788",
20 "creator_tag": "creatorOne",
21 "platform_id": "steam",
22 "transaction_date": "2020-04-10T06:06:24.830Z",
23 "item_id": "GAME_sku_2",
24 "item_name": "hk416",
25 "transaction_currency_code": "EUR",
26 "transaction_value": 10
27 },
28 {
29 "transaction_id": "123456781",
30 "creator_tag": "creatorOne",
31 "platform_id": "xbox",
32 "transaction_date": "2020-04-10T06:06:24.830Z",
33 "item_id": "GAME_sku_1",
34 "item_name": "hk416",
35 "transaction_currency_code": "USD",
36 "transaction_value": 3
37 }
38]
クリエイタータグによる統計情報の送信
クリエイターのクリエイタータグ接続に関する統計情報の送信を許可します（日別）。この情報はクリエイターアカウントの統計情報に掲載されます。リクエスト本文には、以下のオブジェクトの配列が渡されます：
| パラメータ | 種類 | 説明文 |
|---|---|---|
| string | クリエイターに関する統計情報の送信日はYYYY-MM-DD形式。必須。 |
| string | キャンペーン内でのクリエイターの固有コード。必須。 |
| integer | クリエイター用のクリエイタータグを使用した新規プレイヤーの数。必須。 |
| integer | クリエイターのクリエイタータグを使用した全部プレイヤーの数。必須。 |
リクエストの例：
Copy
- http
1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1
2
3X-API-key: {YOUR_API_KEY}
4Content-Type: application/json
5
6[
7 {
8 "date": "2020-04-10",
9 "creator_tag": "creatorOne",
10 "new_supporters": 125,
11 "total_supporters": 35900
12 },
13 {
14 "date": "2020-04-10",
15 "creator_tag": "creatorTwo",
16 "new_supporters": 123,
17 "total_supporters": 34567
18 }
19]
クリエイター用のクリエイタータグを作成する
キャンペーンの新しいクリエイターにクリエイタータグの作成を許可します。リクエスト本文には、以下のオブジェクトの配列が渡されます：
| パラメータ | 種類 | 説明文 |
|---|---|---|
| string | キャンペーン内でのクリエイターの固有コード。必須。 |
| string | クリエイターのメール。必須。 |
| array of strings | ソーシャルネットワーク内のクリエイターのチャンネルにリンクします。チャンネルは複数あっても構いません。必須。 |
リクエストの例：
Copy
- http
1PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1
2
3X-API-key: {YOUR_API_KEY}
4Content-Type: application/json
5
6{
7 "creator_tag": "creatorOne",
8 "creator_email": "influencer@example.com",
9 "creator_channels": [
10 "https://www.twitch.tv/creatorOne"
11 ]
12}
キャンペーンにクリエイターを追加する
新しいクリエイターをキャンペーンに追加することを許可します。リクエスト本文には、以下のオブジェクトの配列が渡されます：
| パラメータ | 種類 | 説明文 |
|---|---|---|
| string | キャンペーン内でのクリエイターの固有コード。必須。 |
| integer | クリエイターのクリエイタータグが適用された1回の購入につき、クリエイターが獲得する利益の割合。必須。 |
リクエストの例：
Copy
- http
1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals HTTP/1.1
2X-API-key: {YOUR_API_KEY}
3
4Content-Type: application/json
5
6{
7 "creator_tag": "creatorOne",
8 "revenue_share": 30
9}
この記事は役に立ちましたか？
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
