支持的功能概述

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
APIs/SDKs

创建对象：

开发人员

Adobe Target的服务器端SDK使开发人员能够灵活地在数据的性能和新鲜度之间进行选择，以便做出决策。换言之，如果通过机器学习提供最相关且最引人入胜的个性化内容对您来说最重要，则应进行实时服务器调用。但是，当性能更为关键时，则应该做出设备上决策。要使on-device decisioning正常工作，请参阅以下支持的功能列表：

活动类型
受众定位
分配方法

活动类型

下表指明了on-device decisioning支持或不支持使用基于表单的体验编辑器创建的活动类型。

活动类型

受支持

A/B 测试

是

自动分配

否

Auto-Target（自动定位）

否

Analytics for Target (A4T)

是

多变量测试 (MVT)

否

体验定位 (XT)

是

Automated Personalization (AP)

否

受众定位

下表指示哪些受众规则受on-device decisioning支持或不受支持。

受众规则

设备上决策

是

否

否

是

是

是

是

否

否

是

Experience Cloud受众(来自Adobe Audience Manager、Adobe Analytics和Adobe Experience Manager的受众)

否

on-device decisioning的地理定位

为了对具有基于地理位置的Adobe的on-device decisioning活动保持近零延迟，Audience建议您在对getOffers的调用中自己提供地理值。为此，请在请求的Context中设置Geo对象。这意味着您的服务器将需要一种方法来确定每个最终用户的位置。例如，您的服务器可能会使用您配置的服务执行IP到地理位置的查找。某些托管提供商(如Google Cloud)通过每个HttpServletRequest中的自定义标头提供此功能。

Node.js

code language-csharp line-numbers

code language-csharp line-numbers
`const CONFIG = { client: "acmeclient", organizationId: "1234567890@AdobeOrg", decisioningMethod: "on-device" }; const targetClient = TargetClient.create(CONFIG); targetClient.getOffers({ request: { context: { geo: { city: "SAN FRANCISCO", countryCode: "US", stateCode: "CA", latitude: 37.75, longitude: -122.4 } }, execute: { pageLoad: {} } } })`

const CONFIG = {
    client: "acmeclient",
    organizationId: "1234567890@AdobeOrg",
    decisioningMethod: "on-device"
};

const targetClient = TargetClient.create(CONFIG);

targetClient.getOffers({
    request: {
        context: {
            geo: {
                city: "SAN FRANCISCO",
                countryCode: "US",
                stateCode: "CA",
                latitude: 37.75,
                longitude: -122.4
            }
        },
        execute: {
            pageLoad: {}
        }
    }
})

Java

code language-javascript line-numbers

code language-javascript line-numbers
`public class TargetRequestUtils { public static Context getContext(HttpServletRequest request) { Context context = new Context() .geo(ipToGeoLookup(request.getRemoteAddr())) .channel(ChannelType.WEB) .timeOffsetInMinutes(330.0) .address(getAddress(request)); return context; } public static Geo ipToGeoLookup(String ip) { GeoResult geoResult = geoLookupService.lookup(ip); return new Geo() .city(geoResult.getCity()) .stateCode(geoResult.getStateCode()) .countryCode(geoResult.getCountryCode()); } }`

public class TargetRequestUtils {

    public static Context getContext(HttpServletRequest request) {
        Context context = new Context()
            .geo(ipToGeoLookup(request.getRemoteAddr()))
            .channel(ChannelType.WEB)
            .timeOffsetInMinutes(330.0)
            .address(getAddress(request));
        return context;
    }

    public static Geo ipToGeoLookup(String ip) {
        GeoResult geoResult = geoLookupService.lookup(ip);
        return new Geo()
            .city(geoResult.getCity())
            .stateCode(geoResult.getStateCode())
            .countryCode(geoResult.getCountryCode());
    }

}

但是，如果您无法在服务器上执行IP到地理位置的查找，但仍希望对包含基于地理位置的受众的getOffers请求执行on-device decisioning，则也支持此操作。此方法的缺点是，它将使用远程IP到地理位置的查找，这将为每个getOffers调用添加延迟。此延迟应低于远程getOffers调用，因为它点击了位于服务器附近的CDN。您必须在请求的Context的Geo对象中仅提供ipAddress字段，以便SDK检索用户IP地址的地理位置。如果除了ipAddress之外还提供了任何其他字段，则Target SDK将不会获取地理位置元数据以进行解析。

Node.js

code language-csharp line-numbers

code language-csharp line-numbers
`const CONFIG = { client: "acmeclient", organizationId: "1234567890@AdobeOrg", decisioningMethod: "on-device" }; const targetClient = TargetClient.create(CONFIG); targetClient.getOffers({ request: { context: { geo: { ipAddress: "127.0.0.1" } }, execute: { pageLoad: {} } } })`

const CONFIG = {
    client: "acmeclient",
    organizationId: "1234567890@AdobeOrg",
    decisioningMethod: "on-device"
};

const targetClient = TargetClient.create(CONFIG);

targetClient.getOffers({
    request: {
        context: {
            geo: {
                ipAddress: "127.0.0.1"
            }
        },
        execute: {
            pageLoad: {}
        }
    }
})

Java

code language-javascript line-numbers

code language-javascript line-numbers
`public class TargetRequestUtils { public static Context getContext(HttpServletRequest request) { Context context = new Context() .geo(new Geo().ipAddress(request.getRemoteAddr())) .channel(ChannelType.WEB) .timeOffsetInMinutes(330.0) .address(getAddress(request)); return context; } }`

public class TargetRequestUtils {

    public static Context getContext(HttpServletRequest request) {
        Context context = new Context()
            .geo(new Geo().ipAddress(request.getRemoteAddr()))
            .channel(ChannelType.WEB)
            .timeOffsetInMinutes(330.0)
            .address(getAddress(request));
        return context;
    }

}

分配方法

下表指示on-device decisioning支持或不支持哪些分配方法。

分配方法

受支持

手动

是

自动分配到最佳体验

否

自动定位以提供个性化体验

否

recommendation-more-help

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