지원되는 기능 개요

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 테스트

예

자동 할당

아니오

자동 타깃팅

아니오

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 활동에 대해 지연 시간이 거의 0에 가깝도록 유지하려면 getOffers 호출에서 지역 값을 직접 제공하는 것이 좋습니다. 요청의 Context에서 Geo 개체를 설정하여 이 작업을 수행합니다. 즉, 서버에서 각 최종 사용자의 위치를 확인하는 방법이 필요합니다. 예를 들어 서버는 사용자가 구성하는 서비스를 사용하여 IP-to-Geo 조회를 수행할 수 있습니다. 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-to-Geo 조회를 수행할 수 없지만 지역 기반 대상이 포함된 getOffers개의 요청에 대해 on-device decisioning을(를) 수행하려는 경우 이 기능도 지원됩니다. 이 방법은 원격 IP-to-Geo 조회를 사용하여 각 getOffers 호출에 지연을 추가한다는 단점이 있습니다. 서버 근처에 있는 CDN에 도달하므로 이 대기 시간은 원격 getOffers 호출보다 짧아야 합니다. SDK가 사용자 IP 주소의 지리적 위치를 검색하려면 요청의 Context에 있는 Geo 개체에 있는 ipAddress 필드만 제공해야 합니다. 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