在Adobe Pass身份验证中使用Experience Cloud ID

什么是Experience Cloud ID以及如何获取它？ what-exp-cloud-id-obtain

Experience Cloud ID（简称ECID）是Adobe Experience Cloud为您应用程序/网站中的每个用户生成的唯一ID。 ECID在所有Experience Cloud报表中大量使用，这些报表用于链接多个应用程序/网站中特定用户的相关信息。

如果您已具有提供访客ID的系统，则应该对此文档的范围使用同一ID。

获取ECID的一种方法是使用Experience Cloud ID服务。 您可以使用基于TDM、JS库、服务器端、直接集成或移动设备平台本机库的首选实施类型。 要全面了解可用的服务、库、SDK和实施指南，请参阅：https://experienceleague.adobe.com/docs/id-service/using/implementation/implementation-guides.html?lang=zh-Hans

在Adobe Pass身份验证中使用Experience Cloud ID有何好处？ benefit-ex-cloud-id

如果您配置我们的SDK和无客户端REST API以使用您的ECID，您以后可以将Adobe Pass身份验证收集的数据链接到您现有的Experience Cloud解决方案中。 这样，您就可以更好地了解客户在Adobe提供的所有解决方案中的历程和体验。

如何在Adobe Pass身份验证中使用Experience Cloud ID？ how-to-ex-cloud-id-authn

在获得ECID（如上所述）后，您需要将这些信息传递到我们的SDK和无客户端REST API。 此信息稍后将在SDK进行的每次网络调用中传递到我们的服务器。 每个SDK的配置过程各不相同，如下所示：

JS SDK js-sdk

对于JavaScript，您需要将ECID作为第三个参数传递到setRequestor调用。

用法示例：

accessEnabler.setRequestor("REQUESTOR_ID", ["ENDPOINT_URL"],
    {
        "visitorID": "THE_ECID_VALUE"
    }
);

iOS/tvOS SDK ios-sdk

对于iOS/tvOS SDK，有一个名为setOptions的专用方法。

用法示例：

accessEnabler.setOptions(
    [
        "visitorID": "THE_ECID_VALUE"
    ]
);

Android/fireTV SDK android-sdk

对于Android/fireTV SDK，该机制类似于iOS。 只是参数名称不同。 此处记录了API。

用法示例：

String visitor_id = "THE_ECID_VALUE";

HashMap<String, String> options = new HashMap();
options.put("ap_vi",visitor_id);

accessEnabler.setOptions(options);

无客户端API clientless-api

通过其REST API v1使用Adobe Pass时，应在所有API 上将 ECID 值作为名为'ap_vi'的参数发送。

用法示例：

GET: https://api.auth.adobe.com/api/v1/authorize?...&ap_vi=THE_ECID_VALUE

REST API V2 rest-api-v2

通过其REST API v2使用Adobe Pass时，ECID ​值应在所有API 上作为名为'AP-Visitor-Identifier'的标头发送。

用法示例：

POST: https://api.auth.adobe.com/api/v2/${serviceProvider}/sessions/
标头：
AP-Visitor-Identifier: THE_ECID_VALUE