# Appsflyer との統合

> Appsflyer をモバイル測定パートナーとして統合し、ユーザーエンゲージメントデータとキャンペーンデータを Tapjoy Offerwall と共有します。

このガイドでは、Appsflyer ダッシュボードで新しい Offerwall キャンペーンを設定する手順を説明します。

その他のガイダンスについては、Appsflyer ドキュメントの [Tapjoy 設定ガイド](https://support.appsflyer.com/hc/en-us/articles/207033956-Tapjoy-campaign-configuration) を参照してください。

## Tapjoy キャンペーン設定##tapjoy-campaign-configuration

### パートナーのアクティブ化##partner-activation

1. サイドメニューから、**Collaborate** (コラボレーション) > **Partner Marketplace** (パートナーマーケットプレイス) を選択します。
2. **Tapjoy** を検索して選択します。
3. Tapjoyプロファイルページで、**Set Up インテグレーション**を選択します。
4. 統合設定ページに移動します。Integration (統合) タブで、**Activate Partner** (パートナーのアクティブ化) をオンにします。

![AppsFlyer ダッシュボードでの Tapjoy のパートナーとしてのアクティブ化。](/api/media?file=/grow/media/images/AF_activate_partner.png)

> **Note:**
>
> キャンペーンのアトリビューションを一時停止またはオフにする目的で、**Activate partner** を使用しないでください。パートナーの統合を無効にすると、アクティブなキャンペーンに回復不能な損害が発生する可能性があります。

### Integration タブ (インストール)##integration-tab-(install)

1. **First Time Installers**

   1. **Activate Partner** をオンに切り替えます。
   2. Tapjoy で生成された文字列を **app\_id** フィールドに入力します。
   3. **Install view-through attribution** (ビュースルーアトリビューションをインストール) オプションをオフに切り替えます。
   4. Default Postback セクションで、install の横にある `All media sources, including organic` を選択します。

   ![AppsFlyer のダッシュボード。すべてのメディアソースが表示されています。](/api/media?file=/grow/media/images/AF_all_media_sources.png)

2. **Existing Users**

   1. **In-app events postback** (アプリ内イベントのポストバック) をオンに切り替えます。
   2. **Add イベント** を選択します。
   3. **Appsflyer event** で、`af_app_opened` を検索または追加します。
   4. ステップ #2.2 で **app\_id** フィールドに入力したのと同じ Tapjoy 生成文字列を使用します。
      5.**for users from** ドロップダウンで、`All media sources, including organic` を選択します。
      6.**Save インテグレーション** を選択するか、ステップ #3 インテグレーション タブに進みます。イベントに進んで、インストール後イベントをさらに追加します。

   ![AppsFlyer ダッシュボードの Tapjoy 生成トラッキングリンク](/api/media?file=/grow/media/images/AF_tapjoy_generated.png)

#### インストールの動的抑制要件##dynamic-suppression-requirements-for-install

動的抑制ポリシーに準拠し、最適なパフォーマンスを確保するために、2022 年 4 月 1 日より以下の設定が必須になりました。

* **初めてインストールするユーザー**: デバイスにアプリをインストールしたことも起動したこともないユーザー。再インストールは新規インストールとはみなされません。
* **既存のユーザー**: ある特定の時点でデバイスに以前にアプリをインストールして起動したユーザー。アプリのアンインストール後に再インストールしたユーザーも含む。

### Integration タブ (イベント)##integration-tab-(events)

1. **Single Multi-Reward CPE**

   1. **In-app events postback** セクションまでスクロールします。
   2. **Add イベント** を選択します。
   3. **Appsflyer event** で、ドロップダウンからイベントを選択します。
   4. **mapped to partner event** (パートナーイベントにマップ) フィールドに、Tapjoy が生成した engagement\_id を入力します。
      5.すべてのイベントが設定され、一意の engagement\_id を参照するようになるまで、ステップ 2 から 4 を繰り返します。
      6.**Save Integration** を選択するか、Daily ゲーム内報酬セクションに進んで追加のインストール後イベントを設定します。

   ![AppsFlyer ダッシュボードの Tapjoy へのアプリケーション内イベントのマッピング](/api/media?file=/grow/media/images/AF_mapped_event.png)

2. **Daily Rewards CPE**

   1. **In-app events postback** セクションまでスクロールします。
   2. **Add イベント** を選択します。
   3. ゲーム内のレベルアップに関連する SDK イベントを追加します。サポートされるイベント名には、カスタムイベントと Appsflyer の定義済みイベントの両方が含まれます (`af_level` や `af_level_achieved` など)。

   > **Note:**
   >
   > Appsflyer では、ゲーム内のレベルアップの場合は以下の [定義済みイベント](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#predefind-and-custom-events)、アプリ内課金の場合は [af\_level](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#af_level)、ユーザー生成の広告収益イベントの場合は [af\_level\_achieved](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#level-achieved-af_level_achieved) を統合することをお勧めしています。カスタムイベントもサポートされます。[イベントの定義](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#defining-an-inapp-event) 方法と [イベントジェネレーター](https://evgen.appsflyer.com/) の使い方を確認してください。詳細については、[ヒント](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#tips) と [制限事項](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#limitations) を参照してください。

   4. **mapped to partner event** に、Tapjoy が生成した engagement\_id を入力します。
      5.**Including** のドロップダウンで `Values + No Revenue` を選択し、レベルデータがコンバージョンポストバック情報に含まれるようにします。
      6.**Save インテグレーション** を選択します。

   ![AppsFlyer ダッシュボードの日次ゲーム内報酬レポート。](/api/media?file=/grow/media/images/AF_daily_rewards.png)

## ROAS のための IAP と広告収益の設定##iap-and-ad-revenue-configuration-for-roas

### Appsflyer の IAP 設定##appsflyer-iap-setup

1. **In-application events postback** セクションで、**Add event** を選択します。
2. アプリ内課金イベントを追加します。IAP イベントには、`af_purchase` のイベント名を使用することを強くお勧めします (Appsflyer の [af\_purchase](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#purchase-af_purchase) イベントを参照)。
3. **mapped to partner event** に、Tapjoy が生成した engagement\\\_id を入力します。
4. **for users from** 列で、希望する送信オプションを選択します。"*All media sources, including organic*" を選択することをお勧めします。
5. **Including** で `Values + Revenue` を選択し、コンバージョンポストバック情報に金額が含まれていることを確認します。
6. **Save インテグレーション** を選択します。

Appsflyer の定義済みイベント[リスト](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#predefind-and-custom-events) を参照してください。

![AppsFlyer の収益値の設定画面。](/api/media?file=/grow/media/images/AF_values_revenue.png)

### Appsflyer の広告収益の設定##appsflyer-ad-revenue-setup

Tapjoy では、以下の 2 つの方法で広告収益を送信できます。ポストバックと Data Locker。お勧めのベストプラクティスは、データ品質を向上させるための **ポストバックメソッド** です。

1. **Postbacks (Recommended)**

   1. 「**Inアプリケーション events postback**」セクションで、「**Add イベント**」を選択します。
   2. イベント名 `af_ad_revenue` を使用して広告収益イベントを追加します。[af\_ad\_revenue](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#af_revenue) イベント名の使用は **必須です**。
   3. **mapped to partner event** に、Tapjoy が生成した engagement\_id を入力します。
   4. **for users from** 列で、希望する送信オプションを選択します。"*All media sources, including organic*" を選択することをお勧めします。
      5.**Including** で `Values + Revenue` を選択し、コンバージョンポストバック情報に金額が含まれていることを確認します。
      6.**Save インテグレーション** を選択します。

   > **Note:**
   >
   > アプリで初めてポストバックによる広告収益を有効にする場合は、このデータを有効にし、Tapjoy ダッシュボードに表示してもらうよう、アカウントマネージャーに連絡してください。そうしないと、このアプリに Data Locker が設定されている場合、Tapjoy ダッシュボードの広告収益は反映されないか、引き続き Data Locker から入ってきます。これはアプリごとに個別に行う必要があります。

   ![The AppsFlyer ad revenue values configuration screen.](/api/media?file=/grow/media/images/AF_values_ad_revenue.png)

2. **Data Locker**

   > **Note:**
   >
   > 広告主が広告収益を共有するために Data Locker を使用するには、ROI360 上級者向けサブスクリプションが必要です。

   1. サイドメニューから、**Collaborate** > **Active Integrations** を選択します。
   2. 検索バーを使用して **Tapjoy** を検索し、選択します。
   3. **Permissions** (権限) タブに移動します。
   4. **Ad Network Permissions** (広告ネットワークの権限) をオンにします。
      5.権限 **Access ad revenue raw data (UA signals)** (広告収益生データ (UA 信号) へのアクセス) をオンにします。
      6.**Save** を選択します。

   詳細については、Appsflyer ドキュメントの[UA 広告ネットワークの広告収益信号](https://support.appsflyer.com/hc/en-us/articles/4402898251409-Ad-revenue-signals-for-UA-ad-networks#set-the-ad-revenue-report-in-data-locker) を参照してください。

   ![AppsFlyer ダッシュボードの広告収益レポート。](/api/media?file=/grow/media/images/AF_ad_revenue.png)