カスタムイベントの文字制限について
カスタムイベントのkeyに設定する値（value）について、個数の上限はありませんが、文字数の制限があります。
イベント送信時に value は name=value&name2=value2 のように、連結した形で文字列に変換しており、 = や & も文字数としてカウントします。
例）イベント名が app.top 、value として screen に home と、 code に abc という 2 つの value を付与している場合
- key：
app.top(7文字とカウント) - value：
screen=home&code=abc(20文字とカウント)
OSごとの valueに指定できる文字の制限事項につきましては、以下の通りです。
iOS
- キー名は、英数字（
[a-zA-Z0-9]）、アンダースコア(_)、ピリオド(.)、ハイフン(-)のみ使用できます。 - キー名の先頭にアンダースコア(
_)は使用できません。 - キー名が
nilや空文字の時は記録できません。 - 文字数制限は、キー名が 32 文字、キーに対する値はトータルで 512 文字 です。
Android
- イベントkeyに「
_」アンダースコアから始まる文字列は使用不可能。 - イベントkeyの使用可能文字は
[0-9a-zA-Z]_-.になります。 - イベントvalue値はnameとvalueで構成され、nameは必須でvalueはnullの場合は空として扱われます。
-
またvalue値はURLエンコードしてから送信します。
- 例）URLエンコード前：
a=あ&b=いURLエンコード後：a=%E3%81%82&b=%E3%81%84
- 例）URLエンコード前：
- 文字数制限は、キー名が 64 文字、キーに対する値はトータルで 500 文字 です。
各組み込みガイド
iOS：各種機能 > イベントトラッキング
Android：各種機能 > カスタムイベント
WebView版イベントトラッキングの文字制限について
WebView版イベントトラッキングには、以下の制限があることにご注意ください。
- キーと値はそれぞれstring型で指定する必要があります。
- キーと値の合計文字数は2,048文字以下である必要があります。
- 例)
{"key1:"value1", "key2":"value2"}を指定する場合、"key1=value1&key2=value2"の文字数が2,048文字以下である必要があります。 - 合計文字数が超過している場合はイベントが送信されません。
- 例)
- キーと値について、Android、iOSそれぞれで異なる文字制限はありません。
なお、イベント名（shop.addCart）については下記の制限があります。
- 英数字（
[a-zA-Z0-9]）、アンダースコア(_)、ピリオド(.)、ハイフン(-)のみ使用できます。 - 先頭にアンダースコア(
_)は使用できません。 - イベント名について、Android、iOSそれぞれで異なる文字制限はありません。
各組み込みガイド
WebView版イベントトラッキング機能 組み込みガイド v3 > 一歩進んだ使い方