Xカスタムオーディエンスコネクタ構成ガイド

API情報

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

• API名：X Ads API
• APIバージョン：v12
• APIエンドポイント：https://ads-api.x.com/
• ドキュメンテーション：XカスタムオーディエンスAPI

バッチ制限

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

• リクエストの最大数：1000
• 最も古いリクエストからの最大時間：60分
• リクエストの最大サイズ：2MB

前提条件

1. 開発者アカウントにサインアップします。EssentialとElevateddeveloperのアクセス権限はどちらもAds APIにアクセスできます。必要なアクセス権限を決定するために、アクセスレベルを参照してください。
2. 開発者アプリを作成し、トークンを保護します。
3. Ads APIへのアクセスをリクエストします。アプリケーションには正しいアプリIDを含めてください。アプリIDは、開発者ポータルのプロジェクト＆アプリの下で見つけることができます。例：16489123

すでにX開発者プラットフォームを使用しており、開発者アカウントを持っている場合は、ステップ3に進んでください。

仕組み

Xカスタムオーディエンスは、誰があなたのX広告を見るかをコントロールする機能を提供します。X広告は、リアルタイムで最もお客様にとって意味のあるものにメッセージをつなげる強力なコンテキストを提供します。リアルタイムのツイートに関与することで、ビジネスを構築するのに役立つ会話を影響させることができます。

オーディエンスは、あなたのX広告アカウント内のツールで、オーディエンスをレビューし、管理することができます。ツール > オーディエンスに移動することでアクセスできます。

そこから、キャンペーンのターゲティングでカスタムオーディエンスを使用して、直接関心のあるユーザーに到達することができます。Tealiumは、AudienceStream内のユーザーインターフェースを通じてXカスタムオーディエンスを作成し、オーディエンスデータを活用してオーディエンスリストを作成する機能を提供します。さらに、オーディエンスリストはあなたのX広告アカウントで作成し、AudienceStreamに追加または削除するユーザーを追加することができます。再ターゲティングできるオーディエンスの例としては、以前の顧客、まだコンバージョンしていないウェブ訪問、および/または高価値の顧客をターゲットにすることができます。

Tealiumは、カスタムオーディエンスリストからユーザーを追加または削除するためにXに送信できるハッシュ化された識別子のリストを提供します。そして、Xはマッチングを行い、Xでのメディア購入に対して利用可能なセグメントを作成します。あなたのリストはXの@ハンドルとマッチングされるため、キャンペーンで直接ターゲットにすることができ、マーケティングを非常に関連性の高いものにすることができます。

考慮事項

• “パートナーユーザーID"を除くすべてのユーザー識別子は、SHA256ハッシュメソッドと正規化を使用してハッシュ化する必要があります。

• “ユーザー識別子はすでにハッシュ化されている"チェックボックスがチェックされていない場合、コネクタアクションはマップされた値を正規化し、ハッシュ化します。

• カスタムオーディエンスを作成すると、初期の処理期間があります。この期間中、カスタムオーディエンスのユーザーはXシステムによってX @ハンドルに"マッチ"されます。これにより、プロモーション広告をアカウントに配信することが可能になります。

  • カスタムオーディエンスのユーザー全員がアクティブなXユーザーであるとは限らないため、コネクタアクションの発火量よりも最終的なカスタムオーディエンスサイズが小さい場合があります。
  • すべてのカスタムオーディエンスはAudienceStreamに表示されますが、Readyサービングステータスのものだけがキャンペーンのユーザーを適切にターゲットにします。これは、X広告アカウント > オーディエンスセクション内で表示できます。

• オーディエンスは、過去90日間にXが所有し運営するクライアントで活動している少なくとも100人のユーザーとマッチングする場合にのみターゲットにできます。

• 一般的に、オーディエンスの変更は、6-8時間ごとに実行されるバッチで処理されます。オーディエンスの変更が処理中の間、更新される既存のオーディエンスは影響を受けません。

• AudienceStreamを通じて作成されたオーディエンスリストは、広告キャンペーンマネージャー内の"リスト"タイプとして追加されます。

• Xのデータを使用して、Xユーザーについての潜在的に敏感な特性を導き出したり推測したりすることは推奨されません。これらの特性のリストは、X APIの制限された使用についての詳細で見つけることができます。

コネクタアクション

アクション名	AudienceStream	EventStream
カスタムオーディエンスにユーザーを追加	✓	✓
カスタムオーディエンスからユーザーを削除	✓	✓
カスタムオーディエンスにユーザーを追加（複数の識別子）	✓	✓
カスタムオーディエンスからユーザーを削除（複数の識別子）	✓	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタ概要の記事を読んでください。

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

• 広告アカウントID
  • 必須。
  • あなたのX広告アカウントIDを提供します。
  • アカウントIDは、ログインした状態でのアカウントのURLにあります。
  • 例：URLがhttps://ads.x.com/accounts/1234abcd/の場合、アカウントIDは1234abcdです。

カスタムオーディエンスの作成概要

カスタムオーディエンスの作成オーバーレイは、Xカスタムオーディエンスコネクタの構成画面内に表示されます。名前フィールドは、オーディエンスリストの作成に必要な唯一の値です。

list_typeパラメータは以前は、オーディエンスのユーザー識別子タイプ（例：メール、XユーザーID、パートナーユーザーIDなど）を識別するために使用されていました。しかし、現在ではオーディエンスは同じオーディエンスに対して複数のユーザー識別子を受け入れる能力を持っており、このフィールドはもはや必要ありません。

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

次へをクリックするか、アクションタブに移動します。ここでコネクタアクションを構成します。

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

アクション - カスタムオーディエンスにユーザーを追加

パラメータ

パラメータ	説明
カスタムオーディエンス	必須 リストからオーディエンスを選択します。この値はX広告アカウントから取得され、AudienceStreamの構成画面を通じて作成した場合は即座に表示されます。 詳細については、カスタムオーディエンスを参照してください。
デバイスID	ユーザーデバイスID。この値は、iOS広告識別子、Google広告ID、または利用可能でない場合はAndroid IDであるべきです。
メール	ユーザーメール。ハッシュ化されていないメールアドレスがマップされている場合は、ユーザー識別子ハッシュ化チェックボックスを使用してください。それ以外の場合は、SHA256メールをマップしてください。
パートナーユーザーID	パートナーシステム内のユーザーID。 あなたの会社がユーザーを追跡するために独自の標準IDシステムを使用している場合（つまり、メールアドレス、デバイスID、XユーザーIDなどの一般的なユーザー識別子ではない場合）、これが推奨されるパラメータです。
電話番号	ユーザーの電話番号。この値はAPIによってもはやサポートされておらず、マップされるべきではありません
Xハンドル	ユーザーが所有するX @ハンドル。
X ID	ユーザーに属するX ID。X IDは、Xのすべてのアカウントが持つ一意の値です。同じIDを持つ2人の人物はいません。アカウントは@ハンドルを変更することができますが、X IDを変更することはできません
ユーザー識別子のハッシュ化	“パートナーユーザーID"を除くすべてのユーザー識別子は、SHA256ハッシュ法を使用してハッシュ化し、正規化する必要があります。 チェックボックスがチェックされていない場合、Add Userアクションはマップされた値を正規化し、ハッシュ化します。
有効時刻	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効になるべきUTC時間。 ISO 8601で表現されます。 デフォルトでは現在の日付と時刻になります。 エポックタイムスタンプのミリ秒（MS）を提供することもでき、正しくフォーマットされます。
有効期限	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効期限を迎えるべきUTC時間。 指定された時間は"Effective At"の値よりも後でなければなりません。 ISO 8601で表現されます。 デフォルトでは、構成されたデフォルトの有効期限（通常は"Effective At"の値から30日または720時間）になります。

アクション - ユーザーをカスタムオーディエンスから削除

パラメータ

パラメータ	説明
カスタムオーディエンス	必須 リストからオーディエンスを選択します。この値はX Adsアカウントから取得され、AudienceStream構成画面を通じて作成するとすぐに表示されます。 詳細については、カスタムオーディエンスを参照してください。
デバイスID	ユーザーのデバイスID。この値は、iOS広告識別子、Google広告ID、または利用できない場合はAndroid IDであるべきです。
メール	ユーザーのメール。ハッシュ化されていないメールアドレスがマップされている場合は、ユーザー識別子ハッシュ化チェックボックスを使用してください。それ以外の場合は、SHA256メールをマップしてください。
パートナーユーザーID	パートナーユーザーID。 あなたの会社がユーザーを追跡するために独自の標準IDシステムを使用している場合（つまり、メールアドレス、デバイスID、XユーザーIDなどの一般的なユーザー識別子ではない場合）、これが推奨されるパラメータです。
電話番号	ユーザーの電話番号。この値はAPIではもうサポートされておらず、マップされるべきではありません
Xハンドル	ユーザーのX @ハンドル。
X ID	ユーザーに属するX ID。X IDは、Xのすべてのアカウントが持つ一意の値です。同じIDを持つ2人の人物はいません。アカウントは@ハンドルを変更することができますが、X IDを変更することはできません
ユーザー識別子のハッシュ化	“パートナーユーザーID"を除くすべてのユーザー識別子は、SHA256ハッシュ法を使用してハッシュ化し、正規化する必要があります。 チェックボックスがチェックされていない場合、Remove Userアクションはマップされた値を正規化し、ハッシュ化します。
有効時刻	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効になるべきUTC時間。 ISO 8601で表現されます。 デフォルトでは現在の日付と時刻になります。 エポックタイムスタンプのミリ秒（ms）を提供することもでき、正しくフォーマットされます。
有効期限	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効期限を迎えるべきUTC時間。 指定された時間は"Effective At"の値よりも後でなければなりません。 ISO 8601で表現されます。 デフォルトでは、構成されたデフォルトの有効期限（通常は"Effective At"の値から30日または720時間）になります。

アクション - ユーザーをカスタムオーディエンスに追加

ユーザー識別子

以下のパラメータのうち少なくとも1つを提供する必要があります：

| パラメータ | タイプ |説明 | | — | — | | メール（SHA256ハッシュを適用） | 文字列 | プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 | | メール（既にSHA256ハッシュ化済み） | 文字列| 既に空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供します。 | | 電話番号（SHA256ハッシュを適用） | 文字列 | プレーンテキストの電話番号を提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 | | 電話番号（既にSHA256ハッシュ化済み） | 文字列| 既に空白トリム、小文字化、SHA256ハッシュ化され、E164形式の電話番号を提供します。 | | デバイスID（SHA256ハッシュを適用） | 文字列| デバイスIDを提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 | | デバイスID（既にSHA256ハッシュ化済み）| 文字列 | 既に空白トリム、小文字化、SHA256ハッシュ化されたデバイスIDを提供します。 | | Xハンドル（SHA256ハッシュを適用）| 文字列 | Xハンドルを提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 | | Xハンドル（既にSHA256ハッシュ化済み） | 文字列| 既に空白トリム、小文字化、SHA256ハッシュ化されたXハンドルを提供します。 | | X ID（SHA256ハッシュを適用） | 文字列| X IDを提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 | | X ID（既にSHA256ハッシュ化済み）| 文字列 | 既に空白トリム、小文字化、SHA256ハッシュ化されたX IDを提供します。 | | パートナーユーザーID | 文字列| パートナーユーザーIDを提供します。 |

パラメータ

パラメータ	説明
カスタムオーディエンス	必須 リストからオーディエンスを選択します。この値はX Adsアカウントから取得され、AudienceStream構成画面を通じて作成するとすぐに表示されます。 詳細については、カスタムオーディエンスを参照してください。
デバイスID	ユーザーのデバイスID。この値は、iOS広告識別子、Google広告ID、または利用できない場合はAndroid IDであるべきです。
メール	ユーザーのメール。ハッシュ化されていないメールアドレスがマップされている場合は、ユーザー識別子ハッシュ化チェックボックスを使用してください。それ以外の場合は、SHA256メールをマップしてください。
パートナーユーザーID	パートナーのシステム内のユーザーID。 あなたの会社が独自の標準IDシステムを使用してユーザーを追跡している場合（つまり、メールアドレス、デバイスID、XユーザーIDなどの一般的なユーザー識別子ではない場合）、これが推奨されるパラメータです。
電話番号	ユーザーの電話番号。この値はAPIではもうサポートされておらず、マップされるべきではありません
Xハンドル	ユーザーのX @ハンドル。
X ID	ユーザーに属するX ID。X IDは、Xのすべてのアカウントが持つ一意の値です。同じIDを持つ2人の人物はいません。アカウントは@ハンドルを変更することができますが、X IDを変更することはできません
ユーザー識別子のハッシュ化	“パートナーユーザーID"を除くすべてのユーザー識別子は、SHA256ハッシュ法を使用してハッシュ化し、正規化する必要があります。 チェックボックスがチェックされていない場合、Add Userアクションはマップされた値を正規化し、ハッシュ化します。
有効時刻	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効になるべきUTC時間。 ISO 8601で表現されます。 デフォルトでは現在の日付と時刻になります。 エポックタイムスタンプのミリ秒（MS）を提供することもでき、正しくフォーマットされます。
有効期限切れ	メンバーシップオプション。 カスタムオーディエンスの関連付けが期限切れになるUTC時間。 指定された時間は、「有効期限」の値よりも後でなければなりません。 ISO 8601で表現されます。 デフォルトでは、「有効期限」の値から通常30日または720時間後に構成されたデフォルトの有効期限になります。

アクション - ユーザーをカスタムオーディエンスから削除

ユーザー識別子

以下のパラメーターのうち少なくとも1つを提供する必要があります：

| パラメータ | タイプ |説明 | | — | — | | メール（SHA256ハッシュを適用） | 文字列 | プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白を削除し、小文字にし、SHA256ハッシュを使用してハッシュ化します。 | | メール（既にSHA256ハッシュ化済み） | 文字列| 既に空白を削除し、小文字にし、SHA256ハッシュ化されたメールアドレスを提供します。 | | 電話番号（SHA256ハッシュを適用） | 文字列 | プレーンテキストの電話番号を提供し、コネクタはこの値を空白を削除し、小文字にし、SHA256ハッシュを使用してハッシュ化します。 | | 電話番号（既にSHA256ハッシュ化済み） | 文字列| 既に空白を削除し、小文字にし、SHA256ハッシュ化され、E164形式になっている電話番号を提供します。 | | デバイスID（SHA256ハッシュを適用） | 文字列| デバイスIDを提供し、コネクタはこの値を空白を削除し、小文字にし、SHA256ハッシュを使用してハッシュ化します。 | | デバイスID（既にSHA256ハッシュ化済み）| 文字列 | 既に空白を削除し、小文字にし、SHA256ハッシュ化されたデバイスIDを提供します。 | | Xハンドル（SHA256ハッシュを適用）| 文字列 | Xハンドルを提供し、コネクタはこの値を空白を削除し、小文字にし、SHA256ハッシュを使用してハッシュ化します。 | | Xハンドル（既にSHA256ハッシュ化済み） | 文字列| 既に空白を削除し、小文字にし、SHA256ハッシュ化されたXハンドルを提供します。 | | X ID（SHA256ハッシュを適用） | 文字列| X IDを提供し、コネクタはこの値を空白を削除し、小文字にし、SHA256ハッシュを使用してハッシュ化します。 | | X ID（既にSHA256ハッシュ化済み）| 文字列 | 既に空白を削除し、小文字にし、SHA256ハッシュ化されたX IDを提供します。 | | パートナーユーザーID | 文字列| パートナーユーザーIDを提供します。 |

パラメータ

パラメータ	説明
カスタムオーディエンス	必須 リストからオーディエンスを選択します。この値はX広告アカウントから取得され、AudienceStream構成画面を通じて作成するとすぐに表示されます。 詳細については、カスタムオーディエンスを参照してください。
デバイスID	ユーザーのデバイスID。この値は、iOS広告識別子、Google広告ID、または利用できない場合はAndroid IDであるべきです。
メール	ユーザーのメール。ハッシュ化されていないメールアドレスがマッピングされている場合は、ユーザー識別子ハッシュ化チェックボックスを使用してください。それ以外の場合は、SHA256メールをマッピングしてください。
パートナーユーザーID	パートナーユーザーID。 あなたの会社がユーザーを追跡するために独自の標準IDシステムを使用している場合（例えば、メールアドレス、デバイスID、XユーザーIDなどの一般的なユーザー識別子ではない場合）、これが推奨されるパラメーターです。
電話番号	ユーザーの電話番号。この値はAPIによってもはやサポートされておらず、マッピングされるべきではありません
Xハンドル	ユーザーが所有するX @ハンドル。
X ID	ユーザーが所有するX ID。X IDは、Xのすべてのアカウントに固有の値です。同じIDを持つ2人の人物はいません。アカウントは@ハンドルを変更することができますが、X IDを変更することはできません
ユーザー識別子ハッシュ化	“パートナーユーザーID"を除くすべてのユーザー識別子は、SHA256ハッシュ化方法と正規化を使用してハッシュ化する必要があります。 チェックボックスがチェックされていない場合、ユーザー削除アクションはマッピングされた値を正規化し、ハッシュ化します。
有効期限	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効になるべきUTC時間。 ISO 8601で表現されます。 デフォルトでは現在の日付と時間になります。 エポックタイムスタンプ（ms）を提供することもでき、正しくフォーマットされます。
有効期限切れ	メンバーシップオプション。 カスタムオーディエンスの関連付けが期限切れになるべきUTC時間。 指定された時間は、「有効期限」の値よりも後でなければなりません。 ISO 8601で表現されます。 デフォルトでは、「有効期限」の値から通常30日または720時間後に構成されたデフォルトの有効期限になります。