Elixir SDK

alias Kameleoon.Client
alias Kameleoon.Data.CustomData

:ok = Client.add_data(client, visitor_code, CustomData.new!(42, ["new_visitor_code"]))

# この例では、91 は Kameleoon で一意の識別子として設定されたカスタムデータのインデックスを表します。
alias Kameleoon.Client
alias Kameleoon.Data.CustomData
alias Kameleoon.Data.UniqueIdentifier

mapping_index = 91
feature_key = "ff123"

anonymous_visitor_code = "anonymous-visitor"
user_id = "authenticated-user"

# 1. 訪問者が認証される前

# 認証されていない訪問者のバリエーションを取得します。
# anonymousVisitorCode はその訪問者用にランダムに生成された ID であると仮定します。
{:ok, anonymous_variation} = Client.get_variation(client, anonymous_visitor_code, feature_key)

# 2. 訪問者が認証された後

# `userId` が認証された訪問者の訪問者コードであると仮定します。
:ok = Client.add_data(client, anonymous_visitor_code, CustomData.new!(mapping_index, [user_id]))
:ok = Client.flush_instant(client, anonymous_visitor_code)

# `userId` が一意の識別子であることを示します。
:ok = Client.add_data(client, user_id, UniqueIdentifier.new!(true))

# 3. 訪問者が承認された後

# `userId` のバリエーションを取得します。これは匿名訪問者コードのバリエーションと一致します。
{:ok, user_variation} = Client.get_variation(client, user_id, feature_key)
is_same_variation = user_variation.key == anonymous_variation.key # true

# `userId` と `anonymousVisitorCode` はリンクされ、単一の訪問者としてトラッキングできるようになります。
:ok = Client.track_conversion(client, user_id, 123)

# さらに、リンクされた訪問者は以前にトラッキングされたリモートデータをすべて共有します。
:ok = Client.get_remote_visitor_data(client, user_id)

alias Kameleoon.Logger

# `:none` ログレベルではロギングが許可されません。
:ok = Logger.set_log_level(:none)

# `:error` ログレベルでは、SDK の主要な動作に影響する問題のみがロギングされます。
:ok = Logger.set_log_level(:error)

# `:warning` ログレベルでは、注意が必要な問題のロギングが許可されます。
# `:error` ログレベルを拡張したものです。
# `:warning` ログレベルはデフォルトのログレベルです。
:ok = Logger.set_log_level(:warning)

# `:info` ログレベルでは、SDK の内部プロセスに関する一般的な情報のロギングが許可されます。
# `:warning` ログレベルを拡張したものです。
:ok = Logger.set_log_level(:info)

# `:debug` レベルでは、SDK の内部プロセスに関する追加の詳細がロギングされます。
:ok = Logger.set_log_level(:debug)

defmodule MyKameleoonLogger do
  @behaviour Kameleoon.Logger
  require Logger

  @impl true
  def log(level, message) do
    Logger.log(level, message)
  end
end

# ログレベルフィルタリングは、ログ処理ロジックとは別に適用されます。
# カスタムロガーは、指定されたログレベル以上のログのみを受け入れます。
:ok = Kameleoon.Logger.set_log_level(:debug)
:ok = Kameleoon.Logger.set_logger(MyKameleoonLogger)

alias Kameleoon.Client

# 設定されたデフォルトのタイムアウトを使用してクライアントを初期化します
:ok = Client.initialize(client)

# 5 秒のカスタムタイムアウトでクライアントを初期化します
:ok = Client.initialize(client, timeout: 5_000)

{:ok, ready?} = Kameleoon.Client.is_ready?(client)

if ready? do
  # クライアントは準備ができています
end

alias Kameleoon.ClientFactory

# 指定されたサイトコードのキャッシュされたクライアントを削除します
:ok = ClientFactory.forget("a8st4f59bj")

# 指定されたサイトコードと環境のキャッシュされたクライアントを削除します
:ok = ClientFactory.forget("a8st4f59bj", environment: "production")

alias Kameleoon.Client

feature_key = "new_checkout"

# フィーチャーフラグを評価し、トラッキングデータを送信します(デフォルト動作)
{:ok, active?} = Client.is_feature_active?(client, visitor_code, feature_key)

# トラッキングデータを送信せずにフィーチャーフラグを評価します
{:ok, active_without_tracking?} =
  Client.is_feature_active?(client, visitor_code, feature_key, track: false)

alias Kameleoon.Client

feature_key = "new_checkout"

# 訪問者に割り当てられたバリエーションを取得します(トラッキングはデフォルトで有効)
{:ok, variation} = Client.get_variation(client, visitor_code, feature_key)

# トラッキングデータを送信せずにバリエーションを取得します
{:ok, variation_without_tracking} =
  Client.get_variation(client, visitor_code, feature_key, track: false)

alias Kameleoon.Client

# 訪問者に割り当てられたすべてのバリエーションを取得します(デフォルトオプションを使用)
{:ok, variations} = Client.get_variations(client, visitor_code)

# 訪問者のアクティブなバリエーションのみを取得します
{:ok, only_active_variations} = Client.get_variations(client, visitor_code, only_active: true)

# トラッキングデータを送信せずにバリエーションを取得します
{:ok, variations_without_tracking} = Client.get_variations(client, visitor_code, track: false)

alias Kameleoon.Client

experiment_id = 202_387

# 指定された実験に対して訪問者を "variation_2" に強制します
:ok = Client.set_forced_variation(client, visitor_code, experiment_id, "variation_2")

# この実験で訪問者に対して以前に強制されたバリエーションを削除します
:ok = Client.set_forced_variation(client, visitor_code, experiment_id, nil)

# カスタムオプションで訪問者を "variation_2" に強制します。
# この場合、ターゲティングルールが尊重されます(force_targeting = false)。
:ok =
  Client.set_forced_variation(
    client,
    visitor_code,
    experiment_id,
    "variation_2",
    force_targeting: false
  )

:ok = Kameleoon.Client.evaluate_audiences(client, visitor_code)

{:ok, datafile} = Kameleoon.Client.get_datafile(client)

alias Kameleoon.Client
alias Kameleoon.Data.Browser
alias Kameleoon.Data.PageView
alias Kameleoon.Data.UserAgent

:ok = Client.add_data(client, visitor_code, Browser.new!(:chrome, version: 123.0))

:ok =
  Client.add_data(client, visitor_code, [
    PageView.new!("https://example.com/pricing", title: "Pricing", referrers: [3]),
    UserAgent.new!("Mozilla/5.0")
  ])

:ok =
  Client.add_data(
    client,
    visitor_code,
    PageView.new!("https://example.com/checkout", title: "Checkout"),
    track: false
  )

# 指定された visitor_code のフラッシュ操作をキューに入れます。
# データは、設定されたトラッキング間隔に従って送信されます。
:ok = Kameleoon.Client.flush(client, visitor_code)

# 指定された visitor_code のすべての保留中のトラッキングデータを即座に送信します。
:ok = Kameleoon.Client.flush_instant(client, visitor_code)

{:ok, data} = Kameleoon.Client.get_remote_data(client, "test-key")

alias Kameleoon.Client
alias Kameleoon.Types.RemoteVisitorDataFilter

# フィルターなしでリモート訪問者データを取得します。
# 指定された訪問者の利用可能なすべてのデータが返されます。
:ok = Client.get_remote_visitor_data(client, visitor_code)

# 返されるデータを制限するためにフィルターを作成します。
filter = %RemoteVisitorDataFilter{
  previous_visit_amount: 5,
  conversions: true,
  page_views: true
}

# 指定されたフィルターを使用してリモート訪問者データを取得します。
# これは、フィルター基準に一致するデータのみを返します。
:ok = Client.get_remote_visitor_data(client, visitor_code, filter: filter)

alias Kameleoon.Client

# visitor_code のみを使用して訪問者のオーディエンスデータを取得します。
:ok = Client.get_visitor_warehouse_audience(client, visitor_code, 98)

# visitor_code と warehouse_key の両方を使用して訪問者のオーディエンスデータを取得します。
# ウェアハウスが visitor_code とは異なる識別子を使用する場合に便利です。
:ok = Client.get_visitor_warehouse_audience(client, visitor_code, 98, warehouse_key: "internal-user-id")

cookies = {PlugConnCookies, conn}

# 同意を設定し、Cookie を更新します。
{:ok, conn} = Kameleoon.Client.set_legal_consent(client, visitor_code, true, cookies)

alias Kameleoon.Client
alias Kameleoon.Data.CustomData

# ゴールをトラッキングします。
:ok = Client.track_conversion(client, visitor_code, goal_id)

# 収益を伴うゴールをトラッキングします。
:ok = Client.track_conversion(client, visitor_code, goal_id, revenue: 100.0)

# 負の収益を伴うゴールをトラッキングします。
:ok = Client.track_conversion(client, visitor_code, goal_id, revenue: 100.0, negative: true)

# カスタムメタデータを伴うゴールをトラッキングします。
:ok =
  Client.track_conversion(
    client,
    visitor_code,
    goal_id,
    metadata: [CustomData.new!(4, ["true"])]
  )

{:ok, tracking_code} = Kameleoon.Client.get_engine_tracking_code(client, visitor_code)

:ok =
  Kameleoon.Client.on_datafile_update(client, fn ->
    IO.puts("Kameleoon datafile updated")
  end)

:ok = Kameleoon.Client.on_datafile_update(client, nil)

alias Kameleoon.Client
alias Kameleoon.Data.ApplicationVersion

# major
:ok = Client.add_data(client, visitor_code, ApplicationVersion.new!("10"))
# major.minor
:ok = Client.add_data(client, visitor_code, ApplicationVersion.new!("10.20"))
# major.minor.patch
:ok = Client.add_data(client, visitor_code, ApplicationVersion.new!("10.20.30"))

alias Kameleoon.Client
alias Kameleoon.Data.Browser

# バージョン付きのブラウザデータ
:ok = Client.add_data(client, visitor_code, Browser.new!(:safari, version: 26.4))
# バージョンなしのブラウザデータ
:ok = Client.add_data(client, visitor_code, Browser.new!(:chrome))

alias Kameleoon.Client
alias Kameleoon.Data.Conversion
alias Kameleoon.Data.CustomData

# ID 32 のシンプルな変換を追加します
:ok = Client.add_data(client, visitor_code, Conversion.new!(32))

# 収益を含み、負としてマークされた ID 33 の変換を追加します
:ok = Client.add_data(client, visitor_code, Conversion.new!(33, revenue: 10.0, negative: true))

# 収益、負フラグ、およびカスタムメタデータを含む ID 34 の変換を追加します
:ok =
  Client.add_data(
    client,
    visitor_code,
    Conversion.new!(34,
      revenue: 10.0,
      negative: true,
      metadata: [
        CustomData.new!(3, ["metadata1", "md2"]),
        CustomData.new!(5, ["md3"])
      ]
    )
  )

alias Kameleoon.Client
alias Kameleoon.Data.Cookie

:ok = Client.add_data(client, visitor_code, Cookie.new!(%{"segment" => "vip"}))

alias Kameleoon.Client
alias Kameleoon.Data.CustomData

:ok = Client.add_data(client, visitor_code, CustomData.new!(1, ["value"]))

# 複数の値を使用
:ok = Client.add_data(client, visitor_code, CustomData.new!(1, ["value1", "value2"]))

# `overwrite` フラグを false に設定する
:ok = Client.add_data(client, visitor_code, CustomData.new!(1, ["value"], overwrite: false))

# インデックスの代わりに名前を使用する
:ok = Client.add_data(client, visitor_code, CustomData.new_with_name!("my-custom-data", ["value"]))

# インデックスの代わりに名前を使用し、`overwrite` フラグを false に設定する
:ok =
  Client.add_data(
    client,
    visitor_code,
    CustomData.new_with_name!("my-custom-data", ["value"], overwrite: false)
  )

alias Kameleoon.Client
alias Kameleoon.Data.Device

:ok = Client.add_data(client, visitor_code, Device.new!(:desktop))

alias Kameleoon.Client
alias Kameleoon.Data.Geolocation

geolocation =
  Geolocation.new!("France",
    region: "Ile-de-France",
    city: "Paris",
    postal_code: "75009",
    latitude: 48.8720171,
    longitude: 2.3338352
  )

:ok = Client.add_data(client, visitor_code, geolocation)

alias Kameleoon.Client
alias Kameleoon.Data.OperatingSystem

:ok = Client.add_data(client, visitor_code, OperatingSystem.new!(:windows))

alias Kameleoon.Client
alias Kameleoon.Data.PageView

# url、オプションのタイトル、およびリファラーを含む完全なコンストラクタ。
:ok = Client.add_data(client, visitor_code, PageView.new!("https://example.com", title: "Homepage", referrers: [3]))

# URL のみを必要とする最小限のコンストラクタ。
:ok = Client.add_data(client, visitor_code, PageView.new!("https://example.com"))

alias Kameleoon.Client
alias Kameleoon.Data.UniqueIdentifier

:ok = Client.add_data(client, visitor_code, UniqueIdentifier.new!(true))

alias Kameleoon.Client
alias Kameleoon.Data.UserAgent

:ok = Client.add_data(client, visitor_code, UserAgent.new!("Mozilla/5.0"))

# DataFile からフィーチャーフラグのマップを取得します。
# マップはフィーチャーフラグ識別子をキーとし、各値は FeatureFlag 構造体です。
feature_flags = datafile.feature_flags

# DataFile の最終変更タイムスタンプを取得します。
# 値は、Unix エポックからのミリ秒を表す整数です。
date_modified = datafile.date_modified

# フィーチャーフラグが現在の環境で有効になっているかどうかを確認します。
environment_enabled = feature_flag.environment_enabled

# デフォルトバリエーションのキーを取得します。
default_variation_key = feature_flag.default_variation_key

# デフォルトバリエーションの構造体を取得します。
default_variation = Kameleoon.Types.FeatureFlag.default_variation(feature_flag)

# フィーチャーフラグのすべてのバリエーションをマップとして取得します(キー = バリエーションのキー、値 = Variation 構造体)。
variations = feature_flag.variations

# フィーチャーフラグに関連付けられたすべてのターゲティングルールを取得します。
rules = feature_flag.rules

# ルールのすべてのバリエーションをマップとして取得します(キー = バリエーションのキー、値 = Variation 構造体)。
variations = rule.variations

# バリエーション名を取得します。
variation_name = variation.name

# バリエーションキーを取得します。
variation_key = variation.key

# バリエーション ID を取得します。
variation_id = variation.id

# 実験 ID を取得します。
experiment_id = variation.experiment_id

# 変数リストを取得します。
variables = variation.variables

# バリエーションがアクティブかどうか(訪問者に現在配信されているかどうか)を確認します。
active? = Kameleoon.Types.Variation.active?(variation)

# キーで変数を取得します。見つからない場合は nil を返します。
variable = Enum.find(variation.variables, &(&1.key == "title"))

# バリエーションに関連付けられた変数のリストを取得します。
variables = variation.variables

# 条件付き処理のために変数の型(kind)にアクセスします。
kind = variable.kind

# 値を数値として抽出します。
number = variable.value

# 値をブール値として抽出します。
apply_discount? = variable.value

# 値を文字列として抽出します。
title = variable.value