[Alpha]{class="badge informative"}

appendIdentityToUrl （伺服器SDK）

此頁面說明伺服器SDK appendIdentityToUrl方法。 若為Web SDK，請參閱appendIdentityToUrl.

appendIdentityToUrl方法會將訪客的身分新增至URL，做為名為adobe_mc的查詢字串引數。 當訪客追蹤URL至您擁有的其他網域時，該網域上的Web SDK或伺服器SDK會讀取引數並保留相同的Experience Cloud ID (ECID)。 如此可防止在包含兩個網域的資料集中將訪客計算兩次。

在伺服器上，常見的用法是新增訪客的身分識別，以重新導向至另一個網域：

const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });

const { url } = await visitor.appendIdentityToUrl({
  url: "https://shop.example.net/checkout"
});

res.writeHead(302, { Location: url });
res.end();

產生的URL看起來類似下列：

https://shop.example.net/checkout?adobe_mc=TS%3D1792711449%7CMCMID%3D34567890123456789012345678901234567890%7CMCORGID%3DADB3LETTERSANDNUMBERS%2540AdobeOrg

如果SDK還沒有訪客的ECID，會先向Edge Network要求。 該請求未經過驗證。 請參閱設定資料流存取型別。

如果訪客選擇退出，或defaultConsent為"out"且訪客未選擇加入，則方法會傳回URL未變更。 如果無法取得訪客的身分（例如因為網路錯誤），也會傳回未變更的URL，而非拒絕。 當偵錯開啟時，SDK會記錄包含Unable to append identity to url的警告。

選項 options

appendIdentityToUrl方法接受具有下列屬性的物件：

結果物件 result

appendIdentityToUrl方法傳回Promise。 解析時，結果物件包含​url，已新增包含adobe_mc查詢字串引數的URL。