埋め込みポイントスキームとデータ受け入れ

TE は、登録、ログイン、支払いなどの「イベント」を通じて製品内のユーザーの重要な行動を記録し、「イベント属性」は、登録ユーザーの「ソースチャネル」、「オペレーティングシステム」など、イベントが発生したときの関連情報を記述します。「ユーザー属性」でユーザーごととその最新の状態、例えばユーザーの性別、等級、累積チャージ金額を記述する。

TE システムを使用して分析する前に、データ要件は分析要件と組み合わせて、収集するイベント、イベント属性、およびユーザー属性を確認し、埋め込みポイントスキームを形成します。データ開発者は確定した埋設点案に基づいて、埋設点の実施を行い、タイムリー、正確、完全な報告データは、データ分析を実現する基盤である。

実践の過程で、よく見られるデータ開発者はツールのサポートが不足し、データの問題をタイムリーに特定できず、埋設点データが不足し、属性報告タイプと計画タイプが一致しないなどの問題が発生し、報告したデータが分析できないデータ需要者はデータを分析する前に、埋設点データの品質を知り、分析結果の可用性を保証する必要がある。

埋込点案とデータ検査機能は以上の埋込点過程でよく見られる問題を解決することを目的としており、埋込点案をアップロードし、データ処理ルールを設定し、データ検査などの機能を行うことで、埋込点データの品質を保障する。モジュールの機能は次のとおりです。

• 埋立地計画を管理する:埋立地計画を TE プラットフォームにアップロードして統一的に管理し、埋立地の変更を記録し、埋立地を実施する根拠
• データ処理ルールの設定:埋め込みポイントスキームをデータ収集基準とし、ETL データ処理ルールを設定し、入庫データの正確性を保証
• データ検査を行う:実際にアップロードしたデータと埋め込みポイント案の違いを取得し、埋め込みポイントコードを絶えず最適化し、データ品質を着実に向上

I.埋立地プログラムの管理

このセクションには、埋め込みスキームの追加、埋め込みスキームの表示、および埋め込みスキームの変更に関する操作手順が含まれます。

1.1 埋め込みポイントスキームの追加

デフォルトのプロジェクト管理者とオーバーチューブユーザーは、3 つの部分を含む埋め込みスキームを追加できます

(1)埋め込み事件:収集すべき事件と事件属性

(2)共通イベント属性:各イベントに作用する属性は、共通イベント属性としてアップロードすることができる。共通イベント属性は、埋め込み時に手動で設定する必要があり、設定方法は各アクセス側のマニュアルを参照してください。

(3)ユーザー属性:収集するユーザー属性を記録する

TIP

データ処理ルールとデータ受け入れ機能はプリセット属性には有効ではない。マルチエンドアクセスがない場合、プロパティの整列が必要な場合は、埋め込みポイントスキームで事前に設定された属性情報

• [一括アップロード]または[1 つずつ追加]のいずれかを選択できます。一括アップロード時に、TE埋め込みスキームテンプレートフォーマットに従って埋め込みスキームを整理し、埋め込みスキームページにインポートします。
• 製品が反復し、少量の埋め込みポイントを追加する必要がある場合は、[1 つずつ追加]埋め込みポイントを選択し、現在のシナリオに基づいて埋め込みポイントイベント、イベント属性、またはユーザー属性情報を追加できます。

あなたのプロジェクトにデータが報告されている場合、既存の埋め込みポイントに基づいて埋め込みポイント計画のメンテナンスを行いたい場合は、「埋め込みポイントを報告した」を選択します。注意:

• この操作の同期コンテンツには、プリセットプロパティ
• TE は「パブリックイベントプロパティ」を認識できないため、すべてのイベントプロパティは「埋め込みイベント」に同期されます

1.2 埋没ポイントスキームの

TIP

イベントまたはプロパティの前にあるステータス ID から、イベントまたはプロパティにデータがアップロードされているかどうかを判断できます。「緑」は既存のデータが報告されていることを表します「灰色」は報告されていないことを表します。

(1)埋め込みポイント事件名をクリックすると、その事件の詳細情報

(2)「イベント名」、「表示名」、「イベント説明」、「作成者」などの情報を検索してリストを選別

(3)「属性で見る」をクリックすると、ある非公共イベント属性を選択し、その属性に関連するイベントリスト

埋め込みイベントを追加する場合は、必要に応じてイベントにラベルを追加し、イベントラベルごとに分類して表示できます。埋め込みプラットフォーム、イベントが属する製品モジュールなどの分類基準に基づいて分類ラベルを作成できます。

1.3 編集埋込点案

1.3.1 埋立地案の修正

埋め込みスキームを追加した後、埋め込みスキームは必要に応じて編集できます。イベント、パブリックイベント属性、ユーザー属性の後の編集ボタンをクリックするか、詳細カードの上の編集をクリックすると編集状態に

（1）イベントの編集ルール

イベント	ステータスの編集
イベント名	イベントが報告されていない場合は編集できます。イベントは報告されており、編集できません
表示名	編集可能
イベントタグ	編集可能
イベントの説明	編集可能

(2)イベント属性の編集ルール

イベントプロパティ	ステータスの編集
プロパティ名	編集不可
表示名	編集可能
プロパティの種類	編集可能
プロパティの説明	編集可能

注意

同じイベントプロパティは、複数のイベントに関連付けられます。イベントの詳細ページでイベントの属性表示名、属性タイプ、または属性説明を編集すると、他のイベントでのその属性情報も同時に変更されます。

(3)ユーザー属性の編集ルール

ユーザープロパティ	ステータスの編集
プロパティ名	編集不可
表示名	編集可能
プロパティの種類	編集可能
更新方法	編集可能
プロパティラベル	編集可能
プロパティの説明	編集可能

1.3.2 埋め込みポイントスキームの削除

(1)埋め込みポイントスキームでのイベント、イベント属性、またはユーザー属性を削除することができます。埋め込みスキームのイベントまたはプロパティの削除は、埋め込みスキームからの削除のみを表し、報告されたデータを実際に削除するものではありません。

(2)操作欄の「もっと」をクリックすると、「埋めたポイント案を空にする」を選択できます。この操作は、埋め込みイベント、共通イベント属性、およびユーザー属性のコンテンツを同時にクリアし、クリア後に再アップロードすることを選択できます。

二、データ処理ルールを設定する

TE はデフォルトで属性に応じて最初に入庫したときのデータ型を属性型とする。実際にデータを報告する過程で、属性報告タイプと期待タイプが一致しない、報告したデータが分析をサポートできない、後期修復コストが高いなどの問題がよく見られる。この機能モジュールはアップロードされた埋込点案をデータ収集基準とし、入庫データと埋込点情報を比較し、報告差異がある場合のデータ処理ルールを設定する。不整合なデータを効果的に回避し、データ報告初期に報告データと計画データの整合性を保証する。

埋め込みポイントスキームをアップロードした後、TE オーバーチューブまたは管理者は、プロジェクト管理でデータ処理ルールを設定できます。デフォルトの ETL データ処理ルールに基づいて、埋め込みスキームに基づくデータチェックをオンにするかどうかを選択します。設定内容:

• 埋没ポイント案にない事象 → 入庫可否
• 埋め込みポイントスキームにないイベント属性(埋め込みポイントスキームのすべてのイベントで存在しないイベント属性)→ 入庫可能か
• 埋め込みポイントスキームにないユーザー属性 → 入庫可能かどうか
• 埋め込みポイントスキームで「属性タイプが一致しない」イベント属性やユーザー属性 → 入庫可能かどうか

注意

データ処理ルールは、新しく報告され、メタデータが生成されていないイベントまたはプロパティに対してのみ有効です。

たとえば、「チャージ」イベントは埋め込みポイントスキームに記録されていませんが、イベントにはデータが報告されています。「埋め込みポイントプランにないイベントが入庫しない」を選択した場合、このルールは「チャージ」イベントには有効ではない。

デフォルトのプロジェクトは「自由報告モード」に構成されている。つまり、埋め込みポイント方式は ETL データ処理ルールに影響を与えず、「強検証モード」または「カスタムモード」に切り替えることができる。強検証モードでは、データ処理ルールは次のように説明されています

イベントルール :埋め込みプログラムにないイベント → 入庫しない:つまり、埋め込みプログラムで完全な埋め込み情報を維持してから、データを報告する必要があります。このルールは、計画にない汚れたデータの入庫を防止します。

属性ルール:埋め込みスキームにないイベント属性/ユーザー属性 → 破棄属性を含み、埋め込みスキームの属性タイプと一致しない → 破棄属性。この規則は無効な属性の入庫を防止し、実際の属性タイプと埋め込みポイントスキーム属性タイプを比較することで、属性が所望の属性タイプで入庫することを保証する。

注:プロパティルールの有効範囲にはカスタムプロパティのみが含まれ、TEプリセットプロパティは有効ではありません。

設定後、メンバーは[埋め込みポイントシナリオ]ページで現在のプロジェクトのデータ処理ルール設定を確認できます

三、データ検査

埋め込み計画をアップロードしてデータを報告した後、データの検査を行い、報告されたデータの品質を取得することができます。検査結果は次の 2 つの部分

• 報告データと埋め込みプログラムのすべての違い:埋め込みイベントがすべて報告されているかどうか、計画外イベントがあるかどうか(埋め込みプログラムにないイベント)を含む属性が欠けているかどうか、計画外属性(埋め込みプログラムにない属性)があるかどうか、報告属性タイプが期待タイプと一致しない場合
• 報告されたプロパティの null レート: null レートのしきい値の設定がサポートされており、プロパティの null レートがしきい値より大きい場合は、受け入れ結果に例外

注意

データ受け入れ範囲にはイベントとカスタム属性が含まれ、プリセット属性は受け入れられません。

3.1 データ検収を行う

ページの右上隅にある「データの受け入れを行う」をクリックすると、受け入れルールを構成できます。

（1）インシデントデータの受け入れ

「検査イベントデータ」をクリックして選択すると、検査のデータ範囲を設定できます。イベント時間、イベント範囲、フィルター条件を含む:

• イベント時間:イベントを受け入れる時間範囲は、デフォルトで昨日で、カスタマイズできます。この時刻は、レポートされたデータの#time フィールドを参照し、プロジェクトのタイムゾーンによってオフセット
• イベント範囲:検査が必要なイベント、デフォルトの全イベント、イベント範囲をカスタマイズできます。新しいバージョンで追加された埋め込みポイントイベントを選択してデータを受け入れます
• フィルタリング条件:イベントデータをフィルタリングできます。クライアント SDK から報告されたデータを収集する場合は、ソースのデータを指定して確認

[次へ]をクリックして、プロパティの null レートの受け入れルールを設定します。ヌルレートしきい値と統計ルールを含む:

• null レートしきい値: null レートしきい値を設定し、報告されたプロパティ null レートがしきい値を超えると、受け入れ結果に例外
• 統計ルール:空の文字列をプロパティの null レート

（2）ユーザーデータの受け入れ

「ユーザーデータの受け入れ」をクリックして選択すると、受け入れたユーザーデータの範囲と属性の空率受け入れルールを設定できます。同じ検査イベントデータ。

3.2 検収結果の閲覧

受け入れ記録後の操作をクリックすると、受け入れ結果レポートを表示できます。イベントデータの受け入れ結果には、次のシナリオが含まれます。

検収結果	結果の説明
成功する	報告されたデータは埋め込みポイントスキームと一致し、属性の空率は設定されたしきい値を
報告しない	選択した検査範囲内で、事件はデータ報告されていない
異常です	次の場合、イベント例外として記録されます。 1.埋め込みポイントスキームにないイベントがあります 2.埋め込みポイントスキームには存在しませんが、実際に報告されたプロパティ 3.属性の欠落が存在する、つまり埋没点スキームではあるが、実際には報告されていない属性 4.報告された属性タイプと埋め込みポイントスキームの属性タイプが一致しない 5.プロパティのnull率が設定されたしきい値を超えています

ユーザーデータの受け入れ結果は次のとおりです

検収結果	結果の説明
成功する	報告された属性データは埋め込みポイントスキームと一致し、属性ヌル率は設定されたしきい値を
異常です	次の場合、ユーザー属性例外として記録されます。 1.埋め込みポイントシナリオにないユーザープロパティ 2.属性の欠落:つまり、埋め込みポイントスキームではあるが、実際には報告されていないユーザー属性 3.報告されたプロパティタイプは、埋め込みポイントスキームのプロパティタイプと一致しません 4.プロパティのnull率が設定されたしきい値を超えています