---
title: "Singular"
description: "AdaptyとSingularを統合して、マーケティングとサブスクリプションデータを分析します。"
---
[Singular](https://www.singular.net/) は主要なMobile Measurement Partner（MMP）プラットフォームの1つで、マーケティングキャンペーンのデータを収集・可視化します。これにより、企業はキャンペーンのパフォーマンスを追跡できます。
Adaptyは、ストアからの[サブスクリプションイベント](events)を一か所で追跡できる完全なデータセットを提供します。Adaptyを使えば、サブスクライバーの行動を簡単に把握し、ユーザーの好みを理解し、ターゲットを絞った効果的なコミュニケーションに活用できます。この連携により、Singularでサブスクリプションイベントを追跡し、キャンペーンが生み出す収益を正確に分析できます。
Adaptyは、連携で設定されたすべてのサブスクリプションイベントをSingularに送信できます。その結果、Singularダッシュボード内でこれらのイベントを追跡できるようになります。この連携は、広告キャンペーンの効果を評価する際に役立ちます。
## 連携のセットアップ \{#set-up-integration\}
### AdaptyとSingularを接続する \{#connect-adapty-to-singular\}
Singularとの連携をセットアップするには、Adapty ダッシュボードの [Integrations > Singular](https://app.adapty.io/integrations/singular) に移動し、トグルをオンにしてフィールドに入力します。
以下の認証情報が利用できます：
- **Singular SDK Key**：必須。SingularアプリのプロダクションSDKキー。
- **Singular SDK Key (Sandbox)**：オプション。サンドボックス用SingularアプリのSDKキー。設定しない場合、サンドボックスイベントはSingularに送信されません。
両方のキーは、Singularダッシュボードの **Developer tools -> SDK Keys -> SDK Key（**SDKシークレットではありません**）** から確認できます：
認証情報の下には、AdaptyからSingularに送信できる3グループのイベントがあります。Adaptyが提供するイベントの完全なリストは[こちら](events)でご確認ください。
Adaptyが提供するデフォルトのイベント名を使用することをお勧めします。ただし、必要に応じてイベント名を変更することも可能です。
Adaptyはサーバー間連携を使用してサブスクリプションイベントをSingularに送信するため、Singularダッシュボードですべてのサブスクリプションイベントを確認し、獲得キャンペーンと紐付けることができます。
:::warning
連携を設定する前に作成されたプロファイルは、Singularにイベントを送信できません。
:::
### アプリをSingularに接続する \{#connect-your-app-to-singular\}
AdaptyとSingularの連携はサーバー間連携です。そのため、アプリケーションに追加のコードを記述する必要はありません。
## イベント構造 \{#event-structure\}
AdaptyはGETリクエストのクエリパラメーターを使用してSingularにイベントを送信します。各イベントの構造は次のとおりです：
```json
{
"n": "subscription_renewed",
"a": "singular_sdk_key_123",
"p": "iOS",
"i": "com.example.app",
"ip": "192.168.100.1",
"idfa": "00000000-0000-0000-0000-000000000000",
"idfv": "00000000-0000-0000-0000-000000000000",
"ve": "17.0.1",
"att_authorization_status": 3,
"custom_user_id": "user_12345",
"utime": 1709294400,
"amt": 9.99,
"cur": "USD",
"purchase_product_id": "yearly.premium.6999",
"purchase_transaction_id": "GPA.3383...",
"e": "{\"is_revenue_event\":true,\"amt\":9.99,\"cur\":\"USD\",\"purchase_product_id\":\"yearly.premium.6999\",\"purchase_transaction_id\":\"GPA.3383...\"}"
}
```
各パラメーターの説明：
| パラメーター | 型 | 説明 |
|:---------------------------|:--------|:---------------------------------------------------------|
| `n` | String | イベント名（Adaptyイベントからマッピングされたもの）。 |
| `a` | String | Singular SDKキー。 |
| `p` | String | プラットフォーム（"iOS" または "Android"）。 |
| `i` | String | ストアアプリID（バンドルID）。 |
| `ip` | String | ユーザーのIPアドレス。 |
| `idfa` | String | **iOSのみ**。広告主向けID（大文字）。 |
| `idfv` | String | **iOSのみ**。ベンダー向けID（大文字）。 |
| `aifa` | String | **Androidのみ**。Google広告ID（小文字）。 |
| `andi` | String | **Androidのみ**。Android ID（小文字）。 |
| `asid` | String | **Androidのみ**。アプリセットID（小文字）。 |
| `ve` | String | OSバージョン。 |
| `att_authorization_status` | Integer | **iOSのみ**。ATTステータス（例：`3` は承認済み）。 |
| `custom_user_id` | String | ユーザーのカスタマーユーザーID。 |
| `utime` | Long | イベントのUNIXタイムスタンプ（秒単位）。 |
| `amt` | Float | 収益金額。 |
| `cur` | String | 通貨コード（例："USD"）。 |
| `purchase_product_id` | String | ストアのプロダクトID。 |
| `purchase_transaction_id` | String | 元のトランザクションID。 |
| `e` | String | イベント詳細を含むJSONエンコード文字列（以下参照）。 |
`e` パラメーター（カスタムイベントデータ）は、以下を含むJSONエンコード文字列です：
| パラメーター | 型 | 説明 |
|:--------------------------|:--------|:---------------------------------------|
| `is_revenue_event` | Boolean | イベントに収益が含まれる場合は `true`。 |
| `amt` | Float | 収益金額。 |
| `cur` | String | 通貨コード。 |
| `purchase_product_id` | String | ストアのプロダクトID。 |
| `purchase_transaction_id` | String | 元のトランザクションID。 |