Twitterカスタムオーディエンスコネクタの構成ガイド | サーバーサイドコネクタ

API情報

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

API名：Twitter Ads API
APIバージョン：v11
APIエンドポイント：https://ads-api.twitter.com/
ドキュメント：TwitterカスタムオーディエンスAPI

バッチ制限

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

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

前提条件

開発者アカウントにサインアップしてください。EssentialとElevateddeveloperの両方のアクセスレベルでAds APIにアクセスできます。必要なアクセスレベルについては、アクセスレベルを参照してください。
開発者アプリを作成し、トークンを保護してください。
Ads APIへのアクセスをリクエストしてください。アプリケーションに正しいApp IDを含めるようにしてください。App IDは開発者ポータルのProjects & Appsで見つけることができます。例：16489123

Twitter Developer Platformで既に開発中で、開発者アカウントを持っている場合は、ステップ3に進んでください。

動作原理

Twitterカスタムオーディエンスを使用すると、Twitter広告を表示するユーザーを制御できます。Twitter広告は、リアルタイムで顧客に最も関連性のあるメッセージを提供するための強力なコンテキストを提供します。リアルタイムのツイートに参加することで、ビジネスの構築に役立つ会話を影響することができます。

Audiencesは、Twitter Adsアカウントのツール＆gt;オーディエンスに移動してアクセスできる、オーディエンスを確認および管理するためのツールです。

そこから、カスタムオーディエンスをキャンペーンのターゲティングに使用して、直接関心のあるユーザーにリーチすることができます。Tealiumでは、AudienceStream内のユーザーインターフェースを介してTwitterカスタムオーディエンスを作成し、オーディエンスデータを使用してオーディエンスリストを作成できます。また、AudienceStreamで作成されたオーディエンスリストをTwitter Adsアカウントで作成し、ユーザーを追加または削除してAudienceStreamにポピュレートすることもできます。リターゲティングの対象となるオーディエンスの例としては、以前の顧客、まだ変換していないウェブ訪問、および/または高価値な顧客などがあります。

Tealiumは、Twitterに送信するためのハッシュ化された識別子のリストを提供し、Twitterは一致を行い、Twitterでのメディア購入に対して利用可能なセグメントを生成します。リストはTwitter上の@ハンドルと一致させられるため、キャンペーンで直接ターゲットすることができ、マーケティングが非常に関連性の高いものになります。

考慮事項

「パートナーユーザーID」以外のすべてのユーザー識別子は、SHA256ハッシュ化メソッドと正規化を使用してハッシュ化する必要があります。
「ユーザー識別子は既にハッシュ化されています」のチェックボックスがオフになっている場合、コネクタアクションはマッピングされた値を正規化およびハッシュ化します。
カスタムオーディエンスを作成すると、Twitterシステムによってカスタムオーディエンスのユーザーが「マッチング」される初期処理期間があります。これにより、Promoted Adsをアカウントに対して表示できるようになります。
- カスタムオーディエンスのすべてのユーザーがアクティブなTwitterユーザーではない可能性があるため、コネクタアクションの発生量よりも小さい最終的なカスタムオーディエンスのサイズが表示される場合があります。
- すべてのカスタムオーディエンスはAudienceStreamに表示されますが、Twitter Adsアカウント＆gt;オーディエンスセクションで「Ready」のサービングステータスにあるもののみがキャンペーンのユーザーに適切にターゲットされます。
過去90日間にTwitter所有および運営のクライアントでアクティブなユーザーが少なくとも100人いる場合にのみ、オーディエンスをターゲットできます。
一般的に、オーディエンスの変更は6〜8時間ごとにバッチで処理されます。オーディエンスの変更が処理されている間、更新される既存のオーディエンスには影響がありません。
AudienceStreamを介して作成されたオーディエンスリストは、広告キャンペーンマネージャー内の「リスト」タイプとして追加されます。
Twitterのデータを使用してTwitterユーザーに関して潜在的に敏感な特性を派生させたり推測したりしないことをお勧めします。これらの特性のリストは、Twitter APIの制限された使用事例についての詳細で確認できます。

コネクタアクション

アクション名	AudienceStream	EventStream
カスタムオーディエンスにユーザーを追加する	✓	✓
カスタムオーディエンスからユーザーを削除する	✓	✓

構成の構成

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

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

広告アカウントID
- 必須です。
- Twitter広告アカウントIDを指定してください。
- アカウントIDは、ログイン時のアカウントのURLに表示されます。
- 例：URLがhttps://ads.twitter.com/accounts/1234abcd/の場合、アカウントIDは1234abcdです。

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

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

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

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

次へをクリックするか、アクションタブに移動します。ここでは、コネクタアクションのパラメータとオプションを構成します。

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

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

パラメータ

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

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

パラメータ

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