クエリを作成
SELECT 文やその他の制限付きコマンドに標準 ANSI SQL のすべての機能を使用して、データフィードのデータを生成するクエリを作成および実行できます。 詳しくは、SQL 構文を参照してください。 この SQL 構文を超えて、Adobeでは次の機能をサポートしています。
- 事前に作成された Adobe定義関数(ADF)はExperience Platformデータレイクに保存されたイベントデータに対して一般的なビジネス関連タスクを実行するのに役立ちます。これには、 セッション化および アトリビューションの関数が含まれます。
- いくつかのビルトイン Spark SQL 関数、
- メタデータ PostgreSQL コマンド、
- 準備済みステートメント。
データフィード列
クエリで使用できる XDM フィールドは、データセットが基づいているスキーマ定義によって異なります。 データセットの基礎となるスキーマを理解していることを確認します。 詳しくは、 データセット UI ガイドを参照してください。
データフィード列と XDM フィールド間のマッピングを定義するには、Analytics フィールドマッピングを参照してください。 スキーマ、クラス、フィールドグループ、データタイプなど、XDM リソースの管理方法について詳しくは、 スキーマ UI の概要も参照してください。
例えば、ページ名 をデータフィードの一部として使用する場合は、次のようになります。
- Adobe Analytics データフィードの UI では、列として pagename を選択すると、データフィードの定義に追加されます。
- クエリサービスでは、Web サイトのサンプルイベントスキーマ(グローバル v1.1) エクスペリエンスイベントスキーマに基づいて)
sample_event_dataset_for_website_global_v1_1
データセットのweb.webPageDetails.name
をクエリに含めます。 詳しくは、Web 詳細スキーマフィールドグループを参照してください。
ID
Experience Platformとして、様々な ID を使用できます。 クエリを作成する場合は、ID に対して正しくクエリを実行していることを確認します。
ID は、多くの場合、別のフィールドグループで見つかります。 実装では、ECID (ecid
)は、core
オブジェクトを持つフィールドグループの一部として定義できます。このフィールドグループは、それ自体が identification
オブジェクトの一部です(例:_sampleorg.identification.core.ecid
)。 ECID の整理はスキーマによって異なる場合があります。
または、identityMap
を使用して ID をクエリできます。 identityMap
は Map
型で、 ネストされたデータ構造を使用します。
Experience Platformで ID フィールドを定義する方法について詳しくは、UI での ID フィールドの定義を参照してください。
Analytics ソースコネクタを使用する際にAdobe Analytics ID がプライマリ ID にどのようにマッピングされるかについては 🔗Analytics データのExperience Platform ID を参照してください。 このマッピングは、Analytics ソースコネクタを使用していない場合でも、ID を設定するためのガイダンスとして機能する場合があります。
ヒットレベルのデータと識別
実装方法に基づいて、従来Adobe Analyticsで収集されていたヒットレベルのデータが、タイムスタンプ付きのイベントデータとしてExperience Platformに保存されるようになりました。 次の表は、Analytics フィールドマッピングから抽出したもので、ヒットレベル固有のAdobe Analytics データフィード列をクエリ内の対応する XDM フィールドにマッピングする方法の例を示しています。 また、この表は、XDM フィールドを使用してヒット、訪問、訪問者を識別する方法の例も示しています。
データフィード列 | XDM フィールド | タイプ | 説明 |
---|---|---|---|
hitid_high + hitid_low | _id | string | ヒットを識別する一意の ID。 |
hitid_low | _id | string | hitid_high と共に使用して、ヒットを一意に識別します。 |
hitid_high | _id | string | hitid_high と共に使用して、ヒットを一意に識別します。 |
hit_time_gmt | receivedTimestamp | string | ヒットのタイムスタンプ(UNIX® 時間に基づく)。 |
cust_hit_time_gmt | timestamp | string | このタイムスタンプは、タイムスタンプが有効なデータセットでのみ使用されます。 このタイムスタンプは、UNIX® 時間に基づいて、ヒットと共に送信されます。 |
visid_high + visid_low | identityMap | オブジェクト | 訪問の一意の ID。 |
visid_high + visid_low | endUserIDs._experience.aaid.id | string | 訪問の一意の ID。 |
visid_high | endUserIDs._experience.aaid.primary | ブール型 | visid_low と共に使用して、訪問を一意に識別します。 |
visid_high | endUserIDs._experience.aaid.namespace.code | string | visid_low と共に使用して、訪問を一意に識別します。 |
visid_low | identityMap | オブジェクト | visid_high と共に使用して、訪問を一意に識別します。 |
cust_visid | identityMap | オブジェクト | 顧客訪問者 ID。 |
cust_visid | endUserIDs._experience.aacustomid.id | オブジェクト | 顧客訪問者 ID。 |
cust_visid | endUserIDs._experience.aacustomid.primary | ブール型 | 顧客訪問者 ID 名前空間コード。 |
cust_visid | endUserIDs._experience.aacustomid.namespace.code | string | visid_low と共に使用して、顧客訪問者 ID を一意に識別します。 |
geo\_* | placeContext.geo.* | 文字列、数値 | ジオロケーションデータ(国、地域、都市など) |
event_list | commerce.purchases , commerce.productViews , commerce.productListOpens , commerce.checkouts , commerce.productListAdds , commerce.productListRemovals , commerce.productListViews , _experience.analytics.event101to200.* , …, _experience.analytics.event901_1000.* | string | ヒットに対してトリガーされる標準コマースイベントとカスタムイベント。 |
page_event | web.webInteraction.type | string | イメージリクエストで送信されるヒットのタイプ(標準的なヒット、ダウンロードリンク、離脱リンク、クリックされたカスタムリンク)。 |
page_event | web.webInteraction.linkClicks.value | number | イメージリクエストで送信されるヒットのタイプ(標準的なヒット、ダウンロードリンク、離脱リンク、クリックされたカスタムリンク)。 |
page_event_var_1 | web.webInteraction.URL | string | リンクトラッキングイメージリクエストでのみ使用される変数。この変数には、クリックされたダウンロードリンク、離脱リンク、またはカスタムリンクの URL が含まれます。 |
page_event_var_2 | web.webInteraction.name | string | リンクトラッキングイメージリクエストでのみ使用される変数。このリストは、リンクのカスタム名をリスト表示します(指定されている場合)。 |
paid_search | search.isPaid | ブール型 | ヒットが有料検索の検出に一致した場合に設定されるフラグ。 |
ref_type | web.webReferrertype | string | ヒットのリファラルのタイプを表す数値 ID。 |