您位於此處：
雲端檔案儲存的外部啟用平台
深入瞭解針對您的外部啟用平台傳送至 Amazon S3 的檔案。
檔案路徑
您所有的成功、中繼資料和啟用輸入檔案都會傳送到 S3。使用此資訊來解譯檔案路徑變數並找到您的檔案。
| 檔案路徑變數 | 描述 |
|---|---|
| Bucket-Name | 您在 Data 360 設定中設定外部啟用平台時提供的 S3 分類名稱。您可以直接寫入分類，無需根資料夾，或寫入分類中的特定資料夾。 |
| Date | 已發佈以 UTC 格式的日期檔案。日期是以 YYYY-MM-DD 格式表達。可在此處找到成功檔案。 |
| Account-ID | 此值代表您外部啟用平台中 Data 360 客戶的帳戶。針對外部啟用平台建立啟用目標時，需要此值。 |
| Activation-Run-ID | 36 個字元的字串，可區別發佈到相同啟用目標的多個客戶。多個資料夾代表不同的 Data 360 組織,將資料傳送至您外部啟用平台中的相同帳戶識別碼。可在此處找到中繼資料檔案。 |
| ID-Type | Data 360 會為每個識別碼類型產生啟用輸出檔案。這僅適用於依使用者識別碼 (PER_USER) 分組輸出時。支援的類型為雜湊的電子郵件、雜湊的電話號碼、行動廣告識別碼和 OTT 廣告識別碼。 |
識別碼類型 (ID-Type)
此表格顯示檔案的識別碼類型 (ID-Type) 值。這僅適用於使用手動工作流程建立的外部啟用平台。
| 類型 | 值 | 描述 |
|---|---|---|
| 電子郵件地址 | HEM_SHA25 | SHA256 雜湊電子郵件地址 |
| 電話號碼 | PHONE_SHA256 | SHA256 雜湊 E164 格式的電話號碼 |
| 行動廣告商識別碼 (MAID) | MAID | 行動裝置的廣告識別碼 |
| 過頂 (OTT) 識別碼 | OTT | OTT 或 CTV 裝置的廣告識別碼 |
檔案路徑為 s3://mydatacdp/Salesforce-CDP/ActivatedSegments/2021-11-29/123-456-789/63a37da2-7474-428b-bdca-54cc0d970de5/type=HEM_SHA25/part-0000-ca80176d-e93b-46d5-a17f-c448a078d34b.c000.csv.gz。
| 值 | 檔案路徑變數 |
|---|---|
| mydatacdp/Salesforce-CDP/ActivatedSegments | Bucket-Name |
| 2021-11-29 | Date |
| 123-456-789 | Account-ID |
| 63a37da2-7474-428b-bdca-54cc0d970de5 | Activation-Run-ID |
| Type=SHA256 | ID-Type |
中繼資料檔案
每日中繼資料檔案包含必要和隱藏欄位、選用欄位、區段識別碼和區段名稱的詳細資料。Data 360 管理員可以在安裝外部啟用平台時,透過停用「將區段名稱包含在此平台的啟用中」來排除區段名稱。中繼資料檔案僅包含發佈時的區段。在 Data 360 中停用、刪除或到期的區段不會顯示在中繼資料檔案中。
檔案儲存在 s3://{Bucket-Name}/{Date}/{Client-Account-ID}/{Activation-Run-ID}/metadata.json。
若要識別從 Data 360 刪除的區段,請每日比較中繼資料檔案內容以找出差異。
{
"metadata": {
"AccountId": "123456",
"OptionalField1": "default",
"HiddenField1": "Salesforce-CDP"
},
"segments": [
{
"segmentId": "1sgRN00000002tI",
"segmentName": "Shoe Lovers"
},
{
"segmentId": "1sgRN00000001tC",
"segmentName": "High-Value Customers"
},
{
"segmentId": "1sgRN00000001rV",
"segmentName": "Email Engagement in Last 30 Days"
}
]
}
啟用輸出檔案
針對每個識別碼類型，每天都會傳送多個啟用輸出檔案，其中包含當日發佈之區段的相關資訊。檔案包含識別碼類型的值，及該識別碼為其成員之區段的清單。每個部分檔案都是進行個別壓縮的 CSV、NLJSON 或 Parquet GZIP 檔案。
CSV 格式
CSV 檔案包含每個區段的標題和記錄詳細資料。
| 識別碼 | 新增項目 | 移除項目 |
|---|---|---|
| IFA-Value | Segment-IDs |
id,adds,removes
30f39b57-7a31-439b-beeb-c3aa22593b27,1sgRN00000001rV,""
NDJSON 格式
NDJSON 是以 {"id":"[IFA-Value]","adds":"[Segment-IDs]","removes":""} 格式分隔的新行。
此 JSON 檔案包含一個區段，此區段的識別碼為 1sgB000000000gq，而 IFA 值為 43950934。
{"id":"43950934","adds":"1sgB000000000gq","removes":""}