다음을 사용하여 광고 시스템 살펴보기 Flow Service API
이제 기본 연결이 만들어지면 고유한 기본 연결 ID를 사용하여 소스의 데이터 구조 및 콘텐츠를 탐색하고 탐색할 수 있습니다. 이렇게 하면 데이터 흐름을 만들어 Adobe Experience Platform으로 가져오기 전에 특정 항목과 해당 데이터 유형 및 형식을 식별할 수 있습니다.
이 튜토리얼에서는 Flow Service API 광고 시스템을 살펴보십시오.
시작하기
이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
다음 섹션에서는 를 사용하여 광고 시스템에 성공적으로 연결하기 위해 알아야 하는 추가 정보를 제공합니다 Flow Service API.
Platform API 사용
Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 의 안내서를 참조하십시오. platform API 시작하기.
데이터 테이블 탐색
광고 시스템에 대한 기본 연결을 사용하여 GET 요청을 수행하여 데이터 테이블을 탐색할 수 있습니다. 다음 호출을 사용하여 검사하거나 수집할 테이블의 경로를 찾습니다 Platform.
API 형식
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root
{BASE_CONNECTION_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}
{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및 해당 구조에 대한 정보를 얻었습니다. 다음 자습서에서 이 정보를 사용하여 다음을 수행할 수 있습니다. 광고 시스템에서 데이터를 수집하고 플랫폼으로 가져옵니다..