AudienceStreamとOptimizely Full Stackの統合 | テクノロジーパートナー

前提条件

Tealiumの訪問者プロファイルのVisitor ID
Optimizelyの機能または実験のUser ID

仕組み

Tealium AudienceStreamのオーディエンスとバッジをOptimizely Full Stack内で活用することで、特定の機能や実験をユーザーの一部に対してターゲット設定することができます。

制限事項と考慮事項

データレイヤー濃縮APIを呼び出すとネットワーク遅延が発生するため、環境内でローカルにキャッシュされたプロファイルを使用して、クリティカルパス外で行う必要があります。
Optimizely Full Stackのプロジェクトは、属性の上限が100です。

Tealium SDK: VisitorService

Tealium Software Development Kit（SDK）内のVisitorServiceは、データレイヤー濃縮APIのラッパーで、データレイヤー濃縮の呼び出しを更新し、キャッシュする複雑さを管理するために使用できます。

以下のTealium SDKには、組み込みのデータレイヤー濃縮プロファイルがあります：

iOS用Swift

VisitorSevice Module開発者ドキュメンテーションに記載されているように、TealiumVisitorServiceDelegateを実装します。

**func** **profileDidUpdate**(profile: TealiumVisitorProfile?) {
        **guard let** profile = profile **else { return }**

        // Return the current Audiences for which the user is assigned
       **if let** currentVisitorAudiences = profile.audiences {
            print("Visitor audiences: \(currentVisitorAudiences)")

            // Check if an Audience is assigned to a user by id
            **if** currentVisitorAudiences[id: "106"] {
                print("Visitor is a member of audience id 106")
                // ... Visitor is a member of this audience, take appropriate action
            }

            // Check if an Audience is assigned to a user by name
            **if** currentVisitorAudiences[name: "ios users"] {
                print("Visitor is a member of audience iOS Users")
                // ... Visitor is a member of this audience, take appropriate action
            }
        }
}

オーディエンスとバッジを単一の属性変数にマージする

以下の例を使用して、オーディエンスとバッジを単一の属性変数にマージします：

/*
Merged profiles.audience and profiles.badges into attributes array using array append or + notation.
NOTE: Ensure you include any existing attributes you may already be passing.
*/

let attributes = profile.audiences + profile.badges

例：getEnabledFeatures

let enabledFeatures = optimizely.getEnabledFeatures(userId: "user_123",
  attributes: attributes)

例：Activate

do {
	let variation = try optimizelyClient.activate("app_redesign", userId:userId, attributes: attributes )
  if (variation.variationKey == "control") {
    // Execute code for variation A
  } else if (variation.variationKey == "treatment") {
    // Execute code for variation B
  }
} catch {
  // Execute code for users who don't qualify for the experiment
}

Android

VisitorServiceを含む新しいAndroid SDKが現在開発中です。

Tealium Data Layer Enrichment Public API

SDKがVisitorServiceを実装していない言語で現在のユーザーのTealiumプロファイルを取得するには、Data Layer Enrichment Public APIを参照してください。

Data Layer Enrichment APIをサーバーサイドのコードで使用する場合、ユーザープロファイルをローカルサーバーに保存し、更新リクエストをバックグラウンドで行うことを検討してください（約100ミリ秒以下）。

あなたの実装があなたのユースケースに適していることを確認するために、Optimizelyの代表者に連絡してください。

Data Layer Enrichment APIは、以下の例のような訪問者プロファイルのJSONを返します：

{
     "metrics" : {
            "5117" : 6.0,
            "22" : 6.0
     },
     "dates" : {
            "5111" : 1420223771043
     },
     "properties" : {
            "17" : "http://tags.tiqcdn.com/utag/acct/prof/env/mobile.html",
            "account" : "tealiummobile",
            "5123" : "set",
            "profile" : "demo"
      },
      "flags" : { "5115" : true },
      "current_visit"  {
          "metrics" : {
              "7" : 6.0
           },
           "dates" : {
               "5202" : 1420225387000
           },
           "properties" : {
               "48" : "Chrome",
               "45" : "Mac OS X",
               "44" : "Chrome",
               "47" : "browser",
               "46" : "Mac desktop"
           },
          "flags" : { }
        },
       "badges" : { "5113" : true },
       "audiences" : {
            "tealiummobile_demo_101" : "Sample Audience"
       }
}

Optimizelyで属性を設定する

Tealiumのオーディエンスやバッジを対象としたフィーチャーフラグ/フィーチャー実験または実験をターゲットにするために、Optimizely Full Stackインターフェース内でTealiumのオーディエンスとバッジごとに1つの"属性"を作成します。

作成する属性は、JSONオブジェクトのキー要素と一致する必要があります。ターゲットにしたい定期的で一貫したオーディエンスのためにこれらの属性を作成します。例えば、前述のサンプルJSONでは、Optimizelyで以下の属性を作成します：

Audiences: tealium_mobile_demo_101
Badges: 5113

プロジェクトごとの属性の上限は100です。使用する予定のTealiumのオーディエンスとバッジのためだけに属性を作成してください。

属性を編集する

属性は、OptimzelyのAPIを呼び出す際に渡すユーザーの特性で、これを使用してオーディエンスを作成することができます。属性をクリックして、属性キーまたはオプションの属性説明フィールドを編集し、Save Attributeをクリックして変更を保存します。

Optimizelyのオーディエンスを設定する

Optimizely Full Stackインターフェース内で属性を作成した後、以下の手順を使用してオーディエンスを作成します：

Audienceタブをクリックします。
Create New Audienceをクリックします。
オーディエンスの名前と説明を入力します。
Custom Attributesの下で、前の手順で作成したTealiumの属性を選択します。
オーディエンスを必要に応じて設定したら、Saveをクリックします。

TealiumのオーディエンスとバッジをOptimizelyに渡す

コード内で、オーディエンスとバッジのセクションを使用して属性パラメータを作成し、Optimizelyに渡すことができるように、JSONオブジェクトを解析します。以下の例を参照してください。

すでにOptimizelyを通じて属性を渡している場合は、その要素を属性パラメータに含めることを確認してください。

/* Function to merge array objects */

function extend(dest, src) {
  for(var key in src) {
    dest[key] = src[key];
  }
  return dest;
}

var request = new XMLHttpRequest()
request.open('GET','https://visitor-service.tealiumiq.com/{account}/{profile}/{visitor_id}', true)

request.onload = function() {
var tealium_audiences = JSON.parse(this.response);
var attributes = tealium_audiences.audiences
attributes = extend(attributes, tealium_audiences.badges);
}

// Send request
request.send()

上記の例の結果は以下のようになります：

var attributes = {
  "5113": 'true',
  "tealiummobile_101": "Sample Audience"
};

属性変数は、以下の例のように、getFeatureEnabledおよびactivate関数を使用してOptimizelyに渡すことができます：

var enabled = optimizelyClientInstance.isFeatureEnabled('mens_preview_widget', userId, attributes);

前提条件

仕組み

制限事項と考慮事項

Tealium SDK: VisitorService

iOS用Swift

最新の訪問者プロファイルを取得する

オーディエンスとバッジを単一の属性変数にマージする

例：getEnabledFeatures

例：Activate

Android

Tealium Data Layer Enrichment Public API

Optimizelyで属性を設定する

属性を編集する

Optimizelyのオーディエンスを設定する

TealiumのオーディエンスとバッジをOptimizelyに渡す