できること

KARTE Signals ダッシュボードでは、広告媒体ごとのレポートデータを連携し、一元的に可視化できます。ここでは手動連携の方法について説明します。

※自動連携に対応している広告媒体については、広告レポートを自動連携するをご確認ください。

対応している連携方法

補足

同一の媒体・アカウントで既にデータを取り込んでいる場合は、広告媒体一覧の「編集」ボタンからファイル取り込みを実施してください。

フィールド名（変更可）	必須	説明	データ型	例
Date	○	日付	DATE	2024-05-01
CampaignId	○	キャンペーンID	STRING	campaign_id_01
CampaignName		キャンペーン名	STRING	campaign_name_01
AdGroupId		広告グループID	STRING	adgroup_id_01
AdGroupName		広告グループ名	STRING	adgroup_name_01
AdId		広告ID	STRING	ad_id_01
AdName		広告名	STRING	ad_name_01
Impressions		表示回数	INTEGER	1000
Clicks		クリック数	INTEGER	1000
Conversions		コンバージョン数	FLOAT	1000
Cost		広告費	FLOAT	1000

※同じレコードが複数取り込まれた場合は、後から取り込まれたレコードが優先されます。

【データ取り込み時の自動変換とフォーマット対応】
システム側で柔軟な型変換（日付・数値・文字列の型変換関数）をサポートしているため、媒体ごとのフォーマットの違いを意識せずに取り込むことが可能です。

多様な日付フォーマットに対応
- DATE 型のフィールドは、以下のようないくつかのフォーマットが混在していても自動で識別し、取り込むことができます。
- 例：2026-01-01 、2026/1/1 、01/01/2026 など
数値データのカンマ区切り対応
- INTEGER や FLOAT 型のフィールドにおいて、カンマ区切りの数値（例：1,000 ）が含まれていても、自動的に数値として変換して取り込みます。
欠損値（null / 空値）のサポート
- データが存在しない空値（空文字）や null が含まれる場合でもエラーにならず、適切な空データとして処理・取り込みを行います（必須項目を除く）。
- 数値型における null も許容されます。

krt_idパラメータを広告媒体のURLパラメータに追加します。
- このパラメータは、KARTEイベントデータと広告レポートを紐づけるために使用されます。
- 取り込むレポートの最小粒度で一意となる値を指定してください。
  設定例） krt_id=11111111（広告キャンペーン単位のレポートを取り込む場合で、キャンペーンIDが11111111の場合）
他の広告媒体とIDが重複する可能性がある場合は、固定文字列を追加してください。
設定例） krt_id=google_11111111