Pinterest Audiences コネクタ構成ガイド
この記事では、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
コネクタアクション
アクション名 | AudienceStream | EventStream |
---|---|---|
ユーザーをオーディエンスに追加 | ✓ | ✗ |
ユーザーをオーディエンスから削除 | ✓ | ✗ |
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、About Connectorsを参照してください。
このコネクタを追加すると、ベンダーのデータプラットフォームポリシーを受け入れるように求められます。
コネクタを追加した後、以下の構成を構成します:
- 広告アカウントID
必須。 広告アカウントの一意の識別子。この識別子は、以下の方法で見つけることができます:- 広告主アカウントを所有するPinterestアカウントにログインし、https://ads.pinterest.com/に移動します。上部のナビゲーションセクションでViewingをクリックします。広告アカウントIDは、ドロップダウンリスト内の広告アカウント名の下にある番号になります。
- Ads > Overviewに移動し、URLパス内の広告アカウントIDを探します。URLは次の形式を使用します:
ads.pinterest.com/advertiser/{ad_account_id}/?...
。
Pinterestに接続するには、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をクリックします。
アクション名を入力し、ドロップダウンリストからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション - ユーザーをオーディエンスに追加
パラメータ
パラメータ | 説明 |
---|---|
顧客リスト | レコードを追加するリストを選択します。 顧客リストはオーディエンスの一種です。詳細については、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ハッシュを使用してハッシュ化します。 |
アクション - ユーザーをオーディエンスから削除
パラメータ
パラメータ | 説明 |
---|---|
顧客リスト | レコードを削除するリストを選択します。 顧客リストはオーディエンスの一種です。詳細については、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ハッシュを使用してハッシュ化します。 |
最終更新日 :: 2024年August月7日