旧画面のサポート記事

補足

この記事は、リニューアル後のKARTE Signalsコネクタに関する内容です。 現在ご利用のUIが旧バージョンの場合は、上記のリニューアル前のサポート記事をご確認ください。

できること

KARTE Signals から X Ads API（Custom Audiences）を利用し、KARTEのセグメントやイベントデータから作成したターゲティングリストを X広告のカスタムオーディエンス へ連携できます。本ドキュメントでは、その設定と送信仕様を説明します。

事前準備

  1. KARTE計測タグの設置

  2. 個人情報を広告媒体に送信する際の事前設定

  3. X広告のアカウントIDの取得

  4. データライブラリでデータの作成

広告APIの設定

  1. その他の機能 > 広告API > 作成 から、Twitter Ads Custom Audience API を選択します。

  2. 名前 を入力します。必須です。説明は任意です。

  3. 事前準備で用意したアカウントIDを入力し、認証トークンの取得 を押します。

  4. 保存 を押します。

コネクタの設定

1.目的の選択

目的で ターゲティング を選びます。
テンプレート一覧から、X Ads API にオーディエンスリストを送る(v1) を選択してください。

2.接続先

広告APIで作成した接続先を選択してください。

  • カスタムオーディエンスを新規に作成する場合は、カスタムオーディエンスIDを作成する にチェックを入れてください。

  • オペレーション

    • 追加 or 上書き…抽出したユーザーを既存オーディエンスへ追加します。

    • 削除…抽出したユーザーを既存オーディエンスから削除します。

補足

X Ads API には「オーディエンス内容を完全置換」の専用操作はありません。 全件置換を行いたい場合、（A）既存メンバーを把握して削除してから更新するか、 （B）新しいオーディエンスを作成して差し替える（IDが変わるため紐付け先に注意）といった運用になります。

  • ユーザーデータハッシュ済み：KARTEに既にハッシュ化された個人情報データを連携している場合に利用します。ハッシュ化のルールが媒体側の規定に沿っているか確認してください。

新規にオーディエンスを作成する場合

広告アカウントID、オーディエンス名称を入力してください。説明、有効日、有効期限は必要に応じて入力してください。

補足

「オーディエンスリストを作成する」にチェックが入っている場合、定期実行の設定はできません。 定期実行の設定を行うには、チェックを入れた状態でコネクタを一度送信し、リストが作成されたことを確認した後、 チェックを外し、オーディエンスIDを入力してから定期実行を設定してください。

既存のオーディエンスリストを更新する場合

更新したいオーディエンスリストのIDを取得し、カスタムオーディエンスIDに設定します。

  1. X広告の Audiences 画面から対象のオーディエンスリストを選び、Edit をクリックします。

  2. ブラウザのアドレスバーに表示される URL に、オーディエンスID が含まれています。

例：https://ads.x.com/audiences/xxxxxxxx/audience/<オーディエンスID>/edit

3.利用するデータ

オーディエンスリスト と 個人情報データ は、どちらも必須です。データライブラリで作成したものを選択します。未作成の場合は、項目の横にある 作成 から作成できます。
X広告への連携で使う個人情報の項目は次のとおりです。その他の項目はX広告への連携には使用しないため、設定不要です。

フィールド名必須推奨説明
user_id○ユーザーID。KARTEのuser_idを選択してください
email○メールアドレス
phone○電話番号
idfa○IDFA
aaid○AAID

リスト作成の例はレシピを参照してください。

4.データ確認

送信スケジュールの前に データ確認 があります。コネクタを保存するまでは、「コネクタを保存するとデータを確認できます」と表示されます。

5.送信スケジュール

定期的に連携する場合は、定期送信 にチェックを入れて、実行間隔を設定してください。外部データを使う場合は、その連携頻度や連携時間に合わせてください。
ユーザーマスタを利用する場合は、送信スケジュールを「50分」に指定してください。

6.基本情報

タイトルには、テンプレートIDと時刻が入った値が初期値として入っています。変更する場合は編集してください。説明欄もあります。

7.送信

右上に 無効状態で保存 と 有効状態で保存 が並んでいます。

  • 有効状態で保存 を押すと、「コネクタを送信」の確認が出ます。確認すると送信まで進みます。

  • 無効状態で保存 を押すと送信されず、状態は「無効」になります。「下書き」という表示はありません。

送信確認

ads.x.com の Audiences 画面で、対象オーディエンスのステータスとサイズを確認します。反映には時間がかかる場合があります。