この記事は、リニューアル後のKARTE Signalsコネクタに関する内容です。 現在ご利用のUIが旧バージョンの場合は、上記のリニューアル前のサポート記事をご確認ください。
できること
KARTE Signalsでは、Microsoft Advertising API（Bulk Service）を使用してMicrosoft広告のカスタマーリストに、KARTEのセグメントやイベントデータから作成したオーディエンスリストを連携することができます。ここではその連携方法について説明します。
参考：Customer List Item Record - Bulk
事前準備
広告APIの設定
その他の機能 > 広告API > 作成 から、Microsoft Ads Audience を選択します。
名前 を入力します。必須です。説明は任意です。
Microsoft アカウントID、カスタマーIDを入力してください。
認証トークンの 取得 をクリックします。別ウィンドウ（ポップアップ）でMicrosoftのサインイン画面が表示されますので、対象のアカウントで認可してください。
保存 を押します。
コネクタの設定
1.目的の選択
目的で ターゲティング を選びます。
テンプレート一覧から、Microsoft Ads API にオーディエンスを送る(v1) を選択してください。
2.接続先
広告APIで作成した接続先を選択してください。
新規にオーディエンスを作成する場合
カスタマーリスト名を入力してください。
メンバーシップ期間：対象ユーザーを作成するときに、Microsoft広告が対象ユーザーの定義に一致するアクションを、どの程度前から検索するかを指定できます（1～390日、任意）。未指定の場合は、有効期限なしとなります。
既存のオーディエンスリストを更新する場合
Microsoft広告の管理画面から取得したカスタマーリストIDを指定してください。
3.利用するデータ
独自に個人情報データをハッシュ対応している場合は、個人情報は事前にハッシュ化済みで、「個人情報をハッシュ化している」を選択してください。
オーディエンスリスト と 個人情報データ は、どちらも必須です。データライブラリで作成したものを選択します。未作成の場合は、項目の横にある 作成 から作成できます。
Microsoft広告への連携で使う個人情報の項目は次のとおりです。
| フィールド名 | 必須 | 推奨 | 説明 |
|---|---|---|---|
| user_id | ○ | ユーザーID。KARTEのuser_idを選択してください | |
| ○ | メールアドレス | ||
| phone | Microsoft広告への連携には使用しないため、設定不要です | ||
| first_name | Microsoft広告への連携には使用しないため、設定不要です | ||
| last_name | Microsoft広告への連携には使用しないため、設定不要です | ||
| gender | Microsoft広告への連携には使用しないため、設定不要です | ||
| birthday | Microsoft広告への連携には使用しないため、設定不要です | ||
| pref | Microsoft広告への連携には使用しないため、設定不要です | ||
| city | Microsoft広告への連携には使用しないため、設定不要です | ||
| zip_code | Microsoft広告への連携には使用しないため、設定不要です | ||
| country | Microsoft広告への連携には使用しないため、設定不要です | ||
| street_address | Microsoft広告への連携には使用しないため、設定不要です | ||
| idfa | Microsoft広告への連携には使用しないため、設定不要です | ||
| aaid | Microsoft広告への連携には使用しないため、設定不要です |
リスト作成の例はレシピを参照してください。
4.データ確認
送信スケジュールの前に データ確認 があります。コネクタを保存するまでは、「コネクタを保存するとデータを確認できます」と表示されます。
5.送信スケジュール
定期的に連携する場合は、定期送信 にチェックを入れて、実行間隔を設定してください。外部データを使う場合は、その連携頻度や連携時間に合わせてください。
媒体側でのオーディエンスの置換・反映には時間がかかる場合があります。 APIの反映時間を考慮して送信間隔（スケジュール）を設定してください。
6.基本情報
タイトルには、テンプレートIDと時刻が入った値が初期値として入っています。変更する場合は編集してください。説明欄もあります。
7.送信
右上に 無効状態で保存 と 有効状態で保存 が並んでいます。
有効状態で保存 を押すと、「コネクタを送信」の確認が出ます。確認すると送信まで進みます。
無効状態で保存 を押すと送信されず、状態は「無効」になります。「下書き」という表示はありません。
送信確認
リストがMicrosoft Advertising上で利用可能になるまで、反映に最大48時間かかる場合があります。連携したカスタマーリストのサイズを確認し、ステータスが更新されていれば完了です。