Pinterest Audiences コネクタ構成ガイド

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

API 情報

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

API 名: Pinterest REST API
API バージョン: v5
API エンドポイント: https://api.pinterest.com/v5/
ドキュメント: Pinterest Audiences

バッチ制限

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

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

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、About Connectorsを参照してください。

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

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

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

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

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

顧客リストの作成

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

Create Customer List をクリックします。
顧客リスト名を入力します。
オーディエンス名を入力します。成功した顧客リストの作成後、タイプ CUSTOMER_LIST の Pinterest オーディエンスが自動的に作成されます。
顧客リストのタイプを選択します：
- Email: 識別子としてのメールアドレス。
- Apple Identifier for Advertisers (IDFA): Apple がユーザーのデバイスに割り当てるランダムなデバイス識別子です。チャンネルが IDFA トラッキングを提供し、広告主が広告とのやり取りを追跡する場合、IDFA を使用してユーザーを識別することができます。
- Mobile Ad ID (MAID): Android または Apple がモバイルデバイスに割り当てる16進数の文字列です。

アクション構成 - パラメータとオプション

メール、MAID、または IDFA を任意の組み合わせで1行に1レコードずつ入力します。
- メールは小文字で、プレーンテキストまたは SHA1、SHA256、MD5 でハッシュ化することができます。
- MAID と IDFA は SHA1、SHA256、MD5 でハッシュ化する必要があります。
オーディエンスの説明を入力します。
Done をクリックします。

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

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

アクション

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

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

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

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

パラメータ

パラメータ	説明
顧客リスト	レコードを追加するリストを選択します。顧客リストはオーディエンスの一種です。詳細については、Audience 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 ハッシュを使用してハッシュ化します。

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

パラメータ

パラメータ	説明
顧客リスト	レコードを削除するリストを選択します。顧客リストはオーディエンスの一種です。詳細については、オーディエンスターゲティングまたは広告管理ガイドのオーディエンスセクションを参照してください。
メールアドレス（プレーンテキスト）	プレーンテキストのメールアドレスを提供してください（`@`を含む必要があります）。
メールアドレス（既にハッシュ化）	既に空白をトリムし、小文字に変換し、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ハッシュを使用してハッシュ化します。