---
title: Pinterest Audiences コネクタ構成ガイド
description: この記事では、Pinterest Audiences コネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/pinterest-audiences-connector/
---

<blockquote>
この記事では、Pinterest Audiences コネクタの最新バージョンの使用に関する情報を提供します。以前のバージョンの Pinterest Audiences コネクタもまだ利用可能ですが、将来的には非推奨となります。<br>あなたの Pinterest Audiences コネクタを更新し、認証し、マッピングを再度追加してください。
</blockquote>


## API 情報

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

* API 名: Pinterest REST API
* API バージョン: v5
* API エンドポイント: `https://api.pinterest.com/v5/`
* ドキュメント: [Pinterest Audiences](https://developers.pinterest.com/docs/ads/targeting/#Audiences)

## バッチ制限

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

* 最大リクエスト数: 10000
* 最古のリクエストからの最大時間: 10分
* リクエストの最大サイズ: 1 MB

## 構成

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

<blockquote>
このコネクタを追加する際には、ベンダーのデータプラットフォームポリシーを受け入れるよう求められます。
</blockquote>


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

* **広告アカウント ID**  
 (必須) 広告アカウントの一意の識別子です。この識別子は以下の方法で見つけることができます：
    * 広告主アカウントを所有する Pinterest アカウントにログインし、[https://ads.pinterest.com/](https://ads.pinterest.com) に移動します。上部ナビゲーションセクションで **Viewing** をクリックします。ドロップダウンリストの広告アカウント名の下に広告アカウント ID が表示されます。
    * **Ads > Overview** に移動し、URL パスで広告アカウント ID を探します。URL は次の形式を使用します：`ads.pinterest.com/advertiser/{ad_account_id}/?...`。

**Establish Connection** をクリックして Pinterest に接続します。


<blockquote>
認証トークンは 60 日後に期限切れになります。オーディエンス同期の中断を防ぐために、Tealium にログインして少なくとも 60 日に一度 **Establish Connection** をクリックしてください。
</blockquote>


### 顧客リストの作成

Pinterest で顧客リストを作成するには：

1. **Create Customer List** をクリックします。
1. 顧客リスト名を入力します。
1. オーディエンス名を入力します。成功した顧客リストの作成後、タイプ `CUSTOMER_LIST` の Pinterest オーディエンスが自動的に作成されます。
1. 顧客リストのタイプを選択します：
    * **Email**: 識別子としてのメールアドレス。
    * **Apple Identifier for Advertisers (IDFA)**: Apple がユーザーのデバイスに割り当てるランダムなデバイス識別子です。チャンネルが IDFA トラッキングを提供し、広告主が広告とのやり取りを追跡する場合、IDFA を使用してユーザーを識別することができます。
    * **Mobile Ad ID (MAID)**: Android または Apple がモバイルデバイスに割り当てる16進数の文字列です。
## アクション構成 - パラメータとオプション
1. メール、MAID、または IDFA を任意の組み合わせで1行に1レコードずつ入力します。
    * メールは小文字で、プレーンテキストまたは SHA1、SHA256、MD5 でハッシュ化することができます。
    * MAID と IDFA は SHA1、SHA256、MD5 でハッシュ化する必要があります。
1. オーディエンスの説明を入力します。
1. **Done** をクリックします。

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

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

## アクション

| アクション名 | AudienceStream | EventStream |
| --- | :---: | :---: |
| オーディエンスにユーザーを追加 | ✓ | ✗ |
| オーディエンスからユーザーを削除 | ✓ | ✗ |

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

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

### オーディエンスにユーザーを追加

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| 顧客リスト | レコードを追加するリストを選択します。<br>顧客リストはオーディエンスの一種です。詳細については、[Audience targeting](https://help.pinterest.com/en/business/article/audience-targeting) または広告管理ガイドの [Audiences](https://developers.pinterest.com/docs/ads/targeting/#Audiences) セクションを参照してください。 |
| メールアドレス (プレーンテキスト) | プレーンテキストのメールアドレスを提供します（`@`を含む必要があります）。 |
| メールアドレス (既にハッシュ化されている) | 既に空白トリム、小文字化、MD5、SHA1、SHA256でハッシュ化されたメールアドレスを提供します。 |
| メールアドレス (MD5 ハッシュを適用) | プレーンテキストのメールアドレス（`@`を含む必要があります）を提供し、コネクタがこの値を空白トリム、小文字化し、MD5 ハッシュを使用してハッシュ化します。 |
| メールアドレス (SHA1 ハッシュを適用) | プレーンテキストのメールアドレス（`@`を含む必要があります）を提供し、コネクタがこの値を空白トリム、小文字化し、SHA1 ハッシュを使用してハッシュ化します。 |
| メールアドレス (SHA256 ハッシュを適用) | プレーンテキストのメールアドレス（`@`を含む必要があります）を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256 ハッシュを使用してハッシュ化します。 |
| Apple IDFA (既にハッシュ化されている) | 既に空白トリムされ、MD5、SHA1、SHA256でハッシュ化された広告主識別子を提供します。 |
| Apple IDFA (MD5 ハッシュを適用) | 広告主識別子を提供し、コネクタがこの値を空白トリムし、MD5 ハッシュを使用してハッシュ化します。 |
| Apple IDFA (SHA1 ハッシュを適用) | 広告主識別子を提供し、コネクタがこの値を空白トリムし、SHA1 ハッシュを使用してハッシュ化します。 |
| Apple IDFA (SHA256 ハッシュを適用) | 広告主識別子を提供し、コネクタがこの値を空白トリムし、SHA256 ハッシュを使用してハッシュ化します。 |
| モバイル広告 ID (既にハッシュ化されている) | 既に空白トリムされ、MD5、SHA1、SHA256でハッシュ化されたモバイル広告 ID を提供します。 |
| モバイル広告 ID (MD5 ハッシュを適用) | モバイル広告 ID を提供し、コネクタがこの値を空白トリムし、MD5 ハッシュを使用してハッシュ化します。 |
| モバイル広告 ID (SHA1 ハッシュを適用) | モバイル広告 ID を提供し、コネクタがこの値を空白トリムし、SHA1 ハッシュを使用してハッシュ化します。 |
| モバイル広告 ID (SHA256 ハッシュを適用) | モバイル広告 ID を提供し、コネクタがこの値を空白トリムし、SHA256 ハッシュを使用してハッシュ化します。 |

### オーディエンスからユーザーを削除


#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| 顧客リスト | レコードを削除するリストを選択します。<br>顧客リストはオーディエンスの一種です。詳細については、[オーディエンスターゲティング](https://help.pinterest.com/en/business/article/audience-targeting)または広告管理ガイドの[オーディエンス](https://developers.pinterest.com/docs/ads/targeting/#Audiences)セクションを参照してください。 |
| メールアドレス（プレーンテキスト） | プレーンテキストのメールアドレスを提供してください（`@`を含む必要があります）。 |
| メールアドレス（既にハッシュ化） | 既に空白をトリムし、小文字に変換し、MD5、SHA1、またはSHA256でハッシュ化されたメールアドレスを提供してください。 |
| メールアドレス（MD5ハッシュを適用） | プレーンテキストのメールアドレス（`@`を含む必要があります）を提供し、コネクタがこの値を空白トリム、小文字化し、MD5ハッシュを使用してハッシュ化します。 |
| メールアドレス（SHA1ハッシュを適用） | プレーンテキストのメールアドレス（`@`を含む必要があります）を提供し、コネクタがこの値を空白トリム、小文字化し、SHA1ハッシュを使用してハッシュ化します。 |
| メールアドレス（SHA256ハッシュを適用） | プレーンテキストのメールアドレス（`@`を含む必要があります）を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。 |
| Apple IDFA（既にハッシュ化） | 既に空白をトリムし、MD5、SHA1、またはSHA256でハッシュ化された広告主識別子を提供してください。 |
| Apple IDFA（MD5ハッシュを適用） | 広告主識別子を提供し、コネクタがこの値を空白トリムし、MD5ハッシュを使用してハッシュ化します。 |
| Apple IDFA（SHA1ハッシュを適用） | 広告主識別子を提供し、コネクタがこの値を空白トリムし、SHA1ハッシュを使用してハッシュ化します。 |
| Apple IDFA（SHA256ハッシュを適用） | 広告主識別子を提供し、コネクタがこの値を空白トリムし、SHA256ハッシュを使用してハッシュ化します。 |
| モバイル広告ID（既にハッシュ化） | 既に空白をトリムし、MD5、SHA1、またはSHA256でハッシュ化されたモバイル広告IDを提供してください。 |
| モバイル広告ID（MD5ハッシュを適用） | モバイル広告IDを提供し、コネクタがこの値を空白トリムし、MD5ハッシュを使用してハッシュ化します。 |
| モバイル広告ID（SHA1ハッシュを適用） | モバイル広告IDを提供し、コネクタがこの値を空白トリムし、SHA1ハッシュを使用してハッシュ化します。 |
| モバイル広告ID（SHA256ハッシュを適用） | モバイル広告IDを提供し、コネクタがこの値を空白トリムし、SHA256ハッシュを使用してハッシュ化します。 |