Pinterest オーディエンスコネクタ構成ガイド
この記事では、Pinterest オーディエンスコネクタの構成方法について説明します。
この記事では、Pinterest オーディエンスコネクタの最新バージョンの使用方法について説明します。以前のバージョンの Pinterest オーディエンスコネクタも引き続き利用できますが、将来的に廃止される予定です。
Pinterest オーディエンスコネクタを更新するには、コネクタを認証し、マッピングを再度追加してください。
API 情報
このコネクタでは、次のベンダー API を使用します。
- API 名:Pinterest REST API
- API バージョン:v5
- API エンドポイント:
https://api.pinterest.com/v5/ - ドキュメント:Pinterest オーディエンス
バッチ処理の上限
このコネクタでは、ベンダーへの大量データ転送に対応するため、リクエストをバッチ処理します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに格納されます。
- リクエストの最大数:10000
- 最も古いリクエストからの最大経過時間:10 分
- リクエストの最大サイズ:1 MB
構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。
このコネクタを追加すると、ベンダーのデータプラットフォームポリシーへの同意を求められます。
コネクタを追加した後、次の構成を行います。
- 広告アカウント ID
(必須)広告アカウントの一意の識別子です。この識別子は、次の方法で確認できます。- 広告主アカウントを所有する Pinterest アカウントにログインし、https://ads.pinterest.com/ に移動します。上部のナビゲーションセクションで、表示中をクリックします。広告アカウント ID は、ドロップダウンリスト内の広告アカウント名の下に表示される番号です。
- 広告 > 概要に移動し、URL パスで広告アカウント ID を確認します。URL は次の形式です:
ads.pinterest.com/advertiser/{ad_account_id}/?...。
接続を確立をクリックして Pinterest に接続します。
認証トークンは 60 日後に期限切れになります。オーディエンス同期の中断を防ぐため、少なくとも 60 日に 1 回は Tealium にログインし、接続を確立をクリックしてください。
顧客リストの作成
Pinterest で顧客リストを作成するには、次の手順を実行します。
- 顧客リストを作成をクリックします。
- 顧客リスト名を入力します。
- オーディエンス名を入力します。顧客リストが正常に作成されると、タイプが
CUSTOMER_LISTの Pinterest オーディエンスが自動的に作成されます。 - 顧客リストのタイプを選択します。
- メール:識別子として使用するメールアドレス。
- Apple 広告識別子(IDFA):Apple がユーザーのデバイスに割り当てるランダムなデバイス識別子。IDFA を使用して、ユーザーがモバイル広告キャンペーンを操作したタイミングを特定することもできます。これは、チャネルが IDFA トラッキングを提供し、広告主が広告を正常に操作したユーザーを追跡している場合に可能です。
- モバイル広告 ID(MAID):Android または Apple がモバイルデバイスに割り当てる、16 進数の文字列。
アクション構成 - パラメータとオプション
- メールアドレス、MAID、または IDFA のリストを、任意の組み合わせで 1 行につき 1 レコード入力します。
- メールアドレスは小文字にする必要があり、プレーンテキストまたは SHA1、SHA256、MD5 のいずれかでハッシュ化した値を使用できます。
- MAID と IDFA は、SHA1、SHA256、MD5 のいずれかでハッシュ化する必要があります。
- オーディエンスの説明を入力します。
- 完了をクリックします。
アクションの名前を入力し、ドロップダウンリストからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションを構成する方法について説明します。
アクション
| アクション名 | 訪問プロファイル | イベントデータ |
|---|---|---|
| ユーザーをオーディエンスに追加 | ✓ | ✗ |
| ユーザーをオーディエンスから削除 | ✓ | ✗ |
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションを構成する方法について説明します。
ユーザーをオーディエンスに追加
パラメータ
| パラメータ | 説明 |
|---|---|
| 顧客リスト | レコードを追加するリストを選択します。 顧客リストはオーディエンスの一種です。詳細については、オーディエンスターゲティング、または広告管理ガイドのオーディエンスセクションを参照してください。 |
| メールアドレス(プレーンテキスト) | プレーンテキストのメールアドレス(@ を含む必要があります)を指定します。 |
| メールアドレス(ハッシュ化済み) | 前後の空白を削除し、小文字に変換して、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 でハッシュ化します。 |
ユーザーをオーディエンスから削除
パラメーター
| パラメーター | 説明 |
|---|---|
| 顧客リスト | レコードを削除するリストを選択します。 顧客リストはオーディエンスの一種です。詳細については、オーディエンスターゲティングまたは広告管理ガイドのオーディエンスセクションを参照してください。 |
| メールアドレス(プレーンテキスト) | プレーンテキストのメールアドレス(@を含む必要があります)を指定します。 |
| メールアドレス(ハッシュ化済み) | 空白文字のトリミングと小文字化が行われ、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を使用してこの値をハッシュ化します。 |
最終更新日 :: 2026年November月18日