---
title: Reddit Conversions コネクタ構成ガイド
description: この記事では、Reddit Conversions コネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/reddit-conversions-connector/
---
## API 情報

このコネクタは以下のベンダー API を使用します：

* API 名：Reddit API
* API バージョン：v3
* API エンドポイント：`https://ads-api.reddit.com/api/v3`
* ドキュメント：[Reddit 広告 API](https://ads-api.reddit.com/docs/v3/)

## バッチ制限
  
このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

* 最大リクエスト数：1000
* 最古のリクエストからの最大時間：60分
* リクエストの最大サイズ：1 MB

## 構成

コネクタマーケットプレイスに移動して新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。

コネクタを追加した後、以下の構成を構成します：

* **アカウント ID**  
  * （必須）コンバージョンイベントが属するReddit広告アカウントのIDです。
  * Reddit広告アカウントIDを見つけるには、Reddit広告UIで **コンバージョンイベント > ピクセルID** に移動します。
  * Reddit広告アカウントには、`adsread`、`history`、`adsconversions`、および `adsleadgendownloader` の権限が必要です。
  * 詳細については、[Reddit: 認証](https://ads-api.reddit.com/docs/v2/#section/Authentication)を参照してください。
* **コンバージョンアクセストークン**  
  * コンバージョンアクセストークンは、コンバージョンイベントデータをReddit Conversions APIに送信するための、期限のない安全なキーです。
  * あなたのビジネス内の任意の広告アカウントの管理者が、この簡単に生成できる共有可能な長期間有効なアクセストークンを使用できます。
  * Redditは、Conversions APIのために開発者アクセストークン/ OAuthよりもコンバージョンアクセストークンの使用を推奨しています。
  * 詳細については、[Reddit: コンバージョンアクセストークン](https://business.reddithelp.com/s/article/conversion-access-token)を参照してください。
  * コンバージョンアクセストークンを使用していない場合は、OAuth認証ワークフローを開始するために **接続を確立** ボタンを使用します。
  * OAuthからコンバージョンアクセストークンに移行するには、トークンをコンバージョンアクセストークンフィールドに入力し、コネクタはそのトークンをOAuthトークンの代わりに使用します。
  * このトークンをイベントごとにオーバーライドするには、Send Conversion V3アクションで **コンバージョンアクセストークンオーバーライド** フィールドをマップします。

## Webイベントの重複排除

このコネクタを[Reddit Pixelタグ](https://docs.tealium.com/reddit-pixel-tag/)からのイベントの重複排除に構成するには、次の命名規則でイベント属性として送信されるイベントIDを使用します：

```nohl
reddit_pixel_event_id_{REDDIT_EVENT}_{TAG_UID}
```

タグのUIDは、Tealium iQの**タグ**テーブルまたはタグの詳細画面で見つけることができます：

![](https://docs.tealium.com/images/server-side-connectors/facebook-pixel-tag-uid.png)

たとえば、UIDが`168`のタグからの購入イベントは、次の属性値を送信します：

```json
{
  "reddit_pixel_event_id_Purchase_168": "028b2ade7478..."
}
```

同じタグからのカートに追加イベントは、次の属性値を送信します：

```json
{
  "reddit_pixel_event_id_AddToCart_168": "084b1cda7461..."
}
```

各タイプのイベントに対して別々のアクションを使用します。イベント固有のイベントID属性を `Event ID` にマップし、一致するイベント名を `Event Name` にマップします。たとえば：

| Tealium属性  | Redditパラメータ |
|:-------------------------|:-------------------|
| `reddit_pixel_event_id_Purchase_168` (属性)   | Event ID           |
| `"Purchase"` (カスタムテキスト) | Event Name         |


<blockquote>
タグUIDなしで命名形式 `reddit_pixel_event_id_{REDDIT_EVENT}` を使用してイベントID属性のみを受け取っている場合は、タグを更新することをお勧めします。詳細については、を参照してください。
</blockquote>


### 自動重複排除

**自動重複排除** 値が入力されている場合、コネクタは対応するイベントID属性を探します。このセクションが入力されていてTealium iQを使用している場合、`Event ID` をマップする必要はありません。ただし、Tealium iQを使用せずにEventStreamを使用している場合は、次のアプローチが必要になる場合があります。

コネクタは次の操作順序に従います：

* **自動重複排除** が入力され、データレイヤーでその値が見つかった場合、その値は `Event ID` にマップされたものよりも優先されます。たとえば、`reddit_pixel_event_id_Purchase_30`。
* **自動重複排除** が入力されているが、タグIDバージョンを見つけることができず、IDが付いていないレガシーバージョンを見つけることができた場合、その値が使用されます。たとえば、`reddit_pixel_event_id_Purchase`。
* **自動重複排除** が入力されているが、値が見つからない場合は、`Event ID` が入力されている場合に使用されます。

## アクション

| アクション名 | AudienceStream | EventStream |
| --- | :---: | :---: |
| Send Conversion V3 | ✗ | ✓ |
| Send Conversion (非推奨) | ✗ | ✓ |

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

### Send Conversion V3

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| イベントタイプデータ | 標準イベントのトラッキングタイプ：カートに追加、ウィッシュリストに追加、リード、ページ訪問、購入、検索、サインアップ、コンテンツ表示、カスタム。 |
| カスタムイベントタイプ | トラッキングタイプが `CUSTOM` に構成されている場合のカスタムイベント名。自由形式、大文字小文字を区別し、スペースを含む64文字まで。たとえば、`Promotion Event` と `PromotionEvent` は異なるイベントとみなされます。Redditは、既存のイベントと一致しない値を構成することを推奨しています。 |
| イベントテスト | RedditテストIDを提供することによりテストを有効にします。 |

#### コンバージョンイベントパラメータ

| **パラメータ** | **説明** |
| --- | --- |
| イベント発生時 | コンバージョンイベントが発生したときのUnixエポックタイムスタンプ（ミリ秒単位）。デフォルトでは、コネクタは自動的に `tealium_timestamp_epoch` をマップします。 |
| コンバージョンID | 特定のコンバージョンイベントに対応する一意のコンバージョンID。コンバージョンIDは重複排除に使用され、複数回送信された場合でも同じコンバージョンイベントが複数回処理されるのを防ぎます。 |
| 値 | 通貨の基本単位での取引の値。 |
| 通貨 | 提供された値のための3文字のISO 4217通貨コード。 |
| アイテム数 | イベントのアイテム数。 |

#### ユーザーデータ

各コンバージョンイベントには、少なくとも1つの帰属信号が必要です。Redditは、帰属の精度とパフォーマンスを向上させるために、可能な限り多くの信号を送信することを推奨しています。次のいずれかが入力されている必要があります：クリックID、メールアドレス、IPアドレス + ユーザーエージェント + 画面サイズ、IDFA、AAID。

| **パラメータ** | **説明** |
| --- | --- |
| RedditクリックID | 単一の広告クリックに関連付けられたReddit生成のID。コネクタは、このフィールドのマッピングを構成しない限り、`rdt_cid`クエリパラメータからこの値を自動的にマッピングします。 |
| メールアドレス | （SHA256ハッシュを適用）プレーンテキストのメールアドレスを提供します。コネクタはこの値を正規化してからハッシュ化します：アドレスを小文字に変換、メールエイリアスを削除（`+`から`@`までのすべてを削除）、ユーザー名から非英数字を削除、その後SHA-256で結果をハッシュ化します。 |
| 電話番号 | （SHA256ハッシュを適用）プレーンテキストの電話番号を提供します。コネクタはこの値を正規化してからハッシュ化します：拡張子を削除、すべての非数字文字を削除、番号が`+`（E.164形式）で始まることを確認、その後SHA-256で結果をハッシュ化します。 |
| IPアドレス | マッピングされたIPアドレスをコネクタがSHA256でハッシュ化します。 |
| ユーザーエージェント | ユーザーのブラウザのユーザーエージェント。 |
| 外部ID | （SHA256ハッシュを適用）ユーザーに対して広告主が割り当てた永続的な識別子（RedditクリックIDまたは追加の帰属信号を伴う必要があります）。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュ化します。 |
| IDFA | （SHA256ハッシュを適用）ユーザーのデバイスのIDFA。コネクタはこの値をダッシュ付きの大文字UUID形式に正規化してから、SHA-256でハッシュ化します。`00000000-0000-0000-0000-000000000000`のようなプレースホルダー値は破棄されます。 |
| AAID | （SHA256ハッシュを適用）ユーザーのデバイスのAAID。コネクタはこの値をダッシュ付きの小文字UUID形式に正規化してから、SHA-256でハッシュ化します。`00000000-0000-0000-0000-000000000000`のようなプレースホルダー値は破棄されます。 |
| 画面の高さ | ユーザーの画面の高さ（ピクセル単位）。 |
| 画面の幅 | ユーザーの画面の幅（ピクセル単位）。 |
| UUID | ドメイン上のファーストパーティピクセル`_rdt_uuid`クッキーからの値。完全な値またはUUID部分のみを使用します。この値はハッシュ化されません。コネクタは、このフィールドのマッピングを構成しない限り、`_rdt_uuid`クッキーからこの値を自動的にマッピングします。 |

#### 製品データ

| **パラメータ** | **説明** |
| --- | --- |
| 製品ID | 製品IDの配列。 |
| 製品名 | 製品名の配列。 |
| 製品カテゴリ | 製品カテゴリの配列。 |

#### データ処理オプション

| **パラメータ** | **説明** |
| --- | --- |
| モード | このコンバージョンイベントのデータ処理モードの配列。Redditは`LDU`（限定データ使用）のみをサポートします。 |
| 国 | ユーザーの国コード（ISO 3166-1 alpha-2標準）。 |
| 地域 | ユーザーの地域コード（ISO 3166-2標準）または国のプレフィックスなしの地域コード。 |
| アカウントIDオーバーライド | コンバージョンイベントが属するReddit広告アカウントのID。 |
| コンバージョンアクセストークンオーバーライド | このイベントのためにコネクタ構成で構成されたコンバージョンアクセストークンをオーバーライドします。複数のReddit広告アカウントへのイベントのルーティングや、セキュア属性からトークンを割り当てるためにこのフィールドを使用します。このフィールドが空またはマッピングされていない場合、コネクタは構成された値を使用します。構成されていない場合、イベントはスキップされます。異なるオーバーライドトークンを持つイベントは別々のリクエストに分割されます。 |

#### 自動マッピング無効

| **パラメータ** | **説明** |
| --- | --- |
| 自動マッピング無効 | 有効にすると、コネクタはデフォルトで自動マッピングされた値をベンダーに送信しません。明示的なマッピングは引き続き適用されます。 |

### コンバージョン送信（非推奨）


<blockquote>
RedditはConversions API v3をローンチしたため、このアクションは非推奨です。既存のアクションマッピングを**Send Conversion V3**アクションに移行するために**Copy Mappings to an Action**を使用することをお勧めします。
</blockquote>


#### API情報

このコネクタは次のベンダーAPIを使用します：

* API名：Reddit API
* APIバージョン：v2.0
* APIエンドポイント：`https://ads-api.reddit.com/api/v2.0`
* ドキュメント：[Reddit API](https://ads-api.reddit.com/docs/v2)

#### パラメータ

| パラメータ | 説明 |
| --- | --- |
| イベント名 | コンバージョン追跡イベントのタイプ。イベント名はリストされた値のいずれか、またはカスタム文字列値のいずれかになります。 |
| イベント時間 | コンバージョンイベントが発生したRFC3339タイムスタンプ。デフォルトでは、コネクタは現在の時間を送信します。|
| コンバージョンID | 特定のコンバージョンイベントに対応する一意のコンバージョンID。コンバージョンIDは重複排除に使用され、複数回送信された場合でも同じコンバージョンイベントが複数回処理されるのを防ぎます。 |
| 取引価値（小数） | 通貨の基本単位での取引の価値。 |
| 通貨 | 提供された値のための3文字のISO 4217通貨コード。 |
| アイテム数 | イベント内のアイテム数。 |
| テストモード | `true`に構成するとAPI統合をテストします。アカウントにデータは投稿されません。 |
| RedditクリックID | 単一の広告クリックに関連付けられたReddit生成のID。 |
| 電話番号（既にSHA256ハッシュ化されている） | すでに空白トリム、小文字化、SHA256ハッシュ化された電話番号を提供します。 |
| 電話番号（SHA256ハッシュを適用） | プレーンテキストの電話番号を提供し、コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュ化します。 |
| メールアドレス（既にSHA256ハッシュ化されている） | すでに空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供します。 |
| メールアドレス（SHA256ハッシュを適用） | プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュ化します。 |
| IPアドレス | マッピングされたIPアドレスをコネクタがSHA256でハッシュ化します。 |
| ユーザーエージェント | ユーザーのブラウザのユーザーエージェント。 |
| 外部ID（既にSHA256ハッシュ化されている） | 広告主が割り当てたユーザーの永続的な識別子（RedditクリックIDまたは追加の帰属信号を伴う必要があります）。すでに空白トリム、小文字化、SHA256ハッシュ化された値を提供します。 |
| 外部ID（SHA256ハッシュを適用） | 広告主が割り当てたユーザーの永続的な識別子（RedditクリックIDまたは追加の帰属信号を伴う必要があります）。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュ化します。 |
| IDFA（既にSHA256ハッシュ化されている） | ユーザーのデバイスのIDFA。すでに空白トリム、小文字化、SHA256ハッシュ化された値を提供します。 |
| IDFA（SHA256ハッシュを適用） | ユーザーのデバイスのIDFA。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュ化します。 |
| AAID（既にSHA256ハッシュ化されている） | ユーザーのデバイスのAAID。すでに空白トリム、小文字化、SHA256ハッシュ化された値を提供します。 |
| AAID（SHA256ハッシュを適用） | ユーザーのデバイスのAAID。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュ化します。 |
| オプトアウト | ユーザーがトラッキングをオプトアウトしたかどうかを示すフラグ。 |
| 画面の高さ | ユーザーの画面の高さ（ピクセル単位）。**画面の高さ**を構成しない場合、`events.user.screen_dimensions`はTealium Collectイベントデータから取得されます。例えば、`data.com.viewport_height`から。 |
| 画面の幅 | ユーザーの画面の幅（ピクセル単位）。**画面の幅**を構成しない場合、`events.user.screen_dimensions`はTealium Collectイベントデータから取得されます。例えば、`data.com.viewport_width`から。 |
| アカウントIDオーバーライド | コンバージョンイベントに関連付けられたReddit広告アカウントのID。このマッピングを使用してアカウントIDを動的にオーバーライドし、必要に応じて1つのコネクタインスタンスで複数のRedditアカウントを使用します。 |

#### 製品データ

| パラメータ | 説明 |
| --- | --- |
| 製品ID | 製品IDの配列。 |
| 製品名 | 製品名の配列。 |
| 製品カテゴリ | 製品カテゴリの配列。 |
#### データ処理

| パラメータ | 説明 |
| --- | --- |
| モード | この変換イベントのデータ処理モード。 |
| 国 | ISO 3166-1 アルファ-2 国コード。 |
| 地域 | ISO 3166-2 地域コード。国のプレフィックスなしで地域コードのみも受け付けます。 |

#### 自動重複排除

| パラメータ | 説明 |
| --- | --- |
| Tealium iQ タグ ID | Tealium iQ タグ UID が提供されると、Tealium は Tealium iQ から送信されたイベント ID 値を自動的に検索します。