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など）を識別するために使用されていました。しかし、現在ではオーディエンスは同じオーディエンスに対して複数のユーザー識別子を受け入れる能力を持っており、このフィールドはもはや必要ありません。

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

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

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

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

ユーザー識別子

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

パラメータ	タイプ	説明
メール	文字列	すでに空白を削除し、小文字にし、SHA256でハッシュ化したプレーンテキストのメールアドレスを提供します。ハッシュ化されていないメールアドレスがマップされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択します。
電話番号	文字列	すでに空白を削除し、小文字にし、SHA256でハッシュ化したプレーンテキストの電話番号を提供します。ハッシュ化されていない電話番号がマップされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択します。
デバイスID	文字列	すでに空白を削除し、小文字にし、SHA256でハッシュ化したデバイスIDを提供します。この値は、iOS広告識別子、Google広告ID、または利用可能でない場合はAndroid IDであるべきです。ハッシュ化されていないデバイスIDがマップされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択してください。
Twitterハンドル	文字列	すでに空白を削除し、小文字にし、SHA256でハッシュ化したXハンドルを提供します。ハッシュ化されていないXハンドルがマップされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択します。
Twitter ID	String	すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたX IDを提供してください。X IDは、Xのすべてのアカウントが持つ一意の値です。同じIDを持つ2人の人物はいません。アカウントは@handleを変更することができますが、X IDを変更することはできません。ハッシュ化されていないX IDがマッピングされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択してください。
パートナーユーザーID	String	パートナーユーザーIDを提供してください。ハッシュ化されていないパートナーユーザーIDがマッピングされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択してください。
ユーザー識別子ハッシュ化	Boolean	ユーザー識別子がすでにハッシュ化されている場合は、このチェックボックスを選択してください。そうでない場合、コネクタはマッピングされた値をnormalizeしてハッシュ化します。

パラメータ

パラメータ	説明
カスタムオーディエンス	必須 リストからオーディエンスを選択します。この値はX Adsアカウントから取得され、AudienceStream構成画面を通じて作成するとすぐに表示されます。 詳細については、Custom Audiencesを参照してください。
有効日時	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効になるUTC時間。 ISO 8601形式で表現されます。 デフォルトでは現在の日付と時間になります。 エポックタイムスタンプ（ミリ秒）を提供することもでき、正しくフォーマットされます。
有効期限	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効期限を迎えるUTC時間。 指定された時間は、有効日時の値よりも後でなければなりません。 ISO 8601形式で表現されます。 デフォルトでは、構成されたデフォルトの有効期限（通常は有効日時から30日または720時間）になります。

アクション - ユーザーをカスタムオーディエンスに追加（複数の識別子）

ユーザー識別子

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

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

パラメータ

パラメータ	説明
カスタムオーディエンス	必須 リストからオーディエンスを選択します。この値はX Adsアカウントから取得され、AudienceStream構成画面を通じて作成するとすぐに表示されます。 詳細については、Custom Audiencesを参照してください。
有効日時	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効になるUTC時間。 ISO 8601形式で表現されます。 デフォルトでは現在の日付と時間になります。 エポックタイムスタンプ（ミリ秒）を提供することもでき、正しくフォーマットされます。
有効期限	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効期限を迎えるUTC時間。 指定された時間は、有効日時の値よりも後でなければなりません。 ISO 8601形式で表現されます。 デフォルトでは、構成されたデフォルトの有効期限（通常は有効日時から30日または720時間）になります。

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

ユーザー識別子

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

パラメータ	タイプ	説明
メール	String	すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたプレーンテキストのメールアドレスを提供してください。ハッシュ化されていないメールアドレスがマッピングされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択してください。
電話番号	String	すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたプレーンテキストの電話番号を提供してください。ハッシュ化されていない電話番号がマッピングされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択してください。
デバイスID	String	すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたデバイスIDを提供してください。この値は、iOS Advertising Identifier、Google Advertising ID、または利用できない場合はAndroid IDであるべきです。ハッシュ化されていないデバイスIDがマッピングされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択してください。
Twitterハンドル	String	すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたXハンドルを提供してください。ハッシュ化されていないXハンドルがマッピングされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択してください。
Twitter ID	String	すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたX IDを提供してください。X IDは、Xのすべてのアカウントが持つ一意の値です。同じIDを持つ2人の人物はいません。アカウントは@handleを変更することができますが、X IDを変更することはできません。ハッシュ化されていないX IDがマッピングされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択してください。
パートナーユーザーID	String	パートナーユーザーIDを提供してください。ハッシュ化されていないパートナーユーザーIDがマッピングされている場合は、ユーザー識別子ハッシュ化チェックボックスを選択してください。
ユーザー識別子ハッシュ化	Boolean	ユーザー識別子がすでにハッシュ化されている場合は、このチェックボックスを選択してください。そうでない場合、コネクタはマッピングされた値をnormalizeしてハッシュ化します。

パラメータ

パラメータ	説明
カスタムオーディエンス	必須 リストからオーディエンスを選択します。この値はX Adsアカウントから取得され、AudienceStream構成画面を通じて作成するとすぐに表示されます。 詳細については、Custom Audiencesを参照してください。
有効日時	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効になるUTC時間。 ISO 8601形式で表現されます。 デフォルトでは現在の日付と時間になります。 エポックタイムスタンプ（ミリ秒）を提供することもでき、正しくフォーマットされます。
有効期限	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効期限を迎える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 Adsアカウントから取得され、AudienceStream構成画面を通じて作成するとすぐに表示されます。 詳細については、カスタムオーディエンスを参照してください。
有効時刻	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効になるUTC時間。 ISO 8601形式で表現されます。 デフォルトでは現在の日付と時間になります。 エポックタイムスタンプ（ms）を提供することも可能で、適切な形式にフォーマットされます。
有効期限	メンバーシップオプション。 カスタムオーディエンスの関連付けが有効期限を迎えるUTC時間。 指定された時間は有効時刻の値よりも後でなければなりません。 ISO 8601形式で表現されます。 デフォルトでは、有効時刻から通常30日または720時間後の構成されたデフォルトの有効期限になります。