识别访客

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
APIs/SDKs

创建对象：

开发人员

在Adobe Target中，可通过多种方法来识别访客。

Target使用三个标识符：

字段名称

描述

tntId

tntId是用户Target中的主要标识符。您可以提供此ID，否则Target将在请求中不包含此ID时自动生成此ID。

thirdPartyId

thirdPartyId是您公司的用户标识符，您可在每次调用时发送该标识符。当用户登录到某个公司的网站时，该公司通常会创建一个ID，并将其绑定到访客的帐户、会员卡、会员编号或该公司的其他适用标识符。

marketingCloudVisitorId

marketingCloudVisitorId用于在不同Adobe解决方案之间合并和共享数据。要与Adobe Analytics和Adobe Audience Manager集成，需要marketingCloudVisitorId。

customerIds

除了Experience Cloud访客ID之外，还可以使用其他客户ID以及每个访客的身份验证状态。

Target ID

Target ID或tntId可视为设备ID。如果未在请求中提供，此tntId将由Target自动生成。此后，后续请求需要包括此tntId，以便将正确内容交付给用户使用的设备。

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 '{
  "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
      }
    ]
  }
}'

以上示例调用表明tntId不需要传入。在此方案中，Target生成一个tntId并在响应中提供它，如下所示：

{
  "status": 200,
  "requestId": "5b586f83-890c-46ae-93a2-610b1caa43ef",
  "client": "demo",
  "id": {
      "tntId": "10abf6304b2714215b1fd39a870f01afc.28_20"
  },
  "edgeHost": "mboxedge28.tt.omtrdc.net",
  ...
}

生成的tntId是10abf6304b2714215b1fd39a870f01afc.28_20。请注意，在跨会话为同一用户调用Adobe Target Delivery API时，需要使用此tntId。

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、移动或物联网渠道与您的企业进行交互。换句话说，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提供的客户属性文件的别名。

合并的配置文件

您可以在同一请求中合并tntId、thirdPartyID和marketingCloudVisitorId。在此方案中，Adobe Target将维护所有这些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",
        "tntId": "d359234570e044f14e1faeeba02d6ab23439914e.28_78",
        "thirdPartyId":"23423432"
      },
      "property" : {
        "token": "08b62abd-c3e7-dfb2-da93-96b3aa724d81"
      },
      "experienceCloud": {
        "analytics": {
          "supplementalDataId" : "23423498732598234",
          "trackingServer": "ags041.sc.omtrdc.net",
          "logging": "server_side"
        }
      },
        "execute": {
        "mboxes" : [
          {
            "name" : "homepage",
            "index" : 1
          }
        ]
      }
    }'

以上示例调用演示了如何在同一个请求中组合tntId、thirdPartyID和marketingCloudVisitorId。响应中还会返回所有三个ID。

recommendation-more-help

6906415f-169c-422b-89d3-7118e147c4e3