# プレースメント設定

> Tapjoy Offerwall の Monetization (収益化) ダッシュボードでプレースメントを作成および設定する方法について説明します。ユーザーエンゲージメントを高めるために、オファーウォールとアプリ内メッセージを表示する場所を制御します。

プレースメントとは、[コンテンツカード](./content-cards.md) を表示するか、メッセージを使用してユーザーを Offerwall へ誘導する、アプリ内の特定の場所のことです。1 つのプレースメントには、それぞれ特定のユーザーセグメント向けに設定された複数のコンテンツカードを加えることができます。

アプリのコードが Tapjoy ダッシュボードのプレースメントを呼び出すと、ユーザーセグメントの条件に一致するコンテンツカードが選択されて表示されます。

プレースメントの使用方法については、以下のセクションを参照してください。

| **トピック**                               | **説明**                         |
| -------------------------------------- | ------------------------------ |
| [プレースメントタイプ](#placement-types)         | さまざまなタイプのプレースメントについて説明します。     |
| [プレースメントの作成](#create-placements)       | Tapjoy ダッシュボードでプレースメントを設定します。  |
| [お勧めのプレースメント](#recommended-placements) | アプリへの実装をお勧めするプレースメントについて説明します。 |

## プレースメントタイプ##placement-types

プレースメントを実装する場所を選ぶ際は、コンテキスト依存プレースメントとユーザー開始プレースメントの両方を考慮する必要があります。

### ユーザー開始プレースメント##user-initiated-placements

ユーザー開始プレースメントは、ユーザーが Offerwall にアクセスするためにタップするゲーム内の物理的な場所に実装します。ユーザーが Offerwall にアクセスすることを選択するため、このタイプのプレースメントには追加のアプリ内メッセージは不要です。

### コンテキスト依存プレースメント##contextual-placements

ゲームプレイ中に特定の条件が発生すると、アプリがコンテキスト依存プレースメントを呼び出します。

これらのプレースメントでは、Message to Earn または独自のアプリ内メッセージを使用して、ユーザーが Offerwall にアクセスする前にコンテキストを提供することができます。例えば、ユーザーのゲーム内通貨が不足している場合は、'コインが足りなくなっています。今すぐ獲得しましょう!' というメッセージを表示してから Offerwall に誘導できます。詳細については、[メッセージ](./messaging.md) を参照してください。

## プレースメントの作成##create-placements

Tapjoy ダッシュボードでプレースメントを作成し、アプリ内で [コンテンツカード](./content-cards.md) や [アプリ内メッセージ](./messaging.md) を表示する場所を指定します。プレースメントの作成は、オファーウォールを効率的に管理および表示するための手段です。オファーウォールの設定を直接呼び出す代わりに、それが含まれるプレースメントを Tapjoy ダッシュボードで呼び出すことができます。

実装可能なプレースメントのタイプについて、詳しくは [プレースメントタイプ](#placement-types) を参照してください。

> **Important:**
>
> 推奨されるベストプラクティスは、アプリ内にすべての推奨されるプレースメントを統合し、今後の最適化に備えてアプリコードを準備することです。実装をお勧めするプレースメントの完全なリストについては、[お勧めのプレースメント](#recommended-placements) を参照してください。

### 前提条件##prerequisites

Tapjoy ダッシュボードでプレースメントを作成する前に、そのプレースメントをアプリコード内で実装する必要があります。

アプリコード内でプレースメントを実装する方法については、以下のプラットフォーム固有のプレースメントガイドを参照してください。

* [iOS](../../ios/placements/sdk)
* [Android](../../android/placements/sdk)
* [Unity](../../unity/placements/sdk)
* [React Native](../../react-native/placements/sdk)

### プレースメントの作成##create-a-placement

アプリコード内にプレースメントを実装したら、以下の手順で Tapjoy ダッシュボードのプレースメントに接続します。

1. 左側のナビゲーションメニューから **Placements** (プレースメント) を選択します。

2. **+ Placement** (+ プレースメント) を選択して、**Create placement** (プレースメントを作成) のダイアログを開きます。

3. **プレースメント名** を入力します。

> **Tip:**
>
> プレースメントを整理して管理しやすくするため、目的を明確に示す名前を付けてください。例えば、プレースメント名 `Level_Complete_Popup` は、ユーザーがゲームレベルをクリアした後に表示されるメッセージのプレースメントを示しています。

4. **Create** (作成) を選択して、この新しいプレースメント設定をコミットします。

プレースメントを作成したら、Tapjoy がアプリ内のこれらの特定の場所でユーザーにオファーを表示するよう、各プレースメントに [コンテンツカード](./content-cards.md) を作成する必要があります。コンテンツカードを作成する手順については、[コンテンツカードの作成](./content-cards.md#create-a-content-card) を参照してください。

## お勧めのプレースメント##recommended-placements

以下の表は、Tapjoy SDK およびダッシュボードへの実装をお勧めするプレースメントについて説明したものです。

同じプレースメントを異なるプラットフォーム間で再利用できます。

> **Note:**
>
> Tapjoy にはデフォルトの `AppLaunch` プレースメントが用意されています。Tapjoy SDK はアプリの起動時に初期化が終了すると、このプレースメントを呼び出します。SDK によるこのプレースメントの呼び出しは止められませんが、Tapjoy ダッシュボードでコンテンツを空にすることで、これを無効化できます。

> **Important:**
>
> [ディープリンク](../../web/displaying-offerwall/deep-linking-implementation)
>
>  で 
>
> `event_name`
>
>  パラメーターにデフォルトの 
>
> `#WebOfferwall`
>
>  値を使う場合は、Tapjoy Offerwall の Monetization ダッシュボードに 
>
> `#WebOfferwall`
>
>  というプレースメントを作成してください。詳細については、「ディープリンク」ページの 
>
> [イベント名](../../web/displaying-offerwall/deep-linking-implementation#event-name)
>
>  セクションを参照してください。

| プレースメント                | 型        | 説明                                                                                                                                                                                           |
| ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MainMenu`             | ユーザー開始   | ユーザーが Offerwall にアクセスするためにタップする、アプリのメインメニュー内の場所。すべてのお勧めのプレースメントを実装できない場合に推奨されるベストプラクティスは、少なくとも MainMenu と MainMenu\_Messaging のプレースメントを実装し、コンテンツカードと Message to Earn をテストできるようにすることです。       |
| `MainMenu_Messaging`   | コンテキスト依存 | ユーザーを Offerwall へ誘導するためのアプリ内メッセージを表示する、メインメニュー内のプロンプト。すべてのお勧めのプレースメントを実装できない場合に推奨されるベストプラクティスは、少なくとも MainMenu と MainMenu\_Messaging のプレースメントを実装し、コンテンツカードと Message to Earn をテストできるようにすることです。 |
| `AppLaunch`            | コンテキスト依存 | アプリのロード後に表示されるプロンプト。                                                                                                                                                                         |
| `Store`                | ユーザー開始   | アプリ内課金 (IAP) と並んで表示される、通貨ストア内の場所。                                                                                                                                                            |
| `InsufficientCurrency` | コンテキスト依存 | 購入に必要な通貨が不足しているユーザー向けのプロンプト。                                                                                                                                                                 |
| `AbandonCurrency`      | コンテキスト依存 | IAP を完了しなかったユーザー向けのプロンプト。                                                                                                                                                                    |
| `Inbox`                | ユーザー開始   | 通貨セールの Offerwall への直接パスを含む受信箱メッセージ。                                                                                                                                                          |
| `LevelComplete`        | コンテキスト依存 | レベルやイベントをクリアしたユーザー向けのプロンプト。                                                                                                                                                                  |
| `AppMessage`           | ユーザー開始   | 独自のアプリ内メッセージングシステムからのアプリ内メッセージ。ユーザーはこれらのメッセージをタップして Offerwall にアクセスします。                                                                                                                      |