LiveRamp (旧称 Habu) は、広告主がどこにあってもデータを操作できる安全なデータ コラボレーション ソリューションを提供します。 このソリューションは、計画、ターゲット設定、測定にわたるさまざまなユース ケースをサポートします。
この機能は、Azure Confidential Computing (ACC) プラットフォーム上に構築されています。 これにより、Microsoft Advertising のお客様は次のことができます。
- カスタム クエリを実行して測定シナリオを分析する
- 実用的な分析情報を生成する
- キャンペーンのアクティブ化のためにカスタム オーディエンスを構築する
すべてのデータ処理は、ハードウェア ベースの信頼された実行環境 (TE) 内で行われます。 これにより、データがプライベートでセキュリティで保護されたままになります。
クリーンルームにアップロードされた広告主のシグナル:
- 広告主の専用 LiveRamp インスタンス内に残る
- Microsoft からアクセスできないか、エクスポートできない
分析は、キャンペーンや時間範囲など、選択したディメンション間で TEE 内で実行されます。 厳格なプライバシー要件を満たすために、結果が集計され、匿名化されます。
データ ソース
Microsoft Advertising キャンペーン イベント データは暗号化され、Microsoft が管理するAzure インフラストラクチャに格納されます。 このデータは、Microsoft Advertising Platform (MAP) または Microsoft 収益化キャンペーンから発生する可能性があります。
このデータは、次の表を使用して参照できます。
- Microsoft Advertising Platform (MAP) トラフィック
- Microsoft の収益化トラフィック
- 変換データ テーブル
- 対象ユーザー セグメント メンバーシップ
すべてのテーブルでフラット スキーマが使用されます。 各列には、次のものが含まれます。
- 名前
- データ型
- 説明
データ コラボレーションは、クリーン ルームのプライバシー保護の境界内で行われ、Microsoft Advertising の入力と出力 k-min の制約に従います。
暗号化されたイベント データは、毎日 LiveRamp クリーン ルームで自動的に使用できるようになります。 広告主またはそのパートナーは、SQL クエリ ( 質問と呼ばれます) を使用してデータをアップロードして参加させることもできます。
現時点では、ハッシュされたメール (HEM) での正確な結合のみがサポートされています。 今後、追加の識別子がサポートされる可能性があります。
Microsoft Advertising Platform (MAP) トラフィック テーブル
これらのテーブルには、クリーン ルーム インスタンスに追加された MAP キャンペーンからのトラフィック イベント (インプレッション数とクリック数) が含まれます。
サポートされているキャンペーンの種類は次のとおりです。
- 検索
- Audience
- ショッピング
- ホテル
- パフォーマンス最大化
テーブルmap_ad_events
| 列名 | データ型 | 説明 | サポートされているキャンペーンの種類 |
|---|---|---|---|
| rguid | STRING | 広告リクエストの 128 ビット一意識別子。 | すべて |
| date_time | LONG (Unix タイムスタンプ) | イベントの日付と時刻 (UTC)。 | すべて |
| event_type_id | INTEGER | イベントの種類の識別子。 有効な値: 1 = インプレッション数、2 = クリック数。 | |
| hashed_email | STRING | ユーザーを表す SHA256 ハッシュメール。 | すべて |
| hashed_ip_address | STRING | ユーザーを表す SHA256 ハッシュ IP アドレス。 | すべて |
| country | STRING | イベントの国コード (米国、CA など)。 | すべて |
| 地域 | STRING | イベントの地理的リージョン (米国の状態など)。 | すべて |
| operating_system | STRING | デバイスのオペレーティング システム。 | すべて |
| ブラウザー | STRING | イベントに使用されるブラウザー。 | すべて |
| publisher_id | INTEGER | パブリッシャーの一意識別子。 | すべて |
| publisher_name | STRING | 発行元の人間が判読できる名前。 | すべて |
| site_domain | STRING | 利用可能な最も詳細なサイト識別子。 | すべて |
| advertiser_account_id | INTEGER | MAP – 広告主の一意の識別子。 | すべて |
| campaign_id | 長い | MAP – キャンペーンの一意の識別子。 | すべて |
| ad_group_id | 長い | MAP – 広告グループの一意の識別子。 | |
| ad_id | 長い | MAP – 広告の一意識別子 (クリエイティブ)。 | |
| device_type_id | INTEGER | デバイスの種類の識別子。 | すべて |
| device_type_name | STRING | 人間が判読できるデバイスの種類 (モバイル、PC など)。 | すべて |
| postal_code | STRING | イベントが発生した郵便番号 (使用可能な場合)。 | すべて |
| bidded_keyword | STRING | 当選したキャンペーンの対象となるキーワード。 | 検索 |
| query_id | STRING | 一意のクエリ文字列の識別子。 | 検索 |
| 過ごす | DECIMAL | メディアのコスト (CPM)。 | すべて |
| advertiser_account_name | STRING | MAP – 人間が判読できる広告主名。 | すべて |
| campaign_name | STRING | MAP – 人間が判読できるキャンペーン名。 | すべて |
| ad_group_name | STRING | MAP – 人間が判読できる広告グループ名。 | |
| start_date | タイムスタンプ | キャンペーンまたは広告グループの開始日。 | |
| end_date | タイムスタンプ | キャンペーンまたは広告グループの終了日。 | |
| record_date | STRING | レコードが収集された日付。 | すべて |
| campaign_type | STRING | キャンペーンの種類 (たとえば、BW、AWF)。 | すべて |
| ad_group_type | STRING | 広告グループの種類 (検索Standard、動的検索など)。 | |
| ad_group_price_type | STRING | 広告グループの価格の種類 (CPC、CPM、CPA など)。 | |
| asset_group_id | INTEGER | 資産グループの識別子。 | PMax |
| asset_group_name | STRING | 資産グループの名前。 | PMax |
| asset_group_start_date | タイムスタンプ | 資産グループの開始日。 | PMax |
| asset_group_end_date | タイムスタンプ | 資産グループの終了日。 | PMax |
| event_type_name | STRING | 人間が判読できるイベントの種類名 (インプレッション、クリック、ビューなど)。 |
Microsoft のトラフィック テーブルの収益化
これらのテーブルには、オンボードされた XBox 直販広告申込情報のインプレッションとクリックデータが含まれます。
テーブルmonetize_ad_events
| 列名 | データ型 | 説明 |
|---|---|---|
| auction_id_64 | 長い | オークションの 64 ビット一意識別子。 |
| date_time | LONG (Unix タイムスタンプ) | イベントの日付と時刻 (UTC)。 |
| event_type | INTEGER | イベントの種類の識別子 (インプレッション、クリックなど)。 |
| hashed_email | STRING | ユーザーを表す SHA256 ハッシュメール。 |
| hashed_ip_address | STRING | ユーザーを表す SHA256 ハッシュ IP アドレス。 |
| country | STRING | イベントの国コード (米国、CA など)。 |
| 地域 | STRING | イベントの地理的リージョン (米国の状態など)。 |
| operating_system | STRING | デバイスのオペレーティング システム。 |
| ブラウザー | STRING | イベントに使用されるブラウザー。 |
| publisher_id | INTEGER | パブリッシャーの一意識別子。 |
| publisher_name | STRING | 発行元の人間が判読できる名前。 |
| site_domain | STRING | 利用可能な最も詳細なサイト識別子。 |
| advertiser_id | INTEGER | Xandr – 広告主の一意の識別子。 |
| insertion_order_id | INTEGER | Xandr – 挿入順序の一意の識別子。 |
| line_item_id | INTEGER | Xandr – 行項目の一意識別子。 |
| creative_id | INTEGER | Xandr – クリエイティブの一意識別子。 |
| device_unique_id | STRING | デバイスの一意識別子。 |
| device_type_id | INTEGER | デバイスの種類の識別子。 |
| device_type_name | STRING | 人間が判読できるデバイスの種類 (モバイル、PC など)。 |
| postal_code | STRING | イベントが発生した郵便番号 (使用可能な場合)。 |
| media_cost | DECIMAL | メディアのコスト (CPM)。 |
| advertiser_name | STRING | Xandr – 広告主の名前。 |
| insertion_order_name | STRING | Xandr – 挿入順序の名前。 |
| line_item_name | STRING | Xandr – 行項目の名前。 |
| start_date | 長い | 行項目の開始日。 |
| end_date | 長い | 明細の終了日。 |
| line_item_type | STRING | 広告申込情報の種類 (バナー、ネイティブなど)。 |
| line_item_price_type | STRING | 品目によって使用される価格の種類 (CPM など)。 |
| split_id | INTEGER | オークションの対象となる分割の識別子。 |
| split_name | STRING | ターゲット分割の名前。 |
| 表示 | Int32 | 広告イベントが表示可能かどうかを示します。 |
| booked_revenue_usd | DOUBLE | 広告イベントの予算を配信しました。 |
| creative_name | STRING | クリエイティブの広告主定義の名前。 |
| creative_type | STRING | クリエイティブの種類 (バナー、ネイティブ、ビデオ、オーディオなど)。 |
| placement_id | INTEGER | 広告が配信された配置の識別子。 |
| placement_group | STRING | パブリッシャー定義の配置グループ。 |
| placement_name | STRING | 配置の発行元定義の名前。 |
MAP 変換データ テーブル
これらのテーブルには、次の両方が含まれます。
- 広告公開 (属性付き) コンバージョン
- 広告が公開されていない (属性が設定されていない) 変換
データ ソースには、次のものが含まれます。
- ユニバーサル イベント追跡 (UET)
- UET サーバー間 (S2S) イベント
- オフライン変換
- UET SDK イベント
- 変換 API イベント
コンバージョンは、ユーザーがコンバージョンの前にキャンペーンのルックバック ウィンドウ (既定: 30 日) 内にトラフィック イベントを受信した場合、広告属性と見なされます。
テーブルmap_attributed_conversion_events
| 列名 | データ型 | 説明 |
|---|---|---|
| RGUID | STRING | 属性付きイベントの RGUID。は、関連するインプレッションまたはクリックと一致します。 |
| event_timestamp | 長い | 元のイベントが発生したときの UTC タイムスタンプ。 |
| conversion_timestamp | 長い | 変換が発生した時刻の UTC タイムスタンプ。 |
| campaign_id | 長い | コンバージョンに関連付けられた MAP キャンペーン。 |
| ad_id | 長い | コンバージョンに関連付けられた MAP 広告。 |
| goal_id | 長い | MAP からの目標 ID。 |
| goal_name | STRING | MAP からの目標またはタグ名。 |
| domain | STRING | イベントが発生したドメイン。 |
| hashed_email | STRING | イベントに関連付けられたハッシュされた電子メール (UMS 参照が存在しない場合)。 |
| goal_value | DOUBLE | MAP で設定された金額目標値または非通貨目標値。 |
| goal_currency_code | STRING | 目標値の通貨。 |
| goal_value_microcents | 長い | マイクロセント単位の目標値。 |
| iso_country_code | STRING | イベント発生時のユーザーの ISO 国コード。 |
| goal_lookback_days | INT | 目標に対して構成されたルックバック ウィンドウ。 |
| ms_click_id | STRING | イベントに関連付けられている [ID] をクリックします。 |
テーブルmap_raw_conversion_events
| 列名 | データ型 | 説明 |
|---|---|---|
| event_timestamp | 長い | UET イベントが発生した時刻。 |
| collected_timestamp | 長い | S2S イベントまたは CAPI イベントに対して UET イベントが収集された時刻。 |
| tag_id | 長い | イベントのタグ ID (MAP UI に表示されます)。 |
| tag_name | STRING | イベントのタグ名 (MAP UI に表示されます)。 |
| event_source | STRING | イベントのソース (UET、UETS2S、CAPI など)。 |
| domain | STRING | イベントが発生したドメイン。 |
| hashed_email | STRING | イベントに関連付けられたハッシュされた電子メール (まだ存在しない場合は UMS 参照経由)。 |
| iso_country_code | STRING | イベント発生時のユーザーの ISO 国コード。 |
| ms_click_id | STRING | イベントに関連付けられている [ID] をクリックします。 |
テーブルmap_goal_achieved_conversion_events
| 列名 | データ型 | 説明 |
|---|---|---|
| event_timestamp | 長い | UET イベントが発生した時刻。 |
| tag_id | 長い | 目標に関連付けられている UET タグ ID。 |
| goal_id | 長い | イベントの目標 ID (MAP UI に表示されます)。 |
| goal_name | STRING | イベントの目標名 (MAP UI に表示されます)。 |
| goal_value | DOUBLE | MAP で設定された金額目標値または非通貨目標値。 |
| goal_currency_code | STRING | MAP で設定された目標の通貨。 |
| goal_value_microcents | 長い | マイクロセント単位の目標値。 |
| goal_lookback_days | INT | 目標に対して構成された [ルックバック] ウィンドウを最後にクリックします。 |
| event_source | STRING | イベントのソース (UET、UETS2S、CAPI など)。 |
| domain | STRING | イベントが発生したドメイン。 |
| hashed_email | STRING | イベントに関連付けられたハッシュされた電子メール (まだ存在しない場合は UMS 参照経由)。 |
| iso_country_code | STRING | イベント発生時のユーザーの ISO 国コード。 |
| ms_click_id | STRING | イベントに関連付けられている [ID] をクリックします。 |
コンバージョン データ テーブルを収益化する
次の表には、収益化の広告申込情報に関連付けられている Xbox Store 購入イベントが含まれています。
広告公開コンバージョンと非広告公開コンバージョンの両方が含まれます。
コンバージョンは、ユーザーがコンバージョンの 1 ~ 14 日前に構成されたルックバック ウィンドウ内でトラフィック イベントを受信した場合、広告属性と見なされます。
テーブルxbox_conversions
| 列名 | データ型 | Pii。 (k-min ラベルが必要) | 説明 |
|---|---|---|---|
| date | INTEGER | 不要 | 変換イベントの日付 (YYYYMMDD 形式)。 |
| purchase_time | 長い | 不要 | アイテムが購入され、フルフィルメントされたときの Unix タイムスタンプ。 |
| line_item_id | INTEGER | 不要 | 製品に関連付けられている広告申込情報 ID を収益化します。 |
| advertiser_id | INTEGER | 不要 | 広告申込情報に関連付けられている広告主 ID を収益化します。 |
| hashed_email | STRING | はい | 公開の結合キーとして使用される SHA256 ハッシュ。 |
| product_id | STRING | 不要 | 製品の一意識別子。 |
| product_name | STRING | 不要 | 人間が判読できる製品名。 |
| product_category | STRING | 不要 | 製品のカテゴリまたはジャンル (categoryName から)。 |
| is_paid_transaction | ブール | 不要 | 購入が有料か無料かを示します。 |
| purchase_price_usd | DECIMAL | 不要 | 税引き前の米ドルでの購入価格。 |
| purchase_price_usd_microcents | 長い | 不要 | マイクロセントで価格を購入します。 |
| purchase_currency_code | STRING | 不要 | 購入に使用される通貨。 |
| device_family | STRING | 不要 | デバイス ファミリ (PC、本体、モバイルなど)。 |
| device_model | STRING | 不要 | デバイス モデル (Xbox One X、Xbox Series S など)。 |
| in_game_purchase | ブール | 不要 | 購入がゲーム内で発生したかどうかを示します。 |
| has_xbox_live_subscription | ブール | 不要 | ユーザーが Xbox Live サブスクリプションを持っているかどうかを示します。 |
| has_xbox_game_pass_for_console | ブール | 不要 | ユーザーが本体用 Xbox Game Pass を持っているかどうかを示します。 |
| has_xbox_game_pass_for_pc | ブール | 不要 | ユーザーが PC 用 Xbox Game Pass を持っているかどうかを示します。 |
| has_xbox_game_pass_ultimate | ブール | 不要 | ユーザーが Xbox Game Pass Ultimate を持っているかどうかを示します。 |
| transaction_type | STRING | 不要 | トランザクションの種類 (予約注文、購入など)。 |
| iso_country_code | STRING | 不要 | イベントが発生した国コード。 |
| order_id | STRING | 不要 | 購入に関連付けられている一意のトランザクション ID。 |
| hashed_xbox_id | 長い | はい | 購入に関連付けられている XUID。 |
対象ユーザー セグメント メンバーシップ
この表には、アクティブ ユーザーの最新のユーザーとセグメントの関連付けが含まれています。 アクティブ ユーザーは、インプレッションを提供されたユーザーとして定義されます。 詳細については、 市場で利用できる対象ユーザーに関するページを参照してください。
テーブルmap_ima_segment_exposures
| 列名 | データ型 | 説明 |
|---|---|---|
| hashed_email | STRING | レコードに関連付けられているユーザーを表す SHA256 ハッシュメール。 |
| segment_id | INTEGER | ユーザーが属している一意のセグメント ID。 |
| segment_name | STRING | ユーザーに関連付けられた人間が判読できるセグメント名。 |
広告主データのアップロード
広告主は、次の 2 つの方法で、ファースト パーティのデータを LiveRamp クリーン ルームにアップロードできます。
- データを移動せずに、サポートされているパブリック クラウド ソースからデータを接続する
- ユーザー ファイルを直接アップロードする
アップロードされたデータセットには、次のようなさまざまなデータ型を含めることができます。
- オフライン トランザクション データ (たとえば、ストア訪問やアプリ内購入が UET または CAPI によって追跡されない)
- CRM 対象ユーザー セグメントまたは顧客データ
- 顧客プロファイル (ロイヤルティ プログラムメンバーなど)
- Web またはアプリ分析イベント
サポートされている識別子 (ハッシュされたメールなど) を含むデータセットを Microsoft データと結合して、インプレッションとクリックのカスタム属性をサポートできます。
個人を特定できる情報 (PII) を含むファイル (メール アドレスなど) は、アップロード前に標準化およびハッシュ化する必要があります。 SHA-256 は、サポートされているハッシュ方法です。
データの書式設定とハッシュ
ユーザーのプライバシーを保護するには、アップロードする前に個人データを書式設定してハッシュします。
データの書式設定
次のガイドラインに従います。
- E.164 標準を使用して電話番号を書式設定する
メール アドレスの場合:
- 先頭と末尾の空白を削除する
- すべての文字を小文字に変換する
- "+" と "@" の間のテキストを削除する
- 例:
name+alias@outlook.com→name@outlook.com
- 例:
- "@" より前の期間を削除する
- 例:
e.xample@outlook.com→example@outlook.com
- 例:
- アドレスに "@" が含まれていることを確認します
- すべてのスペースを削除する
- ドメイン サフィックスが存在することを確認します (たとえば、
.com) - アクセント付き文字を削除する (例:
à)
ハッシュ データ
- SHA-256 ハッシュ アルゴリズムを使用する
- 塩漬けは適用しない
| キーの種類 | 値の例 | ハッシュ (SHA-256、ソルトなし、小文字) |
|---|---|---|
| XUID | 1234567890123456 | 7a51d064a1a216a692f753fcdab276e4ff201a01d8b66f56d50d4d719fd0dc87 |
| 電子メール | example@outlook.com | 912ec7074338e900ecd85cd53cf0e7c3e4e00cb65120eb5a18463a30f0e3e208 |
クエリ (質問) 承認プロセス
別のパーティのデータを含むクエリは、実行前に承認プロセスを通過する必要があります。
このプロセスは、PII を保護し、プライバシー保護策への準拠を確保するのに役立ちます。
検証手順
構文の検証
SQL クエリがデータ所有者によって定義されたデータセット制約を満たしていることを確認しますプライバシーと品質チェック
入力と出力の k-min しきい値など、すべてのクエリがクリーンルームのプライバシー制御に準拠していることを確認しますクエリの承認
実行前に Microsoft と広告主の両方から手動で承認する必要があります