探索廣告系統,使用 Flow Service API
建立基本連線後,您現在可以使用唯一的基本連線ID來導覽和探索來源的資料結構和內容。 這可讓您在建立資料流並將其帶到Adobe Experience Platform之前,先識別特定專案及其各自的資料型別和格式。
本教學課程使用 Flow Service API 探索廣告系統。
快速入門
IMPORTANT
本教學課程需要您為廣告來源使用唯一的基本連線ID。 如果您沒有此ID,請參閱教學課程主題: 將廣告來源連線至Platform 教學課程。
本指南需要您實際瞭解下列Adobe Experience Platform元件:
以下小節提供您需要瞭解的其他資訊,以便使用成功連線到廣告系統 Flow Service API。
使用平台API
如需如何成功呼叫Platform API的詳細資訊,請參閱以下指南中的 Platform API快速入門.
探索您的資料表格
使用廣告系統的基本連線,您可以透過執行GET請求來探索資料表。 使用以下呼叫來尋找您要檢查或擷取的表格路徑 Platform.
API格式
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root
參數
說明
{BASE_CONNECTION_ID}
您Advertising系統的基本連線ID。
要求
curl -X GET \
'https://platform.adobe.io/data/foundation/flowservice/connections/2484f2df-c057-4ab5-84f2-dfc0577ab592/explore?objectType=root' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
回應
成功的回應是從到廣告系統的大量表格。 尋找您要加入的表格 Platform 並記下其 path
屬性,因為您必須在下一個步驟中提供它以檢查其結構。
[
{
"type": "table",
"name": "v201809.ACCOUNT_PERFORMANCE_REPORT",
"path": "v201809.ACCOUNT_PERFORMANCE_REPORT",
"canPreview": true,
"canFetchSchema": true
},
{
"type": "table",
"name": "v201809.ADGROUP_PERFORMANCE_REPORT",
"path": "v201809.ADGROUP_PERFORMANCE_REPORT",
"canPreview": true,
"canFetchSchema": true
},
{
"type": "table",
"name": "v201809.AD_CUSTOMIZERS_FEED_ITEM_REPORT",
"path": "v201809.AD_CUSTOMIZERS_FEED_ITEM_REPORT",
"canPreview": true,
"canFetchSchema": true
},
{
"type": "table",
"name": "v201809.AD_PERFORMANCE_REPORT",
"path": "v201809.AD_PERFORMANCE_REPORT",
"canPreview": true,
"canFetchSchema": true
}
]
Inspect表格的結構
若要從廣告系統檢查表格的結構,請在將表格路徑指定為查詢引數時執行GET要求。
API格式
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=table&object={TABLE_PATH}
參數
說明
{BASE_CONNECTION_ID}
您的廣告系統的連線ID。
{TABLE_PATH}
廣告系統中表格的路徑。
要求
curl -X GET \
'https://platform.adobe.io/data/foundation/flowservice/connections/2484f2df-c057-4ab5-84f2-dfc0577ab592/explore?objectType=table&object=v201809.AD_PERFORMANCE_REPORT' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
回應
成功的回應會傳回表格的結構。 有關每個表格欄的詳細資訊位於 columns
陣列。
{
"format": "flat",
"schema": {
"columns": [
{
"name": "CallOnlyPhoneNumber",
"type": "string",
"xdm": {
"type": "string"
}
},
{
"name": "AdGroupId",
"type": "long",
"xdm": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
}
},
{
"name": "AdGroupName",
"type": "string",
"xdm": {
"type": "string"
}
},
{
"name": "Date",
"type": "string",
"meta:xdmType": "date-time",
"xdm": {
"type": "string",
"format": "date-time"
}
},
]
}
}
後續步驟
依照本教學課程,您已探索您的廣告系統,找到您要帶入的表格路徑 Platform,並取得有關其結構的資訊。 您可以在下一個教學課程中使用此資訊來 從您的廣告系統收集資料,並將其帶入Platform.
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089