getInstance getinstance

Last update: Wed May 24 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

Developer
User
Admin
Leader

getInstance는 지정된 Experience Cloud 조직 ID에 대한 방문자 ID 개체를 반환합니다. s.visitor를 통해 AppMeasurement에 제공된 방문자 ID 개체를 초기화하는 데 필요합니다.

구문

JavaScript

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

CAUTION

var visitor = new Visitor을 사용하여 방문자 함수를 인스턴스화하지 마십시오. 여기에 언급된 적절한 함수 호출을 사용해야 합니다. VisitorAPI.js 코드 라이브러리 v3.0 이상에 적용됩니다.

ActionScript/Flash

import com.adobe.mc.Visitor;
...
var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

getInstance에서 기존 인스턴스를 찾지 못할 경우 새 인스턴스가 만들어진 후 반환됩니다. 이것은 s_gi() 기능(AppMeasurement에서 제공됨)과 유사합니다.

일반적인 사용

Experience Cloud ID 서비스 API는 각 Adobe Experience Cloud 조직 ID에 대해 생성된 모든 인스턴스 목록을 유지합니다. ID 서비스 API를 사용하는 애플리케이션이 인스턴스에 대한 참조를 전달하지 않을 경우 새 인스턴스를 만들지 않고 getInstance를 호출하여 해당 인스턴스를 찾을 수 있습니다. 또한 동일한 웹 페이지 또는 애플리케이션에서 여러 다른 조직을 위한 여러 인스턴스를 지원합니다.

이 메서드는 명확한 init 단계가 없으나 여러 위치에서 ID 서비스 API를 호출해야 하는 애플리케이션에 유용합니다. 해당 모든 위치에서 getInstance를 호출할 수 있으며 첫 번째 실행에서 해당 인스턴스가 생성됩니다. 기존 인스턴스는 후속 호출에 의해 반환됩니다.

recommendation-more-help

9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a