[Alpha]{class="badge informative"}

서버 SDK 구성

이 페이지에서는 서버 SDK을 구성하는 방법을 설명합니다. 웹 SDK에 대해서는 웹 SDK 구성.​을 참조하십시오.

configure 메서드로 Server SDK을 구성합니다. 서버가 시작될 때 forRequest 또는 다른 메서드를 호출하기 전에 각 인스턴스에서 한 번씩 호출합니다. 모든 forRequest 핸들은 이 핸들을 만든 인스턴스의 구성을 사용합니다.

datastreamId, orgId 및 edgeCredentials 속성이 필요합니다. 다른 모든 속성은 선택 사항입니다. 다음 예제는 사용 가능한 모든 속성을 사용하는 구성 개체를 보여 줍니다.

import { createInstance } from "@adobe/alloy-node";

const alloy = createInstance();

await alloy.configure({
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  edgeCredentials: {
    clientId: process.env.ADOBE_CLIENT_ID,
    clientSecret: process.env.ADOBE_CLIENT_SECRET,
    scopes: process.env.ADOBE_SCOPES.split(",")
  },
  debugEnabled: false,
  defaultConsent: "in",
  edgeBasePath: "ee",
  edgeConfigOverrides: {
    com_adobe_target: {
      propertyToken: "01dbc634-07c1-d8f9-ca69-b489a5ac5e94"
    }
  },
  edgeDomain: "data.example.com",
  idMigrationEnabled: false,
  onBeforeEventSend: (content) => {
    content.xdm.application ??= {};
    content.xdm.application.name = "Example storefront";
  },
  thirdPartyCookiesEnabled: false
});

구성 속성 properties

defaultConsent 속성은 createInstance에 기본적으로 포함된 동의 구성 요소가 인스턴스에 포함된 경우에만 사용할 수 있습니다. 사용자 지정 인스턴스 만들기를 참조하십시오.

서버 SDK에서 지원하지 않는 옵션 unsupported

웹 SDK에는 링크 클릭 컬렉션, 개인화된 콘텐츠 렌더링 및 푸시 알림과 같이 브라우저에 종속되는 기능에 대한 구성 옵션이 있습니다. Server SDK에서는 이러한 옵션을 사용할 수 없습니다. 옵션을 포함하는 경우 configure이(가) 거부되고 옵션 이름을 지정하는 Unknown field 오류가 발생합니다.

다음 웹 SDK 옵션을 사용할 수 없습니다. autoCollectPropositionInteractions, clickCollection, clickCollectionEnabled, context, conversation, downloadLinkQualifier, onBeforeLinkClickSend, personalizationStorageEnabled, prehidingStyle, pushNotifications, streamingMedia 및 targetMigrationEnabled.

결과 및 오류 result

configure 메서드는 구성이 성공하면 빈 개체로 확인되는 약속을 반환합니다. 다음과 같은 경우에는 이 옵션을 거부합니다.

configure이(가) 거부하면 인스턴스가 구성되지 않은 상태로 유지되며, forRequest에서 configure에 대한 호출이 성공할 때까지 오류가 발생합니다.