クエリを作成

SELECT 文やその他の制限付きコマンドに標準 ANSI SQL のすべての機能を使用して、データフィードのデータを生成するクエリを作成および実行できます。 詳しくは、SQL 構文を参照してください。 この SQL 構文を超えて、Adobeでは次の機能をサポートしています。

データフィード列

クエリで使用できる 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 をクエリできます。 identityMapMap 型で、 ネストされたデータ構造を使用します。

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_idstringヒットを識別する一意の ID。
hitid_low_idstringhitid_high と共に使用して、ヒットを一意に識別します。
hitid_high_idstringhitid_high と共に使用して、ヒットを一意に識別します。
hit_time_gmtreceivedTimestampstringヒットのタイムスタンプ(UNIX® 時間に基づく)。
cust_hit_time_gmttimestampstringこのタイムスタンプは、タイムスタンプが有効なデータセットでのみ使用されます。 このタイムスタンプは、UNIX® 時間に基づいて、ヒットと共に送信されます。
visid_high + visid_lowidentityMapオブジェクト訪問の一意の ID。
visid_high + visid_lowendUserIDs._experience.aaid.idstring訪問の一意の ID。
visid_highendUserIDs._experience.aaid.primaryブール型visid_low と共に使用して、訪問を一意に識別します。
visid_highendUserIDs._experience.aaid.namespace.codestringvisid_low と共に使用して、訪問を一意に識別します。
visid_lowidentityMapオブジェクトvisid_high と共に使用して、訪問を一意に識別します。
cust_visididentityMapオブジェクト顧客訪問者 ID。
cust_visidendUserIDs._experience.aacustomid.idオブジェクト顧客訪問者 ID。
cust_visidendUserIDs._experience.aacustomid.primaryブール型顧客訪問者 ID 名前空間コード。
cust_visidendUserIDs._experience.aacustomid.namespace.codestringvisid_low と共に使用して、顧客訪問者 ID を一意に識別します。
geo\_*placeContext.geo.*文字列、数値ジオロケーションデータ(国、地域、都市など)
event_listcommerce.purchases, commerce.productViews, commerce.productListOpens, commerce.checkouts, commerce.productListAdds, commerce.productListRemovals, commerce.productListViews, _experience.analytics.event101to200.*, …, _experience.analytics.event901_1000.*stringヒットに対してトリガーされる標準コマースイベントとカスタムイベント。
page_eventweb.webInteraction.typestringイメージリクエストで送信されるヒットのタイプ(標準的なヒット、ダウンロードリンク、離脱リンク、クリックされたカスタムリンク)。
page_eventweb.webInteraction.linkClicks.valuenumberイメージリクエストで送信されるヒットのタイプ(標準的なヒット、ダウンロードリンク、離脱リンク、クリックされたカスタムリンク)。
page_event_var_1web.webInteraction.URLstringリンクトラッキングイメージリクエストでのみ使用される変数。この変数には、クリックされたダウンロードリンク、離脱リンク、またはカスタムリンクの URL が含まれます。
page_event_var_2web.webInteraction.namestringリンクトラッキングイメージリクエストでのみ使用される変数。このリストは、リンクのカスタム名をリスト表示します(指定されている場合)。
paid_searchsearch.isPaidブール型ヒットが有料検索の検出に一致した場合に設定されるフラグ。
ref_typeweb.webReferrertypestringヒットのリファラルのタイプを表す数値 ID。