この記事は、リニューアル後のKARTE Signalsコネクタに関する内容です。 現在ご利用のUIが旧バージョンの場合は、リニューアル前のサポート記事をご確認ください。 旧画面のサポート記事：https://support.karte.io/post/6aeae94598fcc7700f6d1cb8
できること
KARTE Signalsでは、コンバージョンAPIを利用してLINEヤフー広告 ディスプレイ広告のコンバージョン補完を実施することができます。ここではその連携方法について説明します。
2025年6月30日より提供を開始した新しいLINEヤフー広告の計測タグ（詳細はこちら）を設置していない場合、本ページでご案内しているLINEヤフー広告 ディスプレイ広告のコンバージョン補完機能はご利用いただけません。
事前準備
下記の事前準備を完了していることをご確認ください
広告APIの設定
左のメニューから 広告API を選択し、右上の 作成 から、LINE Yahoo! Conversion API を選択します。
名前 を入力します。必須です。説明は任意です。
事前準備で用意したタグID、アクセストークンを入力してください。
LINEユーザーIDを送信する場合は、チャネルIDを入力してください。
保存 を押します。
コネクタの設定
1.目的
目的で コンバージョン補完 を選びます。
テンプレート一覧から、LINE Yahoo! Conversion APIでコンバージョン補完をする(v1) を選択してください。
一度保存されたテンプレートは変更できません。
2.接続先
広告APIで作成した接続先を選択してください。必須です。未作成の場合は、横の 作成 から広告APIを作成できます。
独自にデータをハッシュ化
KARTEに既にハッシュ化された個人情報データを連携している場合は、ハッシュ済み にチェックします。
ハッシュ化のルールが媒体側の規定に沿っているか確認してください。
3.利用するデータ
コンバージョンデータ と 個人情報データ は、データライブラリで作成したものを選択します。未作成の場合は、項目の横にある 作成 から作成できます。元データの種類、カラムマッピング、絞り込みはデータライブラリの記事に従ってください。
LINEヤフー広告の仕様上、個人情報データ（email、phone、ifa）、ブラウザーID、クリックID、LINE User IDのうち、いずれか1つ以上の連携が必須となります。
コンバージョンデータ
LINEヤフー広告に送信するコンバージョンデータを抽出します。
データライブラリのコンバージョンデータ入力画面で必須バッジが付いているのは user_id と sync_date ですが、このコネクタでの必須フィールドは以下の通りです。
| フィールド名 | 必須 | 推奨 | 説明 |
|---|---|---|---|
| user_id | ○ | ユーザーID KARTEのuser_idを選択してください | |
| transaction_id | ○ | イベントの重複除外用ID 重複除外設定で送信した項目を選択してください。（最大64文字） | |
| sync_date | ○ | ※自動で取得されるため、変更不要です。 | |
| revenue | イベントの価値です。 以下の範囲内の半角数字で入力します（0 <= n < 10000000000）。 ※API仕様上、送信時の通貨単位は日本円（JPY）となります。 | ||
| items | アイテム情報を格納します。配列上限は10件です。 event_typeが「page_view」の時は指定できません。 | ||
| session_id | ○ | ※自動で取得されるため、変更不要です。 | |
| pv_id | ○ | ※自動で取得されるため、変更不要です。 |
個人情報データ
LINEヤフー広告に送信する個人情報データを抽出します。
このコネクタでの必須フィールドや各フィールドの説明は以下の通りです。
フィールド名 必須 推奨 説明 user_id ○ ユーザーID
KARTEのuser_idを選択してくださいemail ○ メールアドレス phone ○ 電話番号 first_name LINEヤフー広告への連携には使用しないため、設定不要です last_name LINEヤフー広告への連携には使用しないため、設定不要です gender LINEヤフー広告への連携には使用しないため、設定不要です birthday LINEヤフー広告への連携には使用しないため、設定不要です pref LINEヤフー広告への連携には使用しないため、設定不要です city LINEヤフー広告への連携には使用しないため、設定不要です zip_code LINEヤフー広告への連携には使用しないため、設定不要です country LINEヤフー広告への連携には使用しないため、設定不要です street_address LINEヤフー広告への連携には使用しないため、設定不要です idfa ○ ifa（広告識別子） aaid ○ ifa（広告識別子）
4.パラメータ
| パラメーター名 | 説明 |
|---|---|
| イベント種別 | イベント種別です。 |
| スニペットID | スニペットIDです。 コンバージョン設定の「フィルター条件」で「イベントスニペット」を選択した場合は設定必須です。 |
| データ利用時間 | 媒体に送信するデータの抽出の遡り期間を指定します。 現在から[入力された時間]前までのデータが抽出されます。24時間以内に送信することを推奨します。 |
| 広告接触からの日数 | アトリビューションウィンドウです。 広告接触から[入力された日数]以内であれば対象イベントを送信します。 |
5.データ確認
送信スケジュールの前に データ確認 があります。コネクタを保存するまでは、「コネクタを保存するとデータを確認できます」と表示されます。
設定後、必ず「保存」ボタンを押し、プレビューに意図通りのデータが表示されるか確認してください。
6.送信スケジュール
送信頻度は 単発送信 と 定期送信 から選びます。
単発送信 の場合は、送信日時 を指定します。現在時刻以前を設定すると即時実行されます。
定期送信 の場合は、実行間隔を設定してください。
コンバージョン補完の鮮度を保つため、毎時（1時間ごと）の実行を推奨します。
毎時（1時間ごと）の実行とする場合で、ユーザーマスタを利用するケースでは、「分」の部分は「50分」が推奨です。（データの反映遅延による抽出漏れを回避するため）
外部データを使う場合は、その連携頻度や連携時間に合わせてください。
7.基本情報
名前 は必須です。テンプレートIDと時刻が入った値が初期値として入っています。説明 は任意です。
8.送信
右上に 無効状態で保存 と 有効状態で保存 が並んでいます。
有効状態で保存 を押すと、「コネクタを送信」の確認が出ます。確認すると送信まで進みます。
無効状態で保存 を押すと送信はされず、状態が「無効」で保存されます。
送信確認
送信完了後、LINEヤフー広告 ディスプレイ広告のコンバージョン計測画面より確認が可能です。