收錄並使用 Experience Platform 對象

在 Experience Platform UI 中：

1. 選取​客戶 > 對象。

2. 選取「瀏覽」並搜尋您要擷取並在Customer Journey Analytics中使用的對象。 記下每個對象的​ 對象ID ​以供稍後使用。

   

請求

curl -X POST \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?requestDataSource=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
   "name": "{DATASET_NAME}",
   "schemaRef": {
      "id": "_xdm.context.profile__union",
      "contentType": "application/vnd.adobe.xed+json;version=1"
   },
   "fileDescription": {
      "persistet": true,
      "containerFormat": "parquet",
      "format": "parquet"
   }
}'

其中：

• DATASET_NAME是資料集的易記名稱。 例如，Segment Export Job Dataset for CJA。

回應

["@/dataSets/{DATASET_ID}"]

其中：

• DATASET_ID是已建立資料集的資料集識別碼。

curl -X POST https://platform.adobe.io/data/core/ups/export/jobs \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "fields": "{COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES}",
    "filter": {
        "segments": [
            {
                "segmentId": "{AUDIENCE_ID_1}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_2}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_3}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ]
             }
        ]
    },
    "destination":{
        "datasetId": "{DATASET_ID}",
        "segmentPerBatch": false
    },
    "schema":{
        "name": "_xdm.context.profile"
    }
}'

執行

• COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES可能類似於_demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName。 確保您至少包含要在Customer Journey Analysis中使用的相關欄位(例如personID （電子郵件）)。
• AUDIENCE_ID_x是您要匯出之對象的對象識別碼。
• DATASET_ID是您建立的資料集。

回應

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
}

執行

• EXPORT_JOB_ID是匯出作業的識別碼。

請求

curl -X GET https://platform.adobe.io/data/core/ups/export/jobs/{EXPORT_JOB_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
  "status": "SUCCEEDED",
  "..."
}

在 Experience Platform UI 中：

1. 選取​資料管理 > 資料集。

2. 選取您建立的資料集，例如： CJA的區段匯出作業資料集。

   

3. 驗證擷取的批次。 如果資料集包含失敗的批次，請使用​資料管理 > 監視​檢視原因。 例如，您使用的欄位名稱不存在於結構描述中。

4. 複製資料集的​資料表名稱。 例如：segment_export_job_dataset_for_cja。 您會在下一個步驟中使用該名稱。

使用連線至Experience Platform查詢服務的PSQL使用者端。

在 Experience Platform UI 中：

1. 選取​資料管理 > 查詢。
2. 選取 認證。

使用認證來設定您的PSQL使用者端以連線至Customer Journey Analytics查詢服務。

查詢

執行此查詢以從資料集中擷取對象資料：

SELECT ROW_NUMBER() OVER (ORDER BY key)::text as _id, personID, key as audienceMembershipId
FROM (
   SELECT {IDENTITY_TO_USE_AS_PERSON_ID} AS personID, explode(segmentMembership.ups)
   FROM {DATASET_TABLE_NAME}
)
WHERE value.status = 'realized' AND (key = '{AUDIENCE_ID_1}' OR key = 'AUDIENCE_ID_2' OR key = 'AUDIENCE_ID_3')

其中：

• IDENTITY_TO_USE_AS_PERSON_ID是您定義為匯出作業一部分的欄位之一。 例如：_demoemea.identification.core.email。
• DATASET_TABLE_NAME是資料集的資料表名稱。
• AUDIENCE_ID_x是您定義為匯出作業一部分的對象。 由於匯出作業中的規格是列層級篩選器，因此您需要再次指定這些對象。 該列層級篩選器會傳回指定區段的設定檔，以及每個設定檔的所有區段會籍。

結果

查詢的結果以JSON格式表示，看起來應該像這樣：

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   },
   {
      "_id": "2",
      "personID": "PERSON_ID_y",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   }

]

其中：

• PERSON_ID_x是您要做為人員ID之識別碼的識別碼值。 例如，使用電子郵件時john.doe@gmail.com。
• AUDIENCE_ID_x是對象識別碼。

最終JSON看起來應該像這樣：

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_x}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_x}"
      }
  },
  {
      "_id": "2",
      "personID": "{PERSON_ID_y}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_y}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_y}"
      }
    }
  }

]

其中：

• TENANT_NAME是租使用者的名稱。 例如：_demoemea。
• PERSON_ID_x是您要做為人員ID之識別碼的識別碼值。 例如，使用電子郵件時john.doe@gmail.com。
• AUDIENCE_ID_x是對象識別碼。
• AUDIENCE_FRIENDLY_NAME_x是好記的對象名稱，適用於對象id。 例如：Luma - Blue+ Members。

使用您最愛的工具，將原始JSON轉換為此格式。

若要建立綱要：

在 Experience Platform UI 中：

1. 選取​資料管理 > 結構描述。

2. 選取 建立結構描述。 從下拉式功能表中選取​標準。

3. 在​ 建立結構描述 ​對話方塊中選取​手動，並使用​ 選取 ​繼續。

4. 在​ 建立結構描述 ​精靈的​ 選取類別 ​步驟中：

   1. 選取​個別設定檔。
   2. 選取​「下一步」。

5. 在​ 建立結構描述 ​精靈的​ 名稱和檢閱 ​步驟中：

   1. 輸入​結構描述顯示名稱。 例如：Audience Export for CJA Schema。
   2. （選擇性）輸入​描述。
   3. 選取​「完成」。

6. 設定您的結構描述以包含自訂欄位群組（例如​對象成員資格），其中包含兩個名為​ audienceMembershipId ​和​ audienceMembershipName ​的欄位。

7. 確定​ personID ​欄位是​身分、主要身分，並且具有​ 電子郵件 ​作為I​身分名稱空間。

   匯出的

8. 套用​所有變更。 選取​儲存，即可儲存您的結構。

在 Experience Platform UI 中：

1. 選取​資料管理 > 資料集。

2. 選取 建立資料集。

3. 選取​「從結構建立資料集」。

4. 在​ 從結構描述建立資料集 ​精靈的​ 選取結構描述 ​步驟中：

   1. 選取您剛建立的結構描述。 例如：CJA結構描述的對象匯出。
   2. 選取​「下一步」。

5. 在​ 從結構描述建立資料集 ​精靈的​ 設定資料集 ​步驟中：

   1. 輸入資料集的​名稱。
   2. （選擇性）輸入資料集的​描述。
   3. 選取​「完成」。

6. 在資料集的​資料集 > 名稱​中，拖曳轉換的JSON資料檔案，並將檔案拖放到​拖放檔案。 此動作會開始將匯出的JSON資料擷取到資料集中。

7. 驗證擷取的批次。 如果資料集包含失敗的批次，請使用​資料管理 > 監視​檢視原因。 例如，您在JSON中定義了結構描述中不存在的欄位名稱。

在Customer Journey Analytics UI中：

1. 選取​資料管理 > 連線。

2. 建立新連線/定義​ 連線設定 ​和​資料設定。 或選取現有的連線，並使用 編輯連線​來編輯連線。

3. 選取 新增資料集。

4. 選取您建立且內嵌轉換JSON資料的資料集。

5. 設定資料集。 例如：

   

6. 儲存​連線。

1. 選取​資料管理 > 資料檢視。

2. 編輯現有的資料檢視或建立新的資料檢視。

3. 在資料檢視的​ 元件 ​標籤中，確定​ 對象成員資格識別碼 ​和​ 對象成員資格名稱 ​已新增為維度元件。

   

4. 選取​ 儲存並繼續 ​以儲存資料檢視。