# Twitter Custom Audience Export Integration ジョブの結果をTwitter Custom Audienceに直接書き込むことができます。 Twitter Custom Audiencesを使用すると、オフプラットフォームの顧客情報を活用して、ターゲティング、除外、類似オーディエンスの拡張に使用できる独自のオーディエンスセグメントを作成できます。 ## 前提条件 - [TD Toolbelt](https://toolbelt.treasuredata.com/)を含むTreasure Dataの基本知識 - Twitter Ads AccountまたはAds Managerロールを持つアカウント - Twitter Ads AccountへのTreasure Data Twitterアプリアクセスの認証 ## Treasure コンソールを使用する ### 新しい接続を作成する 1. Treasure コンソールから、**Integrations Hub**のカタログに移動します。Twitter Custom Audienceを検索して選択します。 ![](/assets/image2022-12-12_10-28-14.75b52d9e13cef07947e68a3be40665468ac2fa1f3e33b9ba41f9bb53897d0a5c.eebad121.png) 1. **Create Authentication**を選択します。次のダイアログが開きます。 ![](/assets/image2022-12-12_10-29-2.02d0ff12d9360b525619f2fee2329db45fda191de57ffec3a04d188c820350f7.eebad121.png) 1. Twitterの既存のOAuth接続を選択するか、**OAuth connection**の下にあるリンクを選択して新しい接続を作成します。 ![](/assets/image2022-12-12_10-35-16.af385086dc137167113b3f1a30256807e3a7262b0bff4f96cc829cc8e7fcc4de.eebad121.png) ### 新しいOAuth接続を作成する 1. ブラウザでTwitterアカウントにログインし（以前にログインしていない場合）、アクセスを許可します。 ![](/assets/image-20191008-231558.efe002ab8e3513b1add22cc71de9ac77da4cadd0ccd249ee76f7ac89ca2bcabe.eebad121.png) または、すでにログインしている場合は、**Treasure Data**アプリへのアクセスを許可します。 ![](/assets/image-20191008-231649.923e6d129ae4b0cc428c0db88afe4ce33f9bebf09f37f3ca5e1e3173a50abd28.eebad121.png) 1. [Treasure Data Connections](https://console.treasuredata.com/app/connections/data-sources)にリダイレクトされた後、最初の手順（新しい接続の作成）を繰り返し、新しいOAuth接続を選択します。 ![](/assets/image2022-12-12_10-47-38.42db17d365d15eb595a16e8ec53fa3eca61b7dbe41938842a946d06629ddf375.eebad121.png) 1. 新しく作成した接続に名前を付けて、後で使用できるように保存します。 ![](/assets/image2022-12-12_10-48-14.e0282e186881dbb3be68cc96c2433e98cc2501a1c46b83d68467cda18b4b7917.eebad121.png) 1. 出力結果の設定 出力結果は、Twitter Custom Listのデータ仕様（[こちら](https://developer.twitter.com/en/docs/ads/audiences/overview/crm)）に従う必要があります。単一列、単一タイプをサポートしています。 - **TWITTER_ID**: TwitterユーザーID - **DEVICE_ID**: TwitterユーザーのIDFA、AdID、またはAndroid ID - **EMAIL**: メールアドレス - **TWITTER_HANDLE**: Twitterユーザー名（スクリーンネーム） 1. クエリエディタの上部にある出力結果を確認し、次のようにTwitter Custom Audience接続を選択します。 ![](/assets/result-into-twitter-tailored-audience.c87d05c15358bb660b4d2763bd8b520457008e6f47c80022c82a17578a10167f.eebad121.gif) 1. 次のパラメータを編集します。 - **Twitter Ad Account ID**（必須、APIパラメータ: ad_account_id）: Twitter Ad Account IDです。アカウントIDの取得方法については付録Cを参照してください。 - **Custom Audience Name**（必須、APIパラメータ: audience_name）: 作成するCustom Audienceリストの名前。 - **重要な注意事項**: この入力と類似した名前のTailored Audienceリストが多数ある場合、最新のCustom Audience Nameが使用されます。Custom Audienceリストには一意の名前を付けることをお勧めします。 - **重要な注意事項**: 削除されたオーディエンスに関連付けられているオーディエンス名は使用できません。新しいオーディエンスを作成する際に、削除されたオーディエンスに関連付けられている名前を再利用しようとすると、エラーメッセージが表示されます。 - **Audience type**（必須、APIパラメータ: audience_type）: リスト内のエントリのタイプ。email、id、device id、またはhandleのいずれかです。 - **No need to normalize and hash records**（デフォルトfalse、APIパラメータ: pre_hashed）: データがすでに正規化およびハッシュ化されているかどうかを示します。そうでない場合、TDは自動的にレコードを正規化およびハッシュ化します。 - **Expires at**（APIパラメータ: expires_at）:**"yyyy-MM-ddTHH:mm:ssZ"（例: 2025-10-28T10:30:00Z）のUTC時刻形式で、Custom Audienceの関連付けが期限切れになる時刻。空の場合、デフォルト値はリクエストタイムスタンプから13か月後になります。 - **Skip on invalid records**（デフォルトfalse）: 無効なレコードを無視するかどうかを示します。 - **Mode**（デフォルトUpdate、APIパラメータ: mode）: 実行される操作タイプ - **Update**: 宛先Audienceに新しいユーザーを追加 - **Delete**: この機能によってエクスポートされた識別子を持つユーザーを宛先Audienceから削除 - **Retry limit**（オプション、デフォルト6）: 諦める前の再試行回数。 - **Initial intervals in milliseconds between retries**（オプション、デフォルト10000）: 回復可能なエラーが発生した場合に再試行する間隔（ミリ秒単位）。 - **Maximum intervals in milliseconds between retries**（オプション、デフォルト32000）: 再試行の間の最大時間（ミリ秒単位）。 **サンプル設定** ![](/assets/image2022-12-12_10-50-53.5505e14ca0b81ed0e1cc31b49cc0dee08b5cc5232fbffb1c61adde2b1a1aeef8.eebad121.png) ### Custom Audienceリストを作成するクエリを書く 1. Treasure Dataは新しいCustom Audienceリストの作成をサポートしています。Treasure コンソールで、Twitter Custom Audienceの接続に出力結果を指定して次のクエリを実行します（列名の詳細については付録Aを参照してください）。 ```sql SELECT email FROM ( VALUES ('demo1@example.com'), ('demo2@example.com'), ('demo3@example.com') ) tbl (email) ``` 上記のクエリは、デモ目的のみであるため、実際のユーザーとは一致しません。さらに、ソーステーブルは必要ありません（この機能をテストするため）が、データベースを選択する必要があるため、"sample_datasets"または他の任意のテーブルを選択してください。クエリは数秒で完了します。 1. Twitter Audience Managerで新しいリストを確認します。 Twitterは新しく作成されたリストを検証するのに最大24時間かかります。そのため、リストは「Processing」のステータスを示します。 ![](/assets/image-20191009-213604.a2f1d294ebd6968c70320b113d7bd676d4f5b760da566e5fcbe7f8082c096d96.eebad121.png) 次の6〜8時間以内にステータスが「Ready」（またはリストが有効でない場合はエラー）に変わることがわかります。 ![](/assets/image-20191009-213641.ed614f5eb86b85d1df43faf688ea071b36ac49c51cf9ffe0f4de3ce61facb48b.eebad121.png) ### (オプション) Query Export ジョブをスケジュールする Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。 Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。 2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。 例えば、cron スケジュールが `'0 0 1 * 1'` の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。 #### Treasure コンソール を使用してジョブをスケジュールする 1. **Data Workbench > Queries** に移動します 2. 新しいクエリを作成するか、既存のクエリを選択します。 3. **Schedule** の横にある None を選択します。 ![](/assets/image2021-1-15_17-28-51.f1b242f6ecc7666a0097fdf37edd1682786ec11ef80eff68c66f091bc405c371.0f87d8d4.png) 4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します: ![](/assets/image2021-1-15_17-29-47.45289a1c99256f125f4d887e501e204ed61f02223fde0927af5f425a89ace0c0.0f87d8d4.png) | ドロップダウン値 | 説明 | | --- | --- | | Custom cron... | [Custom cron... の詳細](#custom-cron-details)を参照してください。 | | @daily (midnight) | 指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。 | | @hourly (:00) | 毎時 00 分に実行します。 | | None | スケジュールなし。 | #### Custom cron... の詳細 ![](/assets/image2021-1-15_17-30-23.0f94a8aa5f75ea03e3fec0c25b0640cd59ee48d1804a83701e5f2372deae466c.0f87d8d4.png) | **Cron 値** | **説明** | | --- | --- | | `0 * * * *` | 1 時間に 1 回実行します。 | | `0 0 * * *` | 1 日 1 回午前 0 時に実行します。 | | `0 0 1 * *` | 毎月 1 日の午前 0 時に 1 回実行します。 | | "" | スケジュールされた実行時刻のないジョブを作成します。 | ``` * * * * * - - - - - | | | | | | | | | +----- day of week (0 - 6) (Sunday=0) | | | +---------- month (1 - 12) | | +--------------- day of month (1 - 31) | +-------------------- hour (0 - 23) +------------------------- min (0 - 59) ``` 次の名前付きエントリを使用できます: - Day of Week: sun, mon, tue, wed, thu, fri, sat. - Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec. 各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます: div | フィールド値 | 例 | 例の説明 | | --- | --- | --- | | 各フィールドに対して上記で表示された制限内の単一の値。 | | | | フィールドに基づく制限がないことを示すワイルドカード `'*'`。 | `'0 0 1 * *'` | 毎月 1 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 | | 範囲 `'2-5'` フィールドの許可される値の範囲を示します。 | `'0 0 1-10 * *'` | 毎月 1 日から 10 日までの午前 0 時 (00:00) に実行するようにスケジュールを設定します。 | | カンマ区切りの値のリスト `'2,3,4,5'` フィールドの許可される値のリストを示します。 | `0 0 1,11,21 * *'` | 毎月 1 日、11 日、21 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 | | 周期性インジケータ `'*/5'` フィールドの有効な値の範囲に基づいて、 スケジュールが実行を許可される頻度を表現します。 | `'30 */2 1 * *'` | 毎月 1 日、00:30 から 2 時間ごとに実行するようにスケジュールを設定します。 `'0 0 */5 * *'` は、毎月 5 日から 5 日ごとに午前 0 時 (00:00) に実行するようにスケジュールを設定します。 | | `'*'` ワイルドカードを除く上記の いずれかのカンマ区切りリストもサポートされています `'2,*/5,8-10'` | `'0 0 5,*/10,25 * *'` | 毎月 5 日、10 日、20 日、25 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 | 1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。 ### クエリを実行する クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。 設定エラーにより継続的に失敗するスケジュールジョブは、複数回通知された後、システム側で無効化される場合があります。 (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。 ## Audience Studio で Segment をアクティベートする Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。 1. **Audience Studio** に移動します。 2. parent segment を選択します。 3. ターゲット segment を開き、右クリックして、**Create Activation** を選択します。 4. **Details** パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。 5. **Output Mapping** パネルで activation 出力をカスタマイズします。 ![](/assets/ouput.b2c7f1d909c4f98ed10f5300df858a4b19f71a3b0834df952f5fb24018a5ea78.8ebdf569.png) - Attribute Columns - **Export All Columns** を選択すると、変更を加えずにすべての列をエクスポートできます。 - **+ Add Columns** を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。**+ Add Columns** を選択し続けて、activation 出力用の新しい列を追加します。 - String Builder - **+ Add string** を選択して、エクスポート用の文字列を作成します。次の値から選択します: - String: 任意の値を選択します。テキストを使用してカスタム値を作成します。 - Timestamp: エクスポートの日時。 - Segment Id: segment ID 番号。 - Segment Name: segment 名。 - Audience Id: parent segment 番号。 1. **Schedule** を設定します。 ![](/assets/snippet-output-connector-on-audience-studio-2024-08-28.a99525173709da1eb537f839019fa7876ffae95045154c8f2941b030022f792c.8ebdf569.png) - スケジュールを定義する値を選択し、オプションでメール通知を含めます。 1. **Create** を選択します。 batch journey の activation を作成する必要がある場合は、[Creating a Batch Journey Activation](/products/customer-data-platform/journey-orchestration/batch/creating-a-batch-journey-activation) を参照してください。 ## 付録 ### Custom Audienceデータ 出力結果は、Twitter Custom Listのデータ仕様（[こちら](https://developer.twitter.com/en/docs/ads/audiences/overview/crm)）に従う必要があります。単一列、単一タイプをサポートしています。 - **TWITTER_ID**: TwitterユーザーID - **DEVICE_ID**: TwitterユーザーのIDFA、AdID、またはAndroid ID - **EMAIL**: メールアドレス - **TWITTER_HANDLE**: Twitterユーザー名（スクリーンネーム） ### データの正規化とハッシュ化 結果出力は、Twitterの正規化ルールに従って値を自動的に正規化できます。[こちら](https://developer.twitter.com/en/docs/ads/audiences/overview/crm)を参照してください。 Twitterにマッチングのためにアップロードされるすべての値は、Twitterの正規化ルールで正規化する必要があります。値が正規化されていない場合、マッチングの機会を逃す可能性があります。自分で値を正規化する必要がある場合は、出力を送信する前に独自の正規化を適用してください。 正規化のために、結果出力では実際にタイプごとに以下の変換が適用されます。 - **Email Addresses**: 小文字化、先頭と末尾のスペースを削除; 例: support@twitter.com - **Twitter User Name**: @なし、小文字化、先頭と末尾のスペースをトリミング; 例: jack - **Twitter User IDs**: 標準整数; 例: 143567 - **Device IDs**: ダッシュ付き小文字（IDFA）、デバイス上の元の形式でダッシュ付きで大文字にしない（AdID）、デバイス上の元の形式でダッシュやスペースなしで大文字にしない（Android ID）; 例: 4b61639e-47cc-4056-a16a-c8217e02946 および af3802a465767e36 正規化後、データは**ソルトなし**でSHA256を使用してハッシュ化する必要があります。さらに、最終的な出力ハッシュは小文字である必要があります。 例えば、49e0be2aeccfb51a8dee4c945c8a70a9ac500cf6f5cb08112575f74db9b1470d であり、49E0BE2AECCFB51A8DEE4C945C8A70A9AC500CF6F5CB08112575F74DB9B1470D **ではありません** ### Twitter Ads Accountの情報 Custom Audience Listを作成するには、Ads Accountへのアクセスが前提条件です。アカウントIDは、Account Settings Pageから取得できます