Marketing Cloud 訪客 ID
marketingCloudVisitorId是通用的永久ID，可識別Experience Cloud中所有解決方案的訪客。 當您的組織實作ID服務時，此ID可讓您在不同的Experience Cloud解決方案(如Adobe Target、Adobe Analytics或Adobe Audience Manager)中識別相同的網站訪客及其資料。 請注意，當運用並與Analytics和Audience Manager整合時，需要marketingCloudVisitorId。
curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=10abf6304b2714215b1fd39a870f01afc#1555632114' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '{
"id": {
"marketingCloudVisitorId": "10527837386392355901041112038610706884"
},
"context": {
"channel": "web",
"browser" : {
"host" : "demo"
},
"address" : {
"url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
},
"screen" : {
"width" : 1200,
"height": 1400
}
},
"execute": {
"mboxes" : [
{
"name" : "SummerOffer",
"index" : 1
}
]
}
}'
上述範例呼叫示範如何將從Experience CloudID服務擷取的marketingCloudVisitorId傳遞至Adobe Target。 在此案例中，Target會產生tntId，因為它未傳入原始呼叫，而原始呼叫將會對應到提供的marketingCloudVisitorId，如下面的回應所示。
第三方ID
如果您的組織使用ID來識別訪客，您可以使用thirdPartyID來傳遞內容。 不過，您必須為每Adobe Target Delivery API次呼叫提供thirdPartyID。
curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=10abf6304b2714215b1fd39a870f01afc#1555632114' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '{
"id": {
"thirdPartyId": "B234A029348"
},
"context": {
"channel": "web",
"browser" : {
"host" : "demo"
},
"address" : {
"url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
},
"screen" : {
"width" : 1200,
"height": 1400
}
},
"execute": {
"mboxes" : [
{
"name" : "SummerOffer",
"index" : 1
}
]
}
}'
上述呼叫範例顯示thirdPartyId，這是您企業用來識別一般使用者的永久ID，無論他們是否透過Web、行動裝置或IoT管道與您的企業互動。 換言之，thirdPartyId將參照可在不同管道間使用的使用者設定檔資料。 在此案例中，Target會產生tntId，因為它未傳入原始呼叫，而將會對應到提供的thirdPartyId，如下面的回應所示。
{
"status": 200,
"requestId": "55de9886-bd14-4dee-819c-7d1633b79b90",
"client": "demo",
"id": {
"tntId": "10abf6304b2714215b1fd39a870f01afc.28_20",
"thirdPartyId": "B234A029348"
},
"edgeHost": "mboxedge28.tt.omtrdc.net",
...
}
Customer ID
可以新增客戶ID，並將其與Experience Cloud的訪客ID建立關聯。 每當您傳送customerIds時，也必須提供marketingCloudVisitorId。 此外，可以為每個訪客提供驗證狀態，以及每個customerId。 可考慮的驗證狀態如下：
| 驗證狀態 | 使用者狀態 |
|---|---|
unknown | 未知或從未驗證。 此狀態適用於訪客按一下顯示廣告而登陸您的網站等情況。 |
authenticated | 使用者目前是以您網站或應用程式上使用中的工作階段驗證。 |
logged_out | 使用者通過驗證，但主動登出。使用者有意且確定中斷驗證狀態的連結。使用者不希望具有驗證身分。 |
請注意，只有當客戶ID處於authenticated狀態時，Target才會參考已儲存並連結至客戶ID的使用者設定檔資料。 如果客戶ID處於unknown或logged_out狀態，將忽略客戶ID，並且不會將任何可能與其相關聯的使用者設定檔資料用於對象定位。
curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=d359234570e044f14e1faeeba02d6ab23439914e' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '{
"context": {
"channel": "web",
"browser" : {
"host" : "demo"
},
"address" : {
"url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
},
"screen" : {
"width" : 1200,
"height": 1400
}
},
"id": {
"marketingCloudVisitorId" : "2304820394812039",
"customerIds": [{
"id": "134325423",
"integrationCode" : "crm_data",
"authenticatedState" : "authenticated"
}]
},
"property" : {
"token": "08b62abd-c3e7-dfb2-da93-96b3aa724d81"
},
"execute": {
"mboxes" : [
{
"name" : "homepage",
"index" : 1
}
]
}
}'
上述呼叫範例示範如何傳送含有authenticatedState的customerId。 傳送customerId時，需要integrationCode、id、authenticatedState以及marketingCloudVisitorId。 integrationCode是您透過CRS提供的客戶屬性檔案的別名。