# Reddit Custom Audience Integration

Reddit Custom Audience出力コネクタを使用すると、Treasure DataからReddit Adsにオーディエンスデータを統合およびエクスポートできます。このコネクタは、Reddit Adsプラットフォーム内でカスタムオーディエンスとキャンペーンターゲティングの管理を容易にします。

## 前提条件

RedditのAPI要件として、Reddit Adsに送信されるデータは**追跡可能で、Redditのリクエストに応じて削除可能である必要があります**。そのため、このコネクタを有効にする前に**明示的な確認を取得する必要があります**。お客様のアカウントでこのコネクタを有効にするには、カスタマーサクセスマネージャーまたはTreasure Dataサポートにお問い合わせください。

- Treasure Dataの基本的な知識
- Reddit Adsの基本的な知識
- Reddit Ads Account IDを取得できること
- クエリのカラムは、正確なカラム名とデータ型で指定する必要があります
- クエリのカラムには、emailまたはmaidのいずれか1つ以上のカラムが含まれている必要があります


## 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を使用した接続の作成

クエリを実行する前に、Treasure Dataでデータ接続を作成および設定する必要があります。データ接続の一部として、統合にアクセスするための認証を提供します。

### 認証の作成

最初のステップは、一連の認証情報を使用して新しい認証を作成することです。

1. **Integrations Hub**を選択します。
2. **Catalog**を選択します。


![](/assets/braze-cohort-export-integration-2024-05-29.520810dbdd3bfc5694a09fbeb88a8e30c9c4531c7b4cb3d73789167eff2cf346.b520e344.png)

1. Catalogで統合を検索し、アイコンの上にマウスを移動して**Create Authentication**を選択します。


![](/assets/braze-cohort-export-integration-2024-05-29-1.48b66198d22d5b6ac99bad6bfe024a58ea42a11b234f01152cbe105560bda2e3.b520e344.png)

1. **Click here**リンクをクリックして、OAuth認証フローを開始します
2. ![](/assets/screenshot-2025-05-06-at-09.32.26.a7a5af076bf49ff4830d14826d384a2487f91ad7d07719abb386037abb91e8b0.454d3c46.png)
3. OAuth接続を選択し、continueをクリックします。
4. 認証の名前を入力し、**Done**を選択します。


### クエリの定義

1. **Data Workbench > Queries**に移動します。
2. **New Query**を選択します。
3. クエリを実行して結果セットを検証します。


![](/assets/screenshot-2025-05-06-at-09.44.45.f9e80546babec398de80e594c8850a49927165f55337cc1ab72c469a3f8f039f.454d3c46.png)

### 結果のエクスポート先の指定

1. **Export Results**を選択します。


![](/assets/screenshot-2025-05-06-at-09.46.41.169c9703b8757d68ad56a4cae8b7edadbb5d7b9f717b8dae4786f2b79daf797b.454d3c46.png)

1. エクスポートパラメータを入力します。


![](/assets/screenshot-2025-05-06-at-09.49.17.15abda30018c903c25c8718b0932beb63a97982748ee28b8944206751d15c40a.454d3c46.png)

**パラメータ設定**

| フィールド | 説明 |
|  --- | --- |
| Add Account ID | Reddit Add Account IDです。ユーザーはAudience Manager画面で取得できます。 |
| Custom Audience Name | Redditのカスタムオーディエンス名です。入力した名前がReddit Adsに既に存在する場合、コネクタはこのカスタムオーディエンス名を使用します。存在しない場合は、Reddit Adsに新しいオーディエンス名を作成します。注意：Reddit Adsに複数のカスタムオーディエンス名がある場合、コネクタは最初のものを使用します。 |
| Action Type | 2つのアクションタイプをサポートしています： - ADD：カスタムオーディエンスユーザーをこのリストに追加します。 - REMOVE：カスタムオーディエンスユーザーをこのリストから削除します。 |
| Skip on Invalid Record | 有効にすると、無効なレコードでもジョブは実行を続けます。無効にすると、ジョブは停止します。 |


### クエリ例

クエリのカラムは、正確なカラム名とデータ型で指定する必要があります。
クエリのカラムには、**email**または**maid**のいずれか1つ以上のカラムが含まれている必要があります。


```sql
SELECT
 email,
 maid
FROM
 reddit_custom_audiences
```

### カラム名とデータ型

| カラム名 | データ型 | 検証の有無 | ハッシュ化（SHA-256） |
|  --- | --- | --- | --- |
| email | String | はい。ハッシュ化されていない値（生データ）のメール形式を検証します | 値がすでにSHA-256ハッシュ化されている場合はそのまま保持し、そうでない場合はSHA-256でハッシュ化します。 |
| maid | String | いいえ | 値がすでにSHA-256ハッシュ化されている場合はそのまま保持し、そうでない場合はSHA-256でハッシュ化します。 |


### （オプション）CLIを使用したエクスポート統合

CLI（Toolbelt）を使用して、Reddit Custom Audienceに結果をエクスポートすることもできます。

オプションの形式はJSONで、一般的な構造は次のとおりです。


```
type: reddit_custom_audiencetd_authentication_id: 12345ad_account_id: a2_abcdefcustom_audience_name: audience nameaction_type: ADDskip_invalid_record: true
```

### パラメータ

| 名前 | 説明 | 値 | デフォルト値 | 必須 |
|  --- | --- | --- | --- | --- |
| type | エクスポート先のサービス名を記述します。 | reddit_custom_audience | N/A | はい |
| td_authentication_id | Consoleで作成された認証IDです。 |  |  | はい |
| ad_account_id | Reddit AdsのAdd Account IDです。 | N/A | N/A | はい |
| custom_audience_name | カスタムオーディエンス名です。存在しない場合、コネクタはReddit Adsに作成をリクエストします。 |  |  | はい |
| action_type | カスタムオーディエンスユーザーのアップロードモードです。 | サポートされている値：- ADD - REMOVE | ADD | はい |
| skip_invalid_record | 無効なレコードを処理する際にジョブを続行するか停止するかを示すフラグです。 | true/false | true | いいえ |


### 使用例


```bash
$ td query --result '{"type":"reddit_custom_audience","td_authentication_id": 1234,"ad_account_id":"a2_abcdef","custom_audience_name":"test","action_type":"ADD","skip_invalid_record":false}' \
-d sample_datasets "select email, maid from www_access" -T presto
```

### (オプション) Query Export ジョブをスケジュールする

Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。

Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。

2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。

例えば、cron スケジュールが `'0 0 1 * 1'` の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。

#### TD Console を使用してジョブをスケジュールする

1. **Data Workbench > Queries** に移動します
2. 新しいクエリを作成するか、既存のクエリを選択します。
3. **Schedule** の横にある None を選択します。
![](/assets/image2021-1-15_17-28-51.f1b242f6ecc7666a0097fdf37edd1682786ec11ef80eff68c66f091bc405c371.0f87d8d4.png)
4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:
![](/assets/image2021-1-15_17-29-47.45289a1c99256f125f4d887e501e204ed61f02223fde0927af5f425a89ace0c0.0f87d8d4.png)
| ドロップダウン値 | 説明 |
|  --- | --- |
| Custom cron... | [Custom cron... の詳細](#custom-cron-details)を参照してください。 |
| @daily (midnight) | 指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。 |
| @hourly (:00) | 毎時 00 分に実行します。 |
| None | スケジュールなし。 |


#### Custom cron... の詳細

![](/assets/image2021-1-15_17-30-23.0f94a8aa5f75ea03e3fec0c25b0640cd59ee48d1804a83701e5f2372deae466c.0f87d8d4.png)

| **Cron 値** | **説明** |
|  --- | --- |
| `0 * * * *` | 1 時間に 1 回実行します。 |
| `0 0 * * *` | 1 日 1 回午前 0 時に実行します。 |
| `0 0 1 * *` | 毎月 1 日の午前 0 時に 1 回実行します。 |
| "" | スケジュールされた実行時刻のないジョブを作成します。 |



```
 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)
```

次の名前付きエントリを使用できます:

- Day of Week: sun, mon, tue, wed, thu, fri, sat.
- Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.


各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます:

| フィールド値  | 例  | 例の説明  |
|  --- | --- | --- |
| 各フィールドに対して上記で表示された制限内の単一の値。 |  |  |
| フィールドに基づく制限がないことを示すワイルドカード
`'*'`。 | `'0 0 1 * *'` | 毎月 1 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| 範囲 `'2-5'`
フィールドの許可される値の範囲を示します。 | `'0 0 1-10 * *'` | 毎月 1 日から 10 日までの午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| カンマ区切りの値のリスト `'2,3,4,5'`
フィールドの許可される値のリストを示します。 | `0 0 1,11,21 * *'` | 毎月 1 日、11 日、21 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| 周期性インジケータ `'*/5'`
フィールドの有効な値の範囲に基づいて、
スケジュールが実行を許可される頻度を表現します。 | `'30 */2 1 * *'` | 毎月 1 日、00:30 から 2 時間ごとに実行するようにスケジュールを設定します。
`'0 0 */5 * *'` は、毎月 5 日から 5 日ごとに午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| `'*'`
ワイルドカードを除く上記の
いずれかのカンマ区切りリストもサポートされています
`'2,*/5,8-10'` | `'0 0 5,*/10,25 * *'` | 毎月 5 日、10 日、20 日、25 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |


1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。


### クエリを実行する

クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。

設定エラーにより継続的に失敗するスケジュールジョブは、複数回通知された後、システム側で無効化される場合があります。

(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

## Audience Studio で Segment をアクティベートする

Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。

1. **Audience Studio** に移動します。
2. parent segment を選択します。
3. ターゲット segment を開き、右クリックして、**Create Activation** を選択します。
4. **Details** パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。
5. **Output Mapping** パネルで activation 出力をカスタマイズします。


![](/assets/ouput.b2c7f1d909c4f98ed10f5300df858a4b19f71a3b0834df952f5fb24018a5ea78.8ebdf569.png)

- Attribute Columns
  - **Export All Columns** を選択すると、変更を加えずにすべての列をエクスポートできます。
  - **+ Add Columns** を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。**+ Add Columns** を選択し続けて、activation 出力用の新しい列を追加します。
- String Builder
  - **+ Add string** を選択して、エクスポート用の文字列を作成します。次の値から選択します:
    - String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
    - Timestamp: エクスポートの日時。
    - Segment Id: segment ID 番号。
    - Segment Name: segment 名。
    - Audience Id: parent segment 番号。


1. **Schedule** を設定します。


![](/assets/snippet-output-connector-on-audience-studio-2024-08-28.a99525173709da1eb537f839019fa7876ffae95045154c8f2941b030022f792c.8ebdf569.png)

- スケジュールを定義する値を選択し、オプションでメール通知を含めます。


1. **Create** を選択します。


batch journey の activation を作成する必要がある場合は、[Creating a Batch Journey Activation](/products/customer-data-platform/journey-orchestration/batch/creating-a-batch-journey-activation) を参照してください。

## Reddit Adsから必要なパラメータ値を取得する

**Reddit Ads**から**Add Account ID**を取得する必要がある場合があります。以下の手順に従って取得してください。

1. **Reddit Ads**にログインします
2. **Audience Manager**に移動します
3. ![](/assets/screenshot-2025-05-06-at-09.59.53.07c75fe5b085c4b01494c55917d28bf6251ec27a37d25c646b0daa503df23018.454d3c46.png)
4. 下にスクロールして**Data Import Using Cohort Import**を見つけます。
5. ![](/assets/screenshot-2025-05-06-at-10.01.33.2b52e3a20c37557549953fda044cdfef1150affd1ace1d472a736de9829af9cb.454d3c46.png)
6. a2_xyzで始まる値をコピーします