必讀

技術需求

  • Adobe Campaign API只能使用伺服器對伺服器。
  • 如果您要實作的使用案例與Adobe Campaign API允許的比例相符,請務必洽詢您的Adobe技術聯絡人。
  • 設定AdobeIO存取需要特定權限,如有任何問題,請聯絡Adobe支援。

權限與存取

  • 依預設,Adobe Campaign API會使用管理員內容,因此組織單位和角色不適用。
  • Adobe Campaign API會從角色內容中排除。
  • 如果您想要以組織單位或角色來設定API,請先洽詢您的Adobe技術聯絡人。

資源表示

所有API資源皆可在 JSON 具有URL副檔名或位於HTTP Accept Header內:

GET /profileAndServices/<resourceName>.json

注意

若URL中沒有副檔名, json格式為預設格式 (針對內容類型)。


請求範例

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile.json \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

主要索引鍵和URL

  • 請勿自行建立URL。 API會傳回所有URL。 不過,您可以根據頂層資源名稱來建立URL。

  • 說明示例的自動主鍵(PKey)值不打算在其他特定部署中工作。 由Adobe Campaign API製作。

  • Adobe Campaign產生的自動主索引鍵值絕不得儲存至外部資料庫或網站。 您必須在資料庫定義中產生特定索引鍵欄位,並在開發期間使用它。

自訂金鑰

如果設定檔資源已使用自訂金鑰欄位擴充,您可以將此欄位作為金鑰,而非Adobe Campaign產生的自動主金鑰:

GET /.../profileAndServicesExt/profile/<customKey>

如果鍵值與原始鍵不同,或者您使用自己的業務鍵作為URI,而不是PATCH提供的業務鍵,則無法使用Adobe操作修改自定義鍵。

使用自訂金鑰 頂層設定檔資源 只有。 URL由API傳回,且絕不應由您自己建立。


範例要求

若要使用自訂金鑰擷取設定檔的訂閱,請對自訂金鑰執行GET作業。

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/<customKey> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

對傳回的訂閱URL執行GET要求。

-X GET <SUBSCRIPTION_URL> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

它會傳回設定檔的訂閱清單。

"service": {
"PKey": "<PKEY>",
"href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>",
"label": "Sport Newsletter",
"name": "SVC1",
"title": "Sport Newsletter (SVC1)"
}

本頁內容