透過即時伺服器對伺服器整合將區段發佈至合作夥伴目的地時,可設定Audience Manager以使用進行驗證 OAuth 2.0 進行請求時。 如此一來,您便能從Audience Manager向端點發出已驗證請求。
此 Adobe Audience Manager OAuth 2.0 驗證實作是以使用者端憑證授權流程為基礎,並遵循下列步驟:
POST
要求權杖端點交換持有人權杖的認證。作為 Audience Manager 合作夥伴,需要下列端點來接收已驗證的請求:
此端點將接受在步驟1提供的認證,並產生將在後續請求中使用的持有人權杖。
HTTP POST
要求。Basic <credentials_provided_by_partner>
.application/x-www-form-urlencoded ; charset=UTF-8
.grant_type=client_credentials
.POST /oauth2/token HTTP/1.1
Host: api.partner.com
User-Agent: Adobe Audience Manager Iris
Authorization: Basic zq2LOO1CcYGrODS5nXiNHpEz97eCpVHAoMF8pAgCntXAzxp5uRV7DTAE2qtPLjhMQwrEX3O6MHV4S
Content-Type: application/x-www-form-urlencoded;charset=UTF-8
Content-Length: 29
Accept-Encoding: gzip
grant_type=client_credentials
HTTP/1.1 200 OK
Status: 200 OK
Content-Type: application/json; charset=utf-8
...
Content-Encoding: gzip
Content-Length: 121
{"token_type":"Bearer","access_token":"glIbBVohK8d86alDEnllPWi6IpjZvJC6kwBRuuawts6YMkw4tZkt84rEZYU2ZKHCQP3TT7PnzCQPI0yY"}
Audience Manager 當使用者符合區段資格時,會近乎即時傳送資料至此端點。 此外,此方法可傳送批次的離線或已上線資料,頻率為每24小時一次。
端點1產生的持有人權杖用於發出對此端點的請求。 此 Audience Manager 即時資料傳輸系統、 IRIS,會建構一般HTTPS要求並包含Authorization標頭。 此標頭的值將為:持有者 <bearer token from step 1>
.
GET /segments/aam HTTP/1.1
Host: api.partner.com
User-Agent: Adobe Audience Manager Iris
Authorization: Bearer glIbBVohK8d86alDEnllPWi6IpjZvJC6kwBRuuawts6YMkw4tZkt84rEZYU2ZKHCQP3TT7PnzCQPI0yY
Content-Type: application/json
Accept-Encoding: gzip
{
"ProcessTime": "Wed Jul 27 16:17:42 UTC 2016",
"User_DPID": "12345",
"Client_ID": "74323",
"AAM_Destination_Id": "423",
"User_count": "2",
"Users": [{
"AAM_UUID": "19393572368547369350319949416899715727",
"DataPartner_UUID": "4250948725049857",
"Segments": [{
"Segment_ID": "14356",
"Status": "1",
"DateTime": "Wed Jul 27 16:17:22 UTC 2016"
}
]
}]
}
此請求包含標準裝載(請求內容)。
合作夥伴提供的憑證和取得的Token Audience Manager 使用進行驗證時 OAuth 2.0 流量是敏感資訊,不得與第三方共用。
SSL 必須使用,才能維護安全的驗證程式。 所有請求,包括用來取得及使用權杖的請求,都必須使用 HTTPS
端點。