[Alpha]{class="badge informative"}

edgeConfigOverrides(서버 SDK, configure)

이 페이지에서는 서버 SDK configure 메서드의 edgeConfigOverrides에 대해 설명합니다. 웹 SDK에 대해서는 edgeConfigOverrides.​을(를) 참조하십시오.

edgeConfigOverrides 개체를 사용하면 인스턴스가 보내는 모든 요청에 대해 데이터 스트림 설정을 재정의할 수 있습니다. 예를 들어 데이터스트림의 기본값이 아닌 다른 Experience Platform 데이터 세트, Analytics 보고서 세트 또는 Target 속성에 데이터를 보낼 수 있습니다. 이 기능은 하나의 서버가 데이터 스트림을 공유하는 여러 웹 사이트 또는 비즈니스 단위를 처리할 때 유용합니다. 단일 이벤트에 대한 설정을 재정의하려면 sendEvent🔗에서 edgeConfigOverrides 개체를 대신 사용하십시오.

데이터 스트림 설정을 재정의하는 데 두 단계가 필요합니다.

configure에서 edgeConfigOverrides을(를) 설정하면 인스턴스의 모든 요청과 인스턴스가 만드는 모든 forRequest 핸들에 적용됩니다. 다음 메서드에서는 단일 호출에 대해 edgeConfigOverrides 개체도 허용합니다.

메서드 호출에 자체 edgeConfigOverrides 개체가 포함된 경우 SDK은 해당 호출을 위해 해당 개체를 configure의 개체와 결합합니다. com_adobe_analytics과(와) 같은 각 최상위 속성에 대해 메서드 호출의 값이 configure의 전체 값을 대체합니다. configure에서만 설정한 최상위 속성이 계속 적용됩니다.

예를 들어 configure이(가) com_adobe_analytics과(와) com_adobe_target을(를) 설정하고 sendEvent 호출이 com_adobe_analytics만 설정하는 경우 해당 이벤트는 sendEvent의 com_adobe_analytics과(와) configure의 com_adobe_target을(를) 사용합니다. 최상위 속성 내에 중첩된 속성은 결합되지 않으므로 enabled 및 reportSuites과 같이 필요한 모든 중첩된 속성을 포함합니다.

예

다음 예제는 모든 요청에 대해 Experience Platform 데이터 세트, Analytics 보고서 세트 및 Target 속성을 재정의합니다.

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(",")
  },
  edgeConfigOverrides: {
    com_adobe_experience_platform: {
      datasets: {
        event: {
          datasetId: "64b6f930753dd41ca8d4fd77"
        }
      }
    },
    com_adobe_analytics: {
      reportSuites: ["examplersid1", "examplersid2"]
    },
    com_adobe_target: {
      propertyToken: "01dbc634-07c1-d8f9-ca69-b489a5ac5e94"
    }
  }
});

지원되는 재정의 properties

데이터 스트림 구성에서 허용한 설정만 재정의할 수 있습니다. 데이터 스트림 구성 재정의를 참조하십시오.