文档Experience PlatformWeb SDK 指南

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

Last update: Mon Aug 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员

概述 overview

Hybdrid个性化描述使用Edge Network服务器API检索个性化内容服务器端，并使用Web SDK在客户端呈现该内容的过程。

您可以将混合个性化与Adobe Target、Adobe Journey Optimizer或Offer Decisioning等个性化解决方案一起使用，不同之处在于服务器API有效负载的内容。

先决条件 prerequisites

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

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

流程图 flow-diagram

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

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

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

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

Cookie
目的
存储者
发送者
kndctr_AdobeOrg_identity
包含用户身份详细信息。
应用程序服务器
应用程序服务器
kndctr_AdobeOrg_cluster
指示应使用哪个Edge Network群集来完成请求。
应用程序服务器
应用程序服务器

请求投放 request-placement

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

请求
创建者
用于检索建议的Interact请求
应用程序服务器
Interact请求发送显示通知
应用程序服务器

Analytics含义 analytics

实施混合个性化时，必须特别注意，以便Analytics中的页面点击不会被计数多次。

当您为Analytics配置数据流时，会自动转发事件以便捕获页面点击。

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

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

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

服务器端请求 server-side-request

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

IMPORTANT
此示例请求使用Adobe Target作为个性化解决方案。 您的请求可能会因您选择的个性化解决方案而异。

API格式

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_AdobeOrg_identity",
               "value":"abc123"
            },
            {
               "key":"kndctr_XXX_AdobeOrg_cluster",
               "value":"or2"
            }
         ]
      }
   }
}'
参数
类型
必需
描述
dataStreamId
String
可以。
用于将交互传递给Edge Network的数据流的ID。 请参阅数据流概述，了解如何配置数据流。
requestId
String
否
用于关联内部服务器请求的随机ID。 如果未提供任何内容，则Edge Network将生成一个，并在响应中返回该值。

服务器端响应 server-response

下面的示例响应显示了服务器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

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

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636