# Adobe Analytics Import Integration V2

Adobe Analytics Import Integration v2を使用すると、Adobe Analyticsによって生成されたdata feedをネイティブconnectorを通じてTreasure dataに直接取り込むことができます。Adobe Analyticsユーザーが利用するクラウドストレージサービスとの柔軟性が向上しています。

Adobe Analyticsは、組織がデジタル顧客インタラクションからデータを収集し、実用的なインサイトを得ることを可能にします。詳細については、[Adobe experience league docs](https://experienceleague.adobe.com/docs/analytics/analyze/admin-overview/analytics-overview.html?lang=en)を参照してください。

## 前提条件

- [TD Toolbelt](https://toolbelt.treasuredata.com/)を含むTreasure Dataの基本知識。
- Adobe Analyticsの基本知識


## Treasure Data Integration の静的 IP アドレス

セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります:
[https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/](https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/)

## TD Consoleを使用したAdobe Analyticsからのインポート

### **Authenticationの作成**

connectorはdata sourceとしてクラウドストレージサービスをサポートしています。data sourceにアクセスするには、authenticationを設定する必要があります。

1. **Integrations Hub**を選択します。
2. **Catalog**を選択します。
![](/assets/26617500.ca92fa4ab9277dca95973c6bd413fc662a3f0d04b57d58f7a8c952a29f28bbec.6bd3f7a7.png)
3. 名前"*Adobe Analytics V2*"でCatalog内のIntegrationを検索するか、カテゴリ"*Web/Mobile analytics services*"および/または"*Business Intelligence*"でフィルタリングします。
4. アイコンにマウスを合わせ、**Create Authentication**を選択します。
5. Adobe Analyticsからdata feedを受信するクラウドサービスに対応する**Storage Type**を選択します。
![](/assets/newauthen.7b7c1e61ee9667f04ff346388445158bac0eba1545174e72ee7fd4c115567473.4ab63049.png)
6. **Bucket**情報を入力します。
7. **Endpoint**を入力します。または、そのリージョンのデフォルトendpointを使用する場合は**Region**を選択します。
8. **Authentication Method**を選択します。選択した**Storage Type**に応じて、さまざまな方法がサポートされています。例えば、Amazon S3の場合、connectorは以下をサポートしています:
  1. *Basic*
  2. *Session Token*
  3. *Assume Role*
9. 選択した**Authentication Method**に応じて必要な認証情報を入力します。


Storage Type: 現在、選択可能なのはAmazon S3のみです。他のサービスのサポートは将来の実装を予定しており、ロードマップに記載されています。

### **Bucketディレクトリのセットアップ**

file loaderはbucketルート直下に保存されているファイルをサポートしていません。

file loaderによるパフォーマンスと認識を向上させるために、異なるreport suiteのdata feedは別々のディレクトリに保存することをお勧めします。file loaderによる認識を向上させるために、ディレクトリ名には正規化された英数字を使用することをお勧めします。

![](/assets/3194cb61-1a72-4bd8-9b2d-750ab9a37e47.d5d7c75697781d3d44bd729c9f5415f7882a143a80ba0715a868764ddb4d4315.4ab63049.png)

### Import設定 - Hitファイル

connectorはdata feed内のhitファイルとlook upファイルの両方の取り込みをサポートしています。

file loaderはReport Suite IDとPath Prefixを使用してdata feedファイルを検索します。複数のdata feedが見つかった場合、最も古いfeedが選択され、job実行ごとに1つのfeedのみが処理されます。

1. **Target**はインポートするデータのタイプです。
  1. Data Feed: hitファイルをインポートします。
  2. Look Up Data: look upファイルをインポートします。
2. **Target**として**Data Feed Data**を選択します。
3. bucket内の目的のディレクトリへの**Path Prefix**を入力します。
4. **Report Suite ID**を入力します。
5. **Incremental**を選択します。このオプションを有効にすると、import jobは前回の実行タイムスタンプ以降にbucketにアップロードされたファイルのみを検索します。
6. **Modified After**。このオプションは古いdata feedをフィルタリングするために使用します


Incrementalと適切なjobスケジュールを使用して、次のjob実行時にAdobe Analyticsによって配信される正しいdata feedが選択されるようにすることをお勧めします。

### Import設定 - Look upファイル

Look-upファイルをdatabaseにインポートして、後続のqueryと分析を容易にできます。

1. Source Tableで、**Target**を**Look Up Data**に設定します。


![](/assets/lookup.84f7be4eece0b3e812009d4fe7548a60315c947cca1f3eb5acb92f25cd45cc25.4ab63049.png)


```
lookup_type (filename without extenstion); key (1st column) ; value (2nd column) ; source (datafeed name)
browser                                  ; 1                ; chrome             ; treasuredata_20240101-120000
browser                                  ; 2                ; IE                 ; treasuredata_20240101-120000
country                                  ; 1                ; Afghanistan        ; treasuredata_20240101-120000
country                                  ; 2                ; Albania            ; treasuredata_2024-01-01
country                                  ; 3                ; Algeria            ; treasuredata_2024-01-01
resolution                               ; 1                ; 320 x 200          ; ...
resolution                               ; 2                ; 640 x 240          ; ...
.........
```

### Advance設定

以下の手順に従って、詳細設定、data placement、jobのスケジュールを設定してください。

connectorは、初回リクエストが失敗した場合の再試行をサポートしています。再試行は、hitファイルは見つかったがlook upファイルが見つからない場合にのみ行われます。次の再試行時間はExponential Backoffルールに従って決定されます。ユーザーは以下を設定できます:

#### Data Settingsの設定

1. **Max Retry:** 最大再試行回数。デフォルトは7です。
2. **Initial Retry Wait:** 初回の待機時間(秒単位)。デフォルトは2です。
3. **Max Retry Wait:** 次の再試行前の最大許容待機時間。


![](/assets/retry.dbefabaa9af2c57698deeb05e0e9b6a8ec982ea0b2d9ebd52d48be85418c4d2a.4ab63049.png)

#### Data Previewの設定

hitデータはクリックの生データであるため、connectorはこの画面でダミー値のみを表示します。
![](/assets/data_preview.6e7e25f2329228a11ab296c7f88cd667eb24d8381095d563b0c8022b4a9810af.4ab63049.png)

#### Data Placementの設定

ユーザーは、データをインポートするdatabaseとtableを設定できます。
![](/assets/data-placement.729c6b7749c366871970dcaf6995ca3f79230d64e22473dfbdfe86db8e83b856.4ab63049.png)

1. **Database****and Table:** 宛先を選択するか、新しいものを作成します。
2. **Database**情報を入力します。
3. **Table**情報を入力します。
4. 保存**Method**を選択します。
  1. *Append*
  2. *Always replace*
  3. *Replace on new data.*
5. **Timestamp-based Partition Key**を選択します。


Schedule:

1. **Repeat**を設定します
  1. *On*: スケジュールを設定します。
  2. *Off*
2. **Schedule Timezone**を設定します。スケジュールタイムスタンプのタイムゾーン参照を選択します。