擷取設定檔

可透過三種方式擷取Target設定檔：使用Experience Cloud Visitor ID (ECID)、tntid或thirdPartyId。

使用Experience Cloud Visitor ID (ECID)

您可以根據ECID擷取設定檔。 HTTP方法必須GET。

URL看起來像下面的範例：

https://<clientCode>.tt.omtrdc.net/rest/v1/profiles/marketingCloudVisitorId/<ECID>?client=<clientCode>

將<clientCode>取代為您的Target Client Code，並將<ECID>取代為您的Experience Cloud Visitor ID (Marketing Cloud Visitor ID)。

使用tntid

Target會自動為每個請求指派tntid。

下列範例顯示使用tntid擷取設定檔的要求格式：

https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/your-tnt-id?client=<your-client-code>

取代<your-client-code>和your-tnt-id並引發GET要求。 以下是使用tntid的設定檔擷取呼叫範例：

https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/111492025094307-353046?client=<your-client-code>

使用thirdPartyId

Adobe Target設定檔可使用您自己的識別碼來擴充（例如： CRM ID、uuid、會員編號等）。

請參閱更新設定檔以瞭解如何將thirdPartyId附加至您的設定檔。

下列範例顯示使用thirdPartyId擷取設定檔的要求格式：

https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/thirdPartyId/your-thirdpartyid?client=<your-client-code>

取代<your-client-code>和your-thirdpartyid並引發GET要求。 以下是使用thirdpartyid的設定檔擷取呼叫範例：

https://<your-client-code>.tt.omtrdc.net/rest/v1/profiles/thirdPartyId/a1-mbox3rdPartyId?client=<your-client-code>

進行此呼叫時，Target會先嘗試在邊緣要求中所述的叢集中找出設定檔，或找出設定檔所在的位置，然後傳回內容。 設定檔內容會以JSON格式傳回。

驗證

從Target UI開啟驗證即可保護Target Profile API，如下所述。 開啟驗證後，所有設定檔API請求必須在請求標頭中設定設定檔驗證Token。 權杖本身可以使用Target UI或上述設定檔驗證Token區段中說明的步驟來產生。

測光

這些呼叫不會計入您的mbox呼叫。

錯誤處理

若是呼叫/thirdPartyId，但指定了無效或過期的thirdPartyId：

{"status" : 404, "message" : "No profile found for client <client_code> with third party id=<third_party_id>"}

如果設定檔找不到或已過期：

{"status" : 404, "message" : "No profile found for client <client_code> with mboxPC=<mbox_pc>"}