getVisitorValues getvisitorvalues

これは、Analytics、訪問者ID サービス、データ収集オプトアウト、地理的な場所、メタデータ「BLOB」コンテンツの識別子をデフォルトで返す非同期APIです。 オプションの visitor.FIELDS 列挙を使用して、返される ID を制御することもできます。

内容:

構文 section-5aebe3907b2b46e997f45a1d1ed35c09

この関数は、次の構文を使用します(斜体は変数のプレースホルダーを表します):var *values* = visitor.getVisitorValues (callback, [visitor.FIELDS. *ID type*, visitor.FIELDS. *ID type*]);

関数パラメーターの詳細は次のとおりです。

  • *callback* は、返される ID を受け取るコールバックコードを表します。
  • (オプション) visitor.FIELDS. *ID type* は、この関数で返す必要がある ID 値を指定できる列挙です。

詳しくは、以下の使用例と定義を参照してください。

ユースケース 1:デフォルトデータセットのリクエスト section-36a31683558742a5915db3a391e09f7b

このコードは、標準データセットを返します。 リクエストと応答は、次の例のようになります。

//Call the Visitor ID Service
var visitor = Visitor.getInstance ("INSERT-IMS-ORG-ID-HERE",{...});

//Add your callback to the GET method to return IDs and data.
visitor.getVisitorValues(visitorIdsCallback);

デフォルトのサンプル応答では、デモ用に一部の値が短縮されています。

//Formatted IDs in JSON response
{
    MCMID: 'mid-1234',
    MCOPTOUT: 'isoptedout-true',
    MCAID: 'aid-1234',
    MCAAMLH: 7,
    MCAAMB: 'hgfe54236786oygj'
}

ユースケース 2:カスタムデータセットのリクエスト section-467b2f4e513344c89b7332b05f6f59f3

このコードはオプションの配列を使用し、visitor.FIELDS 列挙を使用して特定の ID セットを返します。 この場合、訪問者のECID (MCID)とAnalytics ID (MCAID)のみが必要です。 リクエストと応答は、次の例のようになります。

//Call the Visitor ID Service
var visitor = Visitor.getInstance("INSERT-IMS-ORG-ID-HERE", { ... });

// Add an optional array to specify which IDs you want to return.
visitor.getVisitorValues(visitorIdsCallback, [visitor.FIELDS.MCMID, visitor.FIELDS.MCAID]);

カスタマイズされたレスポンスの例では、リクエストで指定された ID のみが返されます。

//Formatted IDs in JSON response
{
    MCMID: 'mid-1234',
    MCAID: 'aid-4321'
}

レスポンスパラメーターの定義 section-4c4c300167694c6fbff1d6c612f372b5

以下の表に、レスポンスパラメーターとその定義を示します。 これらは visitor.FIELDS 列挙に含まれるすべての値でもあります。 特定の変数に値がない場合、このメソッドは空の文字列を返すことに注意してください。

値
説明
MCAAMB
「blob」と呼ばれる、暗号化された Audience Manager メタデータです。
MCAAMLH

データ収集地域 ID です。 これは、特定の訪問者ID サービスデータセンターの地理的位置の数値識別子です。

DCS 地域 ID、場所、ホスト名および getLocationHint を参照してください。

MCAID
訪問者の Analytics ID です。
MCMID

訪問者のECID。

Cookieと訪問者ID サービスを参照してください。

MCOPTOUT

訪問者がデータ収集をオプトアウトしたかを示すフラグです。

以下の値が含まれます。

  • 'isoptedout-true':訪問者はデータ収集をオプトアウトしています。
  • 'isoptedout-false':訪問者はデータ収集をオプトアウトしていません。
recommendation-more-help
id-service-help