--- title: Xカスタムオーディエンスコネクタ構成ガイド description: この記事では、Xカスタムオーディエンスコネクタの構成方法について説明します。 url: https://docs.tealium.com/ja/server-side-connectors/x-custom-audiences-connector/ --- ## API情報 このコネクタは以下のベンダーAPIを使用します： * API名：X広告API * APIバージョン：v12 * APIエンドポイント：`https://ads-api.x.com/` * ドキュメント：[XカスタムオーディエンスAPI](https://developer.x.com/en/docs/x-ads-api/audiences/api-reference) ## バッチ制限 このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます： * 最大リクエスト数：1000 * 最古のリクエストからの最大時間：60分 * リクエストの最大サイズ：2 MB ## 前提条件 1. [開発者アカウント](https://developer.x.com/en/apply-for-access)にサインアップしてください。`Essential`および`Elevateddeveloper`アクセスは広告APIにアクセスできます。必要なアクセスレベルを決定するには、[アクセスレベル](https://developer.x.com/en/docs/x-api/getting-started/about-x-api#v2-access-level)を参照してください。 1. [開発者アプリ](https://developer.x.com/en/apps)を作成し、トークンを確保してください。 1. [広告APIへのアクセスをリクエスト](https://developer.x.com/en/docs/x-ads-api/apply)してください。アプリケーションに正しいアプリIDを含めてください。アプリIDは、[開発者ポータル](https://developer.x.com/en/portal/dashboard)の**プロジェクト＆アプリ**の下で見つけることができます。例：`16489123`
すでにX開発者プラットフォームで構築していて開発者アカウントを持っている場合は、ステップ3に進んでください。
## 仕組み Xカスタムオーディエンスは、X広告を見る人をコントロールすることができます。X広告は、リアルタイムでお客様に最も意味のあるものにメッセージを接続する強力なコンテキストを提供します。リアルタイムのツイートに関与することは、ビジネスの構築に役立つ方法で会話に影響を与えることができます。 オーディエンスは、[X広告](http://ads.x.com)アカウントのツールであり、**ツール > オーディエンス**に移動することでアクセスできます。 そこから、キャンペーンターゲティングでカスタムオーディエンスを使用して、気になるユーザーに直接リーチすることができます。Tealiumは、AudienceStream内のユーザーインターフェースを通じてXカスタムオーディエンスを作成し、オーディエンスデータを活用してオーディエンスリストを充実させる機能を提供します。さらに、オーディエンスリストはX広告アカウントで作成され、AudienceStreamに追加または削除されるユーザーとして取り込まれます。リターゲティング可能なオーディエンスの例には、以前の顧客、まだ転換していないウェブ訪問、および/または高価値顧客が含まれます。 Tealiumは、ハッシュ化された識別子のリストをXに送信して、カスタムオーディエンスリストからユーザーを追加または削除することができ、Xは一致を実行し、Xでのメディア購入に対して利用可能なセグメントを生成します。リストはX上の@ハンドルと一致し、キャンペーンで直接ターゲットすることができます。これにより、マーケティングが非常に関連性の高いものになります。 ![](https://docs.tealium.com/images/server-side-connectors/twitter-custom-audiences.jpg) ## 考慮事項 * "パートナーユーザーID"を除くすべてのユーザー識別子は、SHA256ハッシュ法を使用してハッシュ化され、[正規化](https://developer.x.com/en/docs/ads/audiences/overview/user-data#data-normalization)される必要があります。 * "ユーザー識別子がすでにハッシュ化されている"チェックボックスがオフの場合、コネクタアクションはマップされた値を正規化してハッシュ化します。 * カスタムオーディエンスを作成すると、XシステムによってカスタムオーディエンスのユーザーがXの@ハンドルに「マッチ」される初期処理期間があります。これにより、プロモーション広告をそのアカウントに配信することが可能になります。 * カスタムオーディエンスのすべてのユーザーがアクティブなXユーザーであるとは限らないため、コネクタアクションの発火量よりも最終的なカスタムオーディエンスのサイズが小さい場合があります。 * すべてのカスタムオーディエンスはAudienceStreamに表示されますが、`Ready`配信ステータスのものだけがキャンペーンでユーザーを適切にターゲットします。これは、**X広告アカウント > オーディエンス**セクション内で確認できます。 * オーディエンスは、過去90日間にXが所有および運営するクライアントでアクティブなユーザーが少なくとも100人に一致する場合にのみターゲットできます。 * 一般的に、オーディエンスの変更は6-8時間ごとに実行されるバッチで処理されます。オーディエンスの変更が処理されている間、更新される既存のオーディエンスは影響を受けません。 * AudienceStreamを通じて作成されたオーディエンスリストは、広告キャンペーンマネージャー内で「リスト」タイプとして追加されます。 * Xのデータを使用してXユーザーについて潜在的にセンシティブな特性を導き出すまたは推測することは推奨されません。これらの特性のリストは、[X APIの制限された使用についての詳細](https://developer.x.com/en/developer-terms/more-on-restricted-use-cases)で見ることができます。 ## 構成の構成 コネクタマーケットプレースにアクセスして新しいコネクタを追加します。コネクタを追加する方法については、[コネクタ概要](https://docs.tealium.com/about-connectors/)記事を参照してください。 コネクタを追加した後、次の構成を構成します： * **広告アカウントID** * 必須です。 * X広告アカウントIDを提供してください。 * アカウントIDは、ログイン時のアカウントのURLで見つけることができます。 * 例：URLが`https://ads.x.com/accounts/1234abcd/`の場合、アカウントIDは`1234abcd`です。 ## カスタムオーディエンスの作成概要 Xカスタムオーディエンスコネクタの**構成**画面にカスタムオーディエンスの作成オーバーレイが表示されます。**名前**フィールドは、オーディエンスリストの作成に必要な唯一の値です。 `list_type`パラメータは以前、オーディエンスのユーザー識別子タイプを識別するために使用されていました（例：メール、XユーザーID、パートナーユーザーIDなど）。しかし、現在のオーディエンスは同じオーディエンスに複数のユーザー識別子を受け入れることができるため、このフィールドはもはや必要ありません。 ## アクション | アクション名 | AudienceStream | EventStream | | --- | :---: | :---: | | カスタムオーディエンスにユーザーを追加 | ✓ | ✓ | | カスタムオーディエンスにユーザーを追加（複数の識別子） | ✓ | ✓ | | カスタムオーディエンスからユーザーを削除 | ✓ | ✓ | | カスタムオーディエンスからユーザーを削除（複数の識別子） | ✓ | ✓ | | リーチ禁止リストにユーザーを追加 | ✓ | ✓ | | リーチ禁止リストからユーザーを削除 | ✓ | ✓ | アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。 次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。 ### アクション - カスタムオーディエンスにユーザーを追加 #### ユーザー識別子 次のパラメータのうち少なくとも1つを提供する必要があります： | **パラメータ** | **タイプ** |**説明** | | --- | --- | --- | | メール | 文字列 | すでに空白トリム、小文字化、SHA256ハッシュ化されたプレーンテキストのメールアドレスを提供してください。ハッシュ化されていないメールアドレスがマップされた場合は、ユーザー識別子ハッシングチェックボックスを選択してください。 | | 電話番号 | 文字列 | すでに空白トリム、小文字化、SHA256ハッシュ化されたプレーンテキストの電話番号を提供してください。ハッシュ化されていない電話番号がマップされた場合は、ユーザー識別子ハッシングチェックボックスを選択してください。 | | デバイスID | 文字列| すでに空白トリム、小文字化、SHA256ハッシュ化されたデバイスIDを提供してください。この値は、[iOS広告識別子](https://developer.apple.com/Library/ios/documentation/AdSupport/Reference/ASIdentifierManager_Ref/ASIdentifierManager.html)、[Google広告ID](https://developer.android.com/google/play-services/id.html)、または利用可能でない場合は[Android ID](https://developer.android.com/google/play-services/id.html)である必要があります。ハッシュ化されていないデバイスIDがマップされた場合は、ユーザー識別子ハッシングチェックボックスを選択してください。| | Xハンドル | 文字列| すでに空白トリム、小文字化、SHA256ハッシュ化されたXハンドルを提供してください。ハッシュ化されていないXハンドルがマップされた場合は、ユーザー識別子ハッシングチェックボックスを選択してください。 | | Twitter ID | 文字列 | すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたX IDを提供してください。X IDは、X上のすべてのアカウントに固有の値です。同じIDを持つ二人の人物はいません。アカウントは@handleを変更することができますが、X IDを変更することはできません。ハッシュ化されていないX IDがマッピングされた場合は、ユーザー識別子ハッシングのチェックボックスを選択してください。| | パートナーユーザーID | 文字列 | パートナーユーザーIDを提供してください。ハッシュ化されていないパートナーユーザーIDがマッピングされた場合は、ユーザー識別子ハッシングのチェックボックスを選択してください。| | ユーザー識別子ハッシング | ブール値 | ユーザー識別子がすでにハッシュ化されている場合は、このチェックボックスを選択してください。そうでない場合は、コネクタがマッピングされた値を[正規化](https://developer.x.com/en/docs/ads/audiences/overview/user-data#data-normalization)してハッシュ化します。| #### パラメータ |**パラメータ**| **説明**| |---| ---| |カスタムオーディエンス| | |有効開始日時| | |有効終了日時| | ### アクション - カスタムオーディエンスにユーザーを追加（複数の識別子） #### ユーザー識別子 次のいずれかのパラメータを少なくとも一つ提供する必要があります： | **パラメータ** | **タイプ** |**説明** | | --- | --- | --- | | メール（SHA256ハッシュを適用） | 文字列 | プレーンテキストのメールアドレスを提供し、コネクタがこの値を空白削除、小文字変換、SHA256ハッシュ化します。 | | メール（すでにSHA256ハッシュ化済み） | 文字列| すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたメールアドレスを提供してください。 | | 電話番号（SHA256ハッシュを適用） | 文字列 | プレーンテキストの電話番号を提供し、コネクタがこの値を空白削除、小文字変換、SHA256ハッシュ化します。 | | 電話番号（すでにSHA256ハッシュ化済み） | 文字列| すでに空白が削除され、小文字に変換され、SHA256でハッシュ化され、E164形式の電話番号を提供してください。 | | デバイスID（SHA256ハッシュを適用） | 文字列| デバイスIDを提供し、コネクタがこの値を空白削除、小文字変換、SHA256ハッシュ化します。 | | デバイスID（すでにSHA256ハッシュ化済み）| 文字列 | すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたデバイスIDを提供してください。 | | Twitterハンドル（SHA256ハッシュを適用）| 文字列 | Xハンドルを提供し、コネクタがこの値を空白削除、小文字変換、SHA256ハッシュ化します。 | | Twitterハンドル（すでにSHA256ハッシュ化済み） | 文字列| すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたXハンドルを提供してください。 | | Twitter ID（SHA256ハッシュを適用） | 文字列| X IDを提供し、コネクタがこの値を空白削除、小文字変換、SHA256ハッシュ化します。 | | Twitter ID（すでにSHA256ハッシュ化済み）| 文字列 | すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたX IDを提供してください。 | | パートナーユーザーID | 文字列| パートナーユーザーIDを提供してください。 | #### パラメータ |**パラメータ**| **説明**| |---| ---| |カスタムオーディエンス| | |有効開始日時| | |有効終了日時| | ### アクション - カスタムオーディエンスからユーザーを削除 #### ユーザー識別子 次のいずれかのパラメータを少なくとも一つ提供する必要があります： | **パラメータ** | **タイプ** |**説明** | | --- | --- | --- | | メール | 文字列 | すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたプレーンテキストのメールアドレスを提供してください。ハッシュ化されていないメールアドレスがマッピングされた場合は、ユーザー識別子ハッシングのチェックボックスを選択してください。 | | 電話番号 | 文字列 | すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたプレーンテキストの電話番号を提供してください。ハッシュ化されていない電話番号がマッピングされた場合は、ユーザー識別子ハッシングのチェックボックスを選択してください。 | | デバイスID | 文字列| すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたデバイスIDを提供してください。この値は[iOS広告識別子](https://developer.apple.com/Library/ios/documentation/AdSupport/Reference/ASIdentifierManager_Ref/ASIdentifierManager.html)、[Google広告ID](https://developer.android.com/google/play-services/id.html)、または利用可能でない場合は[Android ID](https://developer.android.com/google/play-services/id.html)である必要があります。ハッシュ化されていないデバイスIDがマッピングされた場合は、ユーザー識別子ハッシングのチェックボックスを選択してください。| | Twitterハンドル | 文字列| すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたXハンドルを提供してください。ハッシュ化されていないXハンドルがマッピングされた場合は、ユーザー識別子ハッシングのチェックボックスを選択してください。 | | Twitter ID | 文字列 | すでに空白が削除され、小文字に変換され、SHA256でハッシュ化されたX IDを提供してください。X IDは、X上のすべてのアカウントに固有の値です。同じIDを持つ二人の人物はいません。アカウントは@handleを変更することができますが、X IDを変更することはできません。ハッシュ化されていないX IDがマッピングされた場合は、ユーザー識別子ハッシングのチェックボックスを選択してください。 | | パートナーユーザーID | 文字列| パートナーユーザーIDを提供してください。ハッシュ化されていないパートナーユーザーIDがマッピングされた場合は、ユーザー識別子ハッシングのチェックボックスを選択してください。| | ユーザー識別子ハッシング | ブール値 | ユーザー識別子がすでにハッシュ化されている場合は、このチェックボックスを選択してください。そうでない場合は、コネクタがマッピングされた値を[正規化](https://developer.x.com/en/docs/ads/audiences/overview/user-data#data-normalization)してハッシュ化します。 | #### パラメータ |**パラメータ**| **説明**| |---| ---| |カスタムオーディエンス| | |有効開始日時| | |有効終了日時| | ### カスタムオーディエンスからユーザーを削除（複数の識別子） #### ユーザー識別子 次のいずれかのパラメータを少なくとも一つ提供する必要があります： | **パラメータ** | **タイプ** |**説明** | | --- | --- |--- || Email（SHA256ハッシュを適用） | 文字列 | プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。 | | Email（既に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を提供します。 | #### パラメータ |**パラメータ**| **説明**| |---| ---| |カスタムオーディエンス| | |有効開始日時| | |有効終了日時| | #### パラメータ | **パラメータ** | **説明** | | --- | --- | | リーチ禁止リスト | | #### ユーザー識別子 | **パラメータ** | **説明** | | --- | --- | | Email（SHA256ハッシュを適用） | 文字列 | プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。 | | Email（既にSHA256ハッシュ化されている） | 文字列| 既に空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供します。 | ### リーチ禁止リストからユーザーを削除 #### パラメータ | **パラメータ** | **説明** | | --- | --- | | リーチ禁止リスト | | #### ユーザー識別子 | **パラメータ** | **説明** | | --- | --- | | Email（SHA256ハッシュを適用） | 文字列 | プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。 | | Email（既にSHA256ハッシュ化されている） | 文字列| 既に空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供します。