X変換コネクタ構成ガイド

API情報

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

• API名：X変換API
• APIバージョン：v12
• APIエンドポイント：https://ads-api.x.com/
• レート制限：アカウントあたり15分間に60,000イベント
• ドキュメンテーション：X：Web変換API

前提条件

• X Ads APIへのアクセス
• X Developerアカウント
• 希望する広告アカウントにイベントを送信する権限を持つXユーザーアカウント

既に活動的に使用しているX Ads APIアプリケーションがある場合、そのアプリケーションと既存のアクセストークンは変換APIに使用できます。詳細については、X：変換API構成を参照してください。

仕組み

X変換APIを使用して、変換イベントをXに渡す別のサーバーサイドアプリケーションを作成します。このAPIを使用すると、Xのウェブサイトピクセルが必要なく、変換イベントを送信することでXの広告の実行の影響を測定できます。

現在、マッチング識別子を使用して広告の影響を測定する主なユースケースは2つあります：

• XクリックIDを使用したウェブサイトトラフィックキャンペーンのクリックスルー変換
• メールを使用したすべてのXキャンペーンのビュースルーとクリックスルー変換

広告キャンペーンに応じて、以下のウェブサイトアクションの1つ以上を変換トラッキングで測定できます：

• サイト訪問：ユーザーが広告主のサイトのランディングページを訪れる
• 購入：ユーザーが広告主のサイトで製品やサービスの購入を完了する
• ダウンロード：ユーザーが広告主のサイトからファイル（ホワイトペーパーやソフトウェアパッケージなど）をダウンロードする
• サインアップ：ユーザーが広告主のサービス、ニュースレター、またはメールコミュニケーションにサインアップする
• カスタム：これは、上記のカテゴリに該当しないカスタムアクションのためのキャッチオールカテゴリです

X変換APIの使用

X変換APIを使用するには、X Ads Managerで新しい変換イベントを作成するか、既に作成され使用されているX Pixelのイベントを使用する必要があります。X PixelとX変換APIリクエスト間の変換の重複を排除するために、Pixel用に作成した既存のイベントを使用します。

Ads Managerで既存の変換イベントの使用

X Pixelで使用されている既存のイベントを使用するには、そのイベントのイベントIDを使用します。同じイベントに対してX PixelとX変換APIの両方を使用する場合、X PixelのコードスニペットとX変換APIリクエストの両方で重複キーを使用することを確認してください（conversion_idとして）。重複についての詳細は、Xのドキュメンテーションの変換API構成のテストイベントと重複セクションを参照してください。

変換イベントの識別子

変換イベントがX変換APIに渡されるためには、少なくとも1つのXクリックID（twclid）またはイベント識別子として構成されたメールアドレスが必要です。

変換イベントをX変換APIに正常に構成するために、以下の構成を推奨します：

• URLクエリパラメータにtwclid値が存在する場合は常に解析し、Tealium EventStream API Hubに渡します。
• データを関連するフォームフィールドや変換イベント情報と一緒に保存します。

重複排除

ページビューイベント、X定義のサイト訪問およびランディングページビューイベントを含む、Xは重複排除のための30分間のウィンドウを提供します。購入やリードなどの他のイベントタイプは重複排除されません。

conversion_idイベントパラメータを使用してイベントの重複を管理します。これはPixelまたはX変換APIリクエストに含めることができます。

構成の構成

X変換は、あなたのXアカウントでの許可リストが必要です。許可リストの支援については、Xの担当者に連絡してください。

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについてを参照してください。

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

• イベントID
  特定のイベントのbase36 IDです。これは、この広告アカウント内に含まれる事前に構成されたイベントに一致します。これは、Events Managerの対応するイベントでIDと呼ばれます。 この値は以下の方法で作成できます：

  • Single-Event Websiteタグ構成内で。あなたの広告アカウントにログインし、https://ads.x.com/でツールの下にあるEvents Managerを選択します。
  • APIを使用します。詳細については、X：Webイベントタグを参照してください。
  • あなたのXアカウントマネージャーに連絡します。

• Pixel ID
  広告アカウントのUniversal Website Tag（UWT）IDです。これは、広告アカウントのUWT IDのbase36エンコード値を表します。
  Pixel IDを取得するには：

  1. あなたの広告アカウントにログインし、https://ads.x.com/にアクセスします。
  2. インターフェースの左上隅にあるツールの下で、Events Managerをクリックします。
  3. 左側のサイドバーにまだX Pixelイベントソースがない場合、ページの右上隅でイベントソースを追加を選択します。
  4. インターフェースは、APIで使用されるこのイベントのPixel IDとEvent IDを表示します。

コネクタアクション

アクション名	AudienceStream	EventStream
変換イベントの送信	✓	✓

続けるをクリックして、コネクタアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

変換イベントの送信

バッチ制限

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

• リクエストの最大数：500
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：1MB

ユーザーデータ

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

パラメータ	タイプ	説明
XクリックID	文字列	クリックスルーURLから解析されたXクリックID。XクリックIDまたはメールのいずれかを指定する必要があります。マッチ率を上げるために両方を使用します。
メールアドレス（既にSHA256ハッシュ化済み）	文字列	すでに空白をトリムし、小文字にし、SHA256でハッシュ化されたメールアドレスを提供します。
メールアドレス（SHA256ハッシュを適用）	文字列	プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白をトリムし、小文字にし、SHA256ハッシュを使用してハッシュ化します。
電話番号（既にSHA256ハッシュ化済み）	文字列	すでに空白をトリムし、小文字にし、SHA256でハッシュ化し、E164形式にした電話番号を提供します。
電話番号（SHA256ハッシュを適用）	文字列	プレーンテキストの電話番号を提供し、コネクタはこの値を空白をトリムし、小文字にし、SHA256ハッシュを使用してハッシュ化します。
ip_address	文字列	この値はドットで区切られた10進表記で書かれ、4つの数字がピリオドで区切られています。
user_agent	文字列	この識別子により、サーバーはリクエストするユーザーエージェントのアプリケーション、オペレーティングシステム、ベンダー、および/またはバージョンを識別できます。

追加パラメータ

パラメータ	説明
イベントIDオーバーライド	これはAds ManagerとAds APIでWebsite Tag IDと呼ばれ、X AdsプラットフォームのEvents Managerで見つけることができます。このパラメータは必須フィールドであり、この構成は構成セクションで使用されるEvent Source IDを上書きします。
Pixel ID Override	広告アカウントのUniversal Website Tag（UWT）ID。このパラメータは、広告アカウントのUWT IDのbase36エンコード値を表します。例：o5h34。この構成は、構成セクションで使用されるPixel IDを上書きします。
Conversion Time	必須。コンバージョンイベントの時間。イベントの日時をISO 8601形式で指定します。提供されていない場合、値はイベントの時間です。例：2020-11-01T08:00:00.000Z。
Conversion Value	price_currency通貨で表される購入されるアイテムの価格値。
Number of Items	購入されるアイテムの数。ゼロより大きい正の数でなければなりません。Number of Itemsが提供されていない場合、Contents配列の要素の総数が使用されます。
Currency	結果をフィルタリングする通貨の種類、ISO 4217形式で識別されます。これはUSDのような3文字の文字列です。
Conversion ID	ピクセルとコンバージョンAPIのコンバージョン間の重複排除用。同じイベントタグ内のWeb PixelとConversion APIのコンバージョン間で重複排除に使用できるコンバージョンイベントの識別子。詳細については、X: Conversion API Set Upを参照してください。
Description	コンバージョンに関する追加情報を含む説明。
Search String	広告主のウェブサイトで検索されたテキスト。

Contents Attributes

オプションのパラメータ：

パラメータ	説明
Content ID	コンテンツを表すSKUまたはGTIN（Global Trade Item Number）識別子。
Content Group ID	製品バリアントのグループに関連付けられたID。
Content Name	製品またはサービスの名前。
Content Price	製品またはサービスの価格。
Content Type	購入された製品のカテゴリ。
Number of Items	購入された製品の数。