2.3.6目标SDK

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

设置您的Adobe I/O项目

在本练习中，您将再次使用Adobe I/O来查询Adobe Experience Platform的API。如果尚未配置Adobe I/O项目，请返回模块2.1🔗中的练习3，然后按照其中的说明操作。

IMPORTANT

如果您是Adobe员工，请按照此处的说明使用PostBuster。

对Adobe I/O的身份验证

在本练习中，您将再次使用Postman来查询Adobe Experience Platform的API。如果尚未配置Postman应用程序，请返回模块2.1🔗中的练习3，然后按照其中的说明操作。

IMPORTANT

如果您是Adobe员工，请按照此处的说明使用PostBuster。

定义端点和格式

在本练习中，您将需要端点来配置，以便在受众符合条件时，资格事件可以流式传输到该端点。在本练习中，您将使用https://pipedream.com/requestbin的示例终结点。转到https://pipedream.com/requestbin，创建一个帐户，然后创建一个工作区。创建工作区后，您将看到类似以下的内容。

单击复制复制URL。您需要在下一个练习中指定此URL。此示例中的URL是https://eodts05snjmjz67.m.pipedream.net。

数据获取

至于格式，我们将使用标准模板，该模板将流传输受众资格或取消资格与客户标识符等元数据。可以自定义模板以满足特定端点的期望，但在本练习中，我们将重用标准模板，这将产生类似于这样的有效负荷，并将其流式传输到端点。

{
  "profiles": [
    {
      "identities": [
        {
          "type": "ecid",
          "id": "64626768309422151580190219823409897678"
        }
      ],
      "AdobeExperiencePlatformSegments": {
        "add": [
          "f58c723c-f1e5-40dd-8c79-7bb4ab47f041"
        ],
        "remove": []
      }
    }
  ]
}

创建服务器和模板配置

在Adobe Experience Platform中创建自己的目标的第一步是使用Postman创建服务器和模板配置。

为此，请打开您的Postman应用程序并转到 目标创作API、目标服务器和模板，然后单击以打开请求 POST — 创建目标服务器配置。

NOTE

如果您没有该Postman收藏集，请返回模块2.1🔗中的练习3，并按照其中的说明设置Postman和提供的Postman收藏集。

你会看到这个。在 Headers 下，您需要手动更新键 x-sandbox-name 的值并将其设置为--aepSandboxName--。选择值 {{SANDBOX_NAME}}。

数据获取

用--aepSandboxName--替换它。

数据获取

接下来，转到正文。选择占位符 {{body}}。

数据获取

您现在需要使用以下代码替换占位符 {{body}}：

{
    "name": "Custom HTTP Destination",
    "destinationServerType": "URL_BASED",
    "urlBasedDestination": {
        "url": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "yourURL"
        }
    },
    "httpTemplate": {
        "httpMethod": "POST",
        "requestBody": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{\n    \"profiles\": [\n    {%- for profile in input.profiles %}\n        {\n            \"identities\": [\n            {%- for idMapEntry in profile.identityMap -%}\n            {%- set namespace = idMapEntry.key -%}\n                {%- for identity in idMapEntry.value %}\n                {\n                    \"type\": \"{{ namespace }}\",\n                    \"id\": \"{{ identity.id }}\"\n                }{%- if not loop.last -%},{%- endif -%}\n                {%- endfor -%}{%- if not loop.last -%},{%- endif -%}\n            {% endfor %}\n            ],\n            \"AdobeExperiencePlatformSegments\": {\n                \"add\": [\n                {%- for segment in profile.segmentMembership.ups | added %}\n                    \"{{ segment.key }}\"{%- if not loop.last -%},{%- endif -%}\n                {% endfor %}\n                ],\n                \"remove\": [\n                {#- Alternative syntax for filtering segments by status: -#}\n                {% for segment in removedSegments(profile.segmentMembership.ups) %}\n                    \"{{ segment.key }}\"{%- if not loop.last -%},{%- endif -%}\n                {% endfor %}\n                ]\n            }\n        }{%- if not loop.last -%},{%- endif -%}\n    {% endfor %}\n    ]\n}"
        },
        "contentType": "application/json"
    }
}

粘贴上述代码后，您需要手动更新字段 urlBasedDestination.url.value，并且需要将其设置为您在上一步中创建的webhook的URL，在本例中为https://eodts05snjmjz67.m.pipedream.net。

数据获取

更新字段 urlBasedDestination.url.value 后，它应该如下所示。单击发送。

数据获取

NOTE

请不要忘记，在向Adobe I/O发送请求之前，您需要具有有效的access_token。要获得有效的access_token，请运行请求 Adobe IO - OAuth 集合中的 POST — 获取访问令牌。

单击发送后，将创建您的服务器模板，作为响应的一部分，您将看到名为 instanceId 的字段。请记下它，因为您将在下一步中需要它。在此示例中，instanceId 为
52482c90-8a1e-42fc-b729-7f0252e5cebd。

数据获取

创建目标配置

在Postman中的 目标创作API 下，转到 目标配置 并单击以打开请求 POST — 创建目标配置。你会看到这个。在 Headers 下，您需要手动更新键 x-sandbox-name 的值并将其设置为--aepSandboxName--。选择值 {{SANDBOX_NAME}} 并将其替换为--aepSandboxName--。

数据获取

接下来，转到正文。选择占位符 {{body}}。

数据获取

您现在需要使用以下代码替换占位符 {{body}}：

{
    "name": "--aepUserLdap-- - Webhook",
    "description": "Exports segment qualifications and identities to a custom webhook via Destination SDK.",
    "status": "TEST",
    "customerAuthenticationConfigurations": [
        {
            "authType": "BEARER"
        }
    ],
    "customerDataFields": [
        {
            "name": "endpointsInstance",
            "type": "string",
            "title": "Select Endpoint",
            "description": "We could manage several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
            "isRequired": true,
            "enum": [
                "US",
                "EU",
                "APAC",
                "NZ"
            ]
        }
    ],
    "uiAttributes": {
        "documentationLink": "https://experienceleague.adobe.com/docs/experience-platform/destinations/home.html?lang=zh-Hans",
        "category": "streaming",
        "connectionType": "Server-to-server",
        "frequency": "Streaming"
    },
    "identityNamespaces": {
        "ecid": {
            "acceptsAttributes": true,
            "acceptsCustomNamespaces": false
        }
    },
    "segmentMappingConfig": {
        "mapExperiencePlatformSegmentName": true,
        "mapExperiencePlatformSegmentId": true,
        "mapUserInput": false
    },
    "aggregation": {
        "aggregationType": "BEST_EFFORT",
        "bestEffortAggregation": {
            "maxUsersPerRequest": "1000",
            "splitUserById": false
        }
    },
    "schemaConfig": {
        "profileRequired": false,
        "segmentRequired": true,
        "identityRequired": true
    },
    "destinationDelivery": [
        {
            "authenticationRule": "NONE",
            "destinationServerId": "yourTemplateInstanceID"
        }
    ]
}

数据获取

粘贴上述代码后，您需要手动更新 destinationDelivery字段。 destinationServerId，并且需要将其设置为在上一步中创建的目标服务器模板的 instanceId，在本例中为52482c90-8a1e-42fc-b729-7f0252e5cebd。接下来，单击发送。

数据获取