getInstance getinstance

最終更新日： 2026年5月22日

トピック：
Identities
Integrations

作成対象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"f8a45b24-4be7-4f1b-909b-60d06b483a20"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

getInstanceは、指定されたIMS組織IDの訪問者ID オブジェクトを返します。このメソッドは、s.visitor を使用して AppMeasurement に提供される訪問者 ID オブジェクトを初期化するために必要です。

構文

JavaScript

var visitor = Visitor.getInstance("INSERT-IMS-ORG-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-IMS-ORG-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 により既存のインスタンスが見つからない場合は、新しいインスタンスが作成されて返されます。これは、AppMeasurementのs_gi()関数に似ています。

一般的な使用例

訪問者ID サービス APIは、各IMS組織IDに対して作成されたすべてのインスタンスのリストを保持します。訪問者ID サービス APIを使用するアプリケーションがインスタンスへの参照を渡さない場合は、新しいインスタンスを作成する代わりにgetInstanceを呼び出すことでそのインスタンスを見つけることができます。同じ Web ページまたはアプリケーションにおいて、異なる組織の複数のインスタンスもサポートされます。

これは、init フェーズが明確でないが、複数の場所で訪問者ID サービス APIを呼び出す必要があるアプリケーションに役立ちます。それらすべての場所で getInstance を呼び出すことができ、その最初の実行時にインスタンスが作成されます。その後の呼び出しでは既存のインスタンスが返されます。

recommendation-more-help

id-service-help