# データ収集API仕様

この章では、サイトにAudienceOneの計測タグを追加する手順について説明します。

## I/F仕様

- Endpoint URL: `https://aw.dw.impact-ad.jp/sd/dc/`
- Method: `POST`
- Headers:
  - Content-Type: `application/json`

## JSONデータ定義

### トップレベル定義
```eval_rst
============ ============= ========= ======================================================
Key          Type          Required  Description
============ ============= ========= ======================================================
oid          ``string``    ``true``  AudienceOneのデータオーナーIDハッシュを指定してください
sp           ``string``    ``true``  連携先識別子 ``aonedc``
data         ``array``     ``true``  詳細データオブジェクトを唯一の要素として含む配列。下記を参照してください
============ ============= ========= ======================================================
```

### 詳細データオブジェクト
```eval_rst
============ ============= ============ ======================================================
Key          Type          Required     Description
============ ============= ============ ======================================================
time         ``integer``   ``optional`` イベントが発生したunixタイムスタンプを指定してください。指定しない場合はサーバ側で計測した時間となります
idfa         ``string``    ``optional`` 広告ID
idfa_limited ``integer``   ``optional`` 1:true, 0:false
language     ``string``    ``optional`` 言語設定 ``ja``
locale       ``string``    ``optional`` ロケール ``ja_JP``
timezone     ``string``    ``optional`` タイムゾーン ``Asia/Tokyo``
network      ``string``    ``optional`` 接続方法
os           ``string``    ``optional`` OS
os_version   ``string``    ``optional`` OSバージョン
device       ``string``    ``optional`` 機種のモデル番号 ``iPhone16``
height       ``string``    ``optional`` 画面サイズ高さ
width        ``string``    ``optional`` 画面サイズ横幅
bundle_id    ``string``    ``optional`` iOSはバンドルID、Androidはアプリのパッケージ名
app_name     ``string``    ``optional`` アプリ名
app_version  ``string``    ``optional`` アプリ名バージョン
url_scheme   ``string``    ``optional`` URLスキーム
event        ``string``    ``optional`` イベント識別子（カンマ区切り）
ssid         ``string``    ``optional`` ssid
extras       ``object``    ``optional`` カスタムパラメータ
============ ============= ============ ======================================================
```


## サンプルコード

```bash
curl -X POST -H 'Content-Type: application/json' \
-d '{
  "oid": "b25b43b24a9e171b",
  "sp": "aonedc",
  "data":[
    {
      "extras":{
          "uid":"xxxxxxxxxxxxxxxxx",
          "shop_id":"4824"
      },
      "idfa":"F5C12BF9-0E50-4EBF-B283-1F81BA45D368",
      "event":"CONVERSION",
      "os":"iOS",
      "os_version":"9.3.2",
      "timezone": "Asia/Tokyo",
      "device": "iPhone16",
      "app_name": "ECApp",
      "app_version": "6.0.8"
    }
  ]
}' \
https://aw.dw.impact-ad.jp/sd/dc/
```