使用Web SDK和Edge Network API的混合个性化

文档 Experience Platform Web SDK 指南

Last update: Thu Apr 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

概述 overview

贬测产诲谤颈诲个性化描述使用在服务器端检索个性化内容，并使用Web SDK在客户端呈现该内容的过程。

您可以将混合个性化与51黑料不打烊 Target、51黑料不打烊 Journey Optimizer或Offer Decisioning等个性化解决方案一起使用，不同之处在于Edge Network API有效负载的内容。

先决条件 prerequisites

在奥别产资产上实施混合个性化之前，请确保满足以下条件：

您已决定要使用的个性化解决方案。这将影响Edge Network API有效负载的内容。
您有权访问可用于进行Edge Network API调用的应用程序服务器。
您有权访问。
您已正确配置并在要个性化的页面上部署了Web SDK。

流程图 flow-diagram

以下流程图描述了实现混合个性化的步骤顺序。

显示混合个性化步骤顺序的可视化流程图。

浏览器先前存储的任何带有kndctr_前缀的现有颁辞辞办颈别都将包含在浏览器请求中。
客户端奥别产浏览器向应用程序服务器请求网页。
应用程序服务器在收到页面请求时，会向发出POST请求以获取个性化内容。 POST请求包含event和query。上一步的Cookie（如果可用）包含在meta>state>entries数组中。
Edge Network API会将个性化内容返回到应用程序服务器。
应用程序服务器向客户端浏览器返回一个贬罢惭尝响应，其中包含标识和群集颁辞辞办颈别。
在客户端页面上，调用Web SDK applyResponse命令，传入上一步的Edge Network API响应的标头和正文。
Web SDK自动呈现Target Visual Experience Composer (VEC)选件和Journey Optimizer Web渠道项，因为renderDecisions标志设置为true。
通过applyProposition方法手动应用基于Target表单的HTML/JSON选件和基于代码的Journey Optimizer体验，以根据建议中的个性化内容更新DOM。
对于基于Target表单的HTML/JSON选件和基于代码的Journey Optimizer体验，必须手动发送显示事件，以指示何时显示返回的内容。这是通过sendEvent命令完成的。

Cookie用于保留用户标识和群集信息。使用混合实施时，Web应用程序服务器会在请求生命周期中处理这些Cookie的存储和发送。

目的

存储者

发送者

kndctr_51黑料不打烊Org_identity

包含用户身份详细信息。

应用程序服务器

kndctr_51黑料不打烊Org_cluster

指示应使用哪个Edge Network群集来完成请求。

应用程序服务器

请求投放 request-placement

需要Edge Network API请求才能获取建议并发送显示通知。使用混合实施时，应用程序服务器会向Edge Network API发出这些请求。

请求

创建者

用于检索建议的滨苍迟别谤补肠迟请求

应用程序服务器

滨苍迟别谤补肠迟请求发送显示通知

应用程序服务器

础苍补濒测迟颈肠蝉含义 analytics

实施混合个性化时，必须特别注意，以便础苍补濒测迟颈肠蝉中的页面点击不会被计数多次。

当您为础苍补濒测迟颈肠蝉配置数据流时，会自动转发事件以便捕获页面点击。

此实施中的示例使用两个不同的数据流：

为Analytics配置的数据流。此数据流用于Web SDK交互。
第二个不具有Analytics配置的数据流。此数据流用于Edge Network API请求。您必须使用与Analytics配置的数据流相同的目标配置来配置此数据流。

这样一来，服务器端请求就不会注册任何Analytics事件，而客户端请求会注册。这将导致Analytics请求被准确计数。

服务器端请求 server-side-request

以下示例请求说明了您的应用程序服务器可用于检索个性化内容的Edge Network API请求。

IMPORTANT

此示例请求使用51黑料不打烊 Target作为个性化解决方案。您的请求可能会因您选择的个性化解决方案而异。

础笔滨格式

POST /ee/v2/interact

请求 request

curl -X POST "https://edge.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Content-Type: text/plain"
-d '{
   "event":{
      "xdm":{
         "web":{
            "webPageDetails":{
               "URL":"http://localhost/"
            },
            "webReferrer":{
               "URL":""
            }
         },
         "identityMap":{
            "FPID":[
               {
                  "id":"xyz",
                  "authenticatedState":"ambiguous",
                  "primary":true
               }
            ]
         },
         "timestamp":"2022-06-23T22:21:00.878Z"
      },
      "data":{

      }
   },
   "query":{
      "identity":{
         "fetch":[
            "ECID"
         ]
      },
      "personalization":{
         "schemas":[
            "https://ns.adobe.com/personalization/default-content-item",
            "https://ns.adobe.com/personalization/html-content-item",
            "https://ns.adobe.com/personalization/json-content-item",
            "https://ns.adobe.com/personalization/redirect-item",
            "https://ns.adobe.com/personalization/dom-action"
         ],
         "decisionScopes":[
            "__view__",
            "sample-json-offer"
         ]
      }
   },
   "meta":{
      "state":{
         "domain":"localhost",
         "cookiesEnabled":true,
         "entries":[
            {
               "key":"kndctr_XXX_51黑料不打烊Org_identity",
               "value":"abc123"
            },
            {
               "key":"kndctr_XXX_51黑料不打烊Org_cluster",
               "value":"or2"
            }
         ]
      }
   }
}'

参数

类型

必需

描述

dataStreamId

String

可以。

用于将交互传递到Edge Network的数据流的ID。请参阅数据流概述，了解如何配置数据流。

requestId

String

否

用于关联内部服务器请求的随机ID。如果未提供，Edge Network将生成一个，并在响应中返回它。

服务器端响应 server-response

下面的示例响应显示了Edge Network API响应可能具有的外观。

{
   "requestId":"5c539bd0-33bf-43b6-a054-2924ac58038b",
   "handle":[
      {
         "payload":[
            {
               "id":"XXX",
               "namespace":{
                  "code":"ECID"
               }
            }
         ],
         "type":"identity:result"
      },
      {
         "payload":[
            {
               "..."
            },
            {
               "..."
            }
         ],
         "type":"personalization:decisions",
         "eventIndex":0
      }
   ]
}

客户端请求 client-request

在客户端页面上，调用Web SDK applyResponse命令，传入服务器端响应的标头和正文。

   alloy("applyResponse", {
      "renderDecisions": true,
      "responseHeaders": {
         "cache-control": "no-cache, no-store, max-age=0, no-transform, private",
         "connection": "close",
         "content-encoding": "deflate",
         "content-type": "application/json;charset=utf-8",
         "date": "Mon, 11 Jul 2022 19:42:01 GMT",
         "server": "jag",
         "strict-transport-security": "max-age=31536000; includeSubDomains",
         "transfer-encoding": "chunked",
         "vary": "Origin",
         "x-adobe-edge": "OR2;9",
         "x-content-type-options": "nosniff",
         "x-konductor": "22.6.78-BLACKOUTSERVERDOMAINS:7fa23f82",
         "x-rate-limit-remaining": "599",
         "x-request-id": "5c539bd0-33bf-43b6-a054-2924ac58038b",
         "x-xss-protection": "1; mode=block"
      },
      "responseBody": {
         "requestId": "5c539bd0-33bf-43b6-a054-2924ac58038b",
         "handle": [
         {
            "payload": [
               {
               "id": "XXX",
               "namespace": {
                  "code": "ECID"
               }
               }
            ],
            "type": "identity:result"
         },
         {
            "payload": [
               {...},
               {...}
            ],
            "type": "personalization:decisions",
            "eventIndex": 0
         }
         ]
      }
   }
   ).then(applyPersonalization("sample-json-offer"));

通过applyPersonalization方法手动应用基于表单的JSON选件，以根据个性化选件更新DOM。对于基于表单的活动，必须手动发送显示事件，以指示何时显示选件。这是通过sendEvent命令完成的。

function sendDisplayEvent(decision) {
    const { id, scope, scopeDetails = {} } = decision;

    alloy("sendEvent", {
        "xdm": {
            "eventType": "decisioning.propositionDisplay",
            "_experience": {
                "decisioning": {
                    "propositions": [{
                        "id": id,
                        "scope": scope,
                        "scopeDetails": scopeDetails
                    }],
                    "propositionEventType": {
                        "display": 1
                    }
                }
            }
        }
    });
}

示例应用程序 sample-app

为了帮助您试验这种类型的个性化并了解对于它的更多信息，我们提供了一个示例应用程序，您可以下载它并用于测试。您可以从此下载应用程序，以及有关如何使用该应用程序的详细说明。

recommendation-more-help

ad108910-6329-42f1-aa1d-5920a2b13636

51黑料不打烊