Twitter イベント転送拡張機能

Last update: Mon May 26 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

Twitter は、ユーザーがツイートと呼ばれる 280 文字のメッセージを投稿してやり取りする、オンラインのソーシャルメディアおよびソーシャルネットワーキングサービスです。ユーザーは、ブラウザー、モバイルフロントエンドソフトウェア、またはその API を介してプログラムを使用して、Twitter とやり取りできます

Twitter Web Conversions API イベント転送拡張機能を使用すると、Adobe Experience Platform Edge Networkで取得したデータを活用して、Twitter に送信できます。このドキュメントでは、拡張機能のユースケース、インストール方法および機能をイベント転送ルールに統合する方法について説明します。

Twitter では、Twitter Web Conversions API を使用した認証に OAuth 1.0 が必要です。

ユースケース

この拡張機能は、Edge Networkのデータを使用して、顧客分析およびターゲティング機能を活用 Twitter る場合に使用します。

例えば、組織のマーケティングチームについて考えてみましょう。チームは、Web サイトからユーザーインタラクションイベントデータをイベントデータとして取得し、このイベント転送拡張機能を使用して Twitter に読み込みます。

その後、マーケティングチームと分析チームは、Twitter’s の機能を活用して追加の分析を実行し、ターゲットとなる広告キャンペーンに対してこれらのユーザーをターゲットに設定できます。

Twitter 固有のユースケースについて詳しくは、Twitter ユースケースドキュメントを参照してください。

Twitter の前提条件とガードレール prerequisites

この拡張機能を使用するには、有効な Twitter アカウントが必要です。アカウントをまだお持ちでない場合は、Twitter 登録ページに移動し、アカウントを登録して作成してください。

Twitter 開発者アカウントとしてアカウントを設定する必要があります。開発者として新規登録する方法については、Twitter 開発者アカウントを参照してください。

API ガードレール guardrails

Twitter Web Conversions API には、15 分間隔あたり 60,000 リクエストのレート制限があります。各リクエストでは 500 イベントが許可されています。

必要な設定の詳細の収集 configuration-details

Experience Platformを Twitter に接続するには、次の入力が必要です。

キータイプ

説明

消費者キー

Twitter API にアクセスするためのアプリの API キーをします。詳しくは、api キーと秘密鍵に関する Twitter ドキュメントを参照してください。

消費者秘密鍵

API シークレットは、アプリに Twitter API へのアクセスを許可します。詳しくは、api キーと秘密鍵に関する Twitter ドキュメントを参照してください。

トークンシークレット

OAuth 経由で Twitter API への認証に使用される、アプリの有効期限が切れていないトークンシークレット。詳しくは、使用アクセストークンの取得に関する Twitter のドキュメントを参照してください。

アクセストークン

OAuth 経由で Twitter API への認証に使用される、アプリの有効期限が切れていないアクセストークン。詳しくは、使用アクセストークンの取得に関する Twitter のドキュメントを参照してください。

ピクセル Id

Twitter Pixel は、サイトのアクションやコンバージョンを追跡するために web サイトに実装される web サイトタグです。詳しくは、Web サイトのコンバージョントラッキングに関する Twitter ドキュメントを参照してください。

Twitter 拡張機能のインストールと設定 install

拡張機能をインストールするには、イベント転送プロパティを作成するか、代わりに編集する既存のプロパティを選択します。

左側のナビゲーションの「拡張機能」をクリックします。「カタログ」タブで、Twitter 拡張機能のカードの インストール を選択します。

インストールを強調表示した Twitter 拡張機能を示すカタログ

IMPORTANT

実装のニーズに応じて、拡張機能を設定する前に、スキーマ、データ要素、データセットの作成が必要になる場合があります。ユースケースに合わせて設定する必要のあるエンティティを判断するには、開始する前にすべての設定手順を確認してください。

次の画面で、以前に Twitter から収集した次の設定値を入力します。

ピクセル Id
コンシューマーキー
消費者の秘密鍵
トークン
トークンシークレット

完了したら「保存」を選択します。

Twitter 拡張 Twitter 能の設定画面

イベント転送ルールの設定 config-rule

すべてのデータ要素を設定したら、イベントを Twitter に送信するタイミングと方法を決定するイベント転送ルールの作成を開始できます。

イベント転送プロパティに新しいルールを作成します。 アクション の下に新しいアクションを追加し、拡張機能を Twitter に設定します。 Edge Network イベントを Twitter に送信するには、アクションタイプ を Web コンバージョンを送信 . に設定します。

選択後、追加のコントロールが表示され、イベントをさらに設定できます。 Twitter のイベントプロパティを、以前に作成したデータ要素にマッピングする必要があります。詳しくは、Twitter Web Conversions API を参照してください。

コンバージョンイベントルールを作成する Twitter。

ユーザーの識別

フィールド名

説明

例

必須

Twitter クリック ID

Twitter クリックスルー URL から解析されたクリック ID」をクリックします。

26l6412g5p4iyj65a2oic2ayg2

他の識別子が追加されていない場合は必須です。

メール

SHA256 でハッシュ化されたメールアドレス。テキストは小文字にし、末尾または先頭のスペースはハッシュ前に削除する必要があります。

eventforwarding@example.com

他の識別子が追加されていない場合は必須です。

電話

電話は、コンバージョンイベントに一致する識別子として機能します。電話番号は、ハッシュする前に E164 形式 [+][ 国コード ][ 市外局番 ][local phone number] である必要があります。

+911234567875

他の識別子が追加されていない場合は必須です。

コンバージョンデータ

フィールド名

説明

例

必須

コンバージョン時間

ISO 8601 形式または yyyy-MM-dd'T'HH:mm:ss:SSSZ 形式の文字列としての日時。

2022-02-18T01:14:00.603Z

○

イベント Id

特定のイベントの基本 36 ID。この ID は、Twitter 広告アカウント内に含まれる事前設定済みのイベントと一致する必要があります。これを、イベントマネージャーの対応するイベントの ID と呼びます。

o87ne または tw-o8z6j-o87ne （tw-pixel_id-event-id）

○

項目数

イベントで購入されるアイテムの数。これは 0 より大きい正の数にする必要があります。

通貨

イベントで購入される品目の通貨。これは ISO-4217 で表され、指定しない場合、デフォルトは USD になります。

USD

値

イベントで購入される品目の価格値。

100.00

コンバージョン ID

同じイベントタグ内の web ピクセルとコンバージョン API 変換の間の重複排除に使用できるコンバージョンイベントの識別子。

23294827

説明

コンバージョンに関する追加情報を含む説明。

コンバージョンをテスト

Twitter 内のデータの検証

イベント転送ルールを作成して実行したら、Twitter API に送信されたイベントが Twitter UI で期待どおりに表示されるかどうかを検証します。

イベントの収集と Experience Platform の統合が成功すると、Twitter のイベントマネージャー内にイベントが表示されます。

Twitter イベントマネージャー

次の手順

このガイドでは、イベント転送を使用してコンバージョンイベントを Twitter に送信する方法について説明しました。これらの基盤となるテクノロジーについて詳しくは、次の公式ドキュメントを参照してください。

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743