コンテンツにスキップ

イベント送信

イベントとは？

イベントは、ユーザーがゲーム内で行った特定の行動をデータとして記録した単位です。 「いつ、誰が、何をしたのか」を含んでおり、分析の最も基本的な単位になります。

  • 例: ユーザーがアイテムを購入した → item_purchase イベント発生
  • 例: ユーザーが特定のステージをクリアした → stage_clear イベント発生
  • 例: ユーザーがアプリにログインした → login イベント発生

イベント転送方法については、イベントログ転送を参照してください。

イベント命名規則

eventName に使用するイベント名は、以下の規則に従って命名することを推奨します。

  • 推奨文字: 英字（a–z、A–Z、大文字と小文字を区別）、数字（0–9）、アンダースコア（_）
  • 区切り文字: 単語間は空白ではなくアンダースコア（_）で区切ります
  • 形式: イベントを明確に説明する noun_verb 形式を推奨します
  • 例: item_purchase, level_up, tutorial_complete, stage_start
Warning

上記の規則に従わないイベント名は、分析での活用が制限される場合があります。

属性とは？

属性は、イベントが発生したときに一緒に記録される詳細です。イベントだけでは「何が起こったのか」しかわかりませんが、属性を通じて「どのような条件で、どの値で」発生したのかを把握できます。

  • 例: item_purchase イベントの属性 → アイテム ID、決済金額、通貨単位
  • 例: stage_clear イベントの属性 → ステージ番号、クリア時間、使用文字

イベントとともに属性を転送する方法については、イベント属性の転送を参照してください。

属性命名規則

カスタム属性（eventAttributes）のキーは、以下の規則に従って命名することを推奨します。

  • 推奨文字: 英字（a–z、A–Z、大文字と小文字を区別）、数字（0–9）、アンダースコア（_）
  • 先頭文字: 英字で始めます
  • 区切り文字: 単語間は空白ではなくアンダースコア（_）で区切ります
  • 例: item_id, contentsType, stage_level
Warning
  • 上記の規則に従わない属性キーは、分析での活用が制限される場合があります。
  • attributes、eventAttributes、hiveAttributes は予約語です。これらを名前として使用した属性は隔離されます。詳細はイベント属性の転送を参照してください。

イベント構造に合わせて設計したイベントの例は、イベントテンプレートで確認できます。

注意事項 & Tips

  • イベント名と属性名は一度配布すると変更しにくいです。送信する前に、イベント属性の転送の命名規則を最初に確認してください。
  • 同じ目的のイベントを複数の名前で重複作成せず、イベントテンプレートに定義済みのイベント名があるか先に確認してください。

関連メニュー