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，請執行要求 POST — 取得集合 Adobe IO - OAuth 中的存取權杖。

按一下傳送之後，將會建立您的伺服器範本，而在回應中，您會看到名為 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-Hant",
        "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。接著，按一下傳送。

資料擷取