Utforska ett annonssystem med Flow Service API
När du har skapat en basanslutning kan du nu använda det unika basanslutnings-ID:t för att navigera och utforska källans datastruktur och innehåll. På så sätt kan du identifiera specifika objekt och deras respektive datatyper och format innan du skapar ett dataflöde och överför dem till Adobe Experience Platform.
I den här självstudiekursen används Flow Service API att utforska annonssystem.
Komma igång
Handboken kräver en fungerande förståelse av följande komponenter i Adobe Experience Platform:
- Källor: Experience Platform tillåter att data hämtas från olika källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med Platform tjänster.
- Sandlådor: Experience Platform innehåller virtuella sandlådor som partitionerar en enda Platform till separata virtuella miljöer för att utveckla och utveckla applikationer för digitala upplevelser.
Följande avsnitt innehåller ytterligare information som du behöver känna till för att kunna ansluta till ett annonssystem med Flow Service API.
Använda plattforms-API:er
Mer information om hur du kan anropa API:er för plattformar finns i handboken komma igång med plattforms-API:er.
Utforska era datatabeller
Med hjälp av basanslutningen för ert annonssystem kan ni utforska era datatabeller genom att utföra GET-förfrågningar. Använd följande anrop för att hitta sökvägen till tabellen som du vill inspektera eller importera till Platform.
API-format
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root
{BASE_CONNECTION_ID}
Begäran
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}'
Svar
Ett framgångsrikt svar är en rad tabeller från ert annonssystem. Hitta den tabell du vill ta med Platform och notera path
-egenskapen, eftersom du måste ange den i nästa steg för att inspektera dess struktur.
[
{
"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 tabellstrukturen
Om du vill inspektera tabellstrukturen från ditt annonssystem utför du en GET-förfrågan och anger tabellens sökväg som en frågeparameter.
API-format
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=table&object={TABLE_PATH}
{BASE_CONNECTION_ID}
{TABLE_PATH}
Begäran
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}'
Svar
Ett lyckat svar returnerar strukturen för en tabell. Information om tabellens kolumner finns i element i columns
array.
{
"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"
}
},
]
}
}
Nästa steg
Genom att följa den här självstudiekursen har du utforskat ditt annonssystem och hittat sökvägen till tabellen du vill ta med i Platformoch fick information om sin struktur. Du kan använda den här informationen i nästa självstudiekurs för att samla in data från ert annonssystem och ta in dem på plattformen.