Dataphin は、バッチクエリインターフェイスを使用して、オーディエンスグループ ID とタグ値のページングクエリの実行をサポートしています。ページングクエリを実行するには、まずオーディエンスグループとタグのデータを Elasticsearch データソースにエクスポートする必要があります。その後、提供された API を使用して、エクスポートされたオーディエンスグループ ID とそれに関連付けられたタグ値に対してページングクエリを実行できます。このガイドでは、オーディエンスグループのページングクエリを作成および管理する方法について説明します。
前提条件
オーディエンスグループのページングクエリサービスを作成する前に、オーディエンスグループアセットマーケットから必要なオーディエンスグループを選択し、サービスをホストしているアプリケーション内で使用するための権限を取得していることを確認してください。詳細については、「オーディエンスグループの権限をリクエストする」をご参照ください。
オーディエンスグループのページングクエリサービスを利用するアプリケーションを作成済みであること。詳細については、「アプリケーションの作成」をご参照ください。
クエリサービスを提供する Elasticsearch データソースを構成済みであること。詳細については、「Elasticsearch データソースの作成」をご参照ください。
考慮事項
オーディエンスグループのページングクエリサービスが開始されると、システムはまずターゲットインデックスの既存のデータを削除してから、新しいデータを書き込みます。そのため、サービスの開始から完了までの間、ページングクエリ結果は空であるため正しくありません。
オーディエンスグループのページングクエリで使用されているタグが削除されると、クエリは空の値を返します。タグを置き換えるには、元のタグを保持し、新しいタグを追加し、それを使用するアプリケーションを更新した後に古いタグを削除することをお勧めします。
行動プリファレンスタグはエクスポートできません。
作成 ページングクエリ サービス (オーディエンスグループ向け)
Dataphin ホームページで、トップメニューバーに移動し、[タグ] > [タグアプリケーション] を選択します。
左側の [サービス管理] > [ページンググループクエリ] を選択します。
[ページンググループクエリ] ページで、[クエリサービスの作成] をクリックします。
[クエリサービスの作成] 構成ページに移動し、パラメータを設定します。
パラメータ
説明
基本情報
タスク名
タスクの名前を入力します。
小文字で始まり、小文字、数字、アンダースコア(_)のみを含める必要があります。長さは最大 64 文字です。
アプリケーションの選択
プロジェクトに関連付けられているアプリケーションを選択します。
説明プロジェクトに関連付けられているアプリケーションのみがオフラインサービスを作成できます。
権限を持つアプリケーションのみがサポートされます。
所有者
オフラインサービスの所有者を選択します。キーワードで検索できます。
スケジュールタイプ
繰り返しスケジュールと手動スケジュールのタスクタイプをサポートしています。
手動スケジュール: 1 回限りの統合。タスクが公開された後、タスクリストページで手動実行を選択できます。
繰り返しスケジュール: 構成されたサイクルに基づいてスケジュールされた実行。
説明
簡単な説明を入力します。長さは最大 1000 文字です。
フィールドマッピング
グループの選択
ページングクエリ用のオーディエンスグループを選択します。
タグ同期が必要ですか
デフォルトは いいえ で、オーディエンスグループのエンティティ ID のみを同期します。はい を選択すると、入力タグ で同期するタグを選択できます。
ターゲットデータソース
Elasticsearch タイプのデータソースインスタンスの選択をサポートしています。
インデックス
ターゲット Elasticsearch データソースのインデックスを選択します。対応するインデックスがない場合は、入力タグを選択した後、[インデックスの作成] をクリックし、[インデックスの作成] ダイアログボックスで必要なインデックスを作成できます。
[インデックスの作成] ダイアログボックスで、インデックス情報を構成します。
インデックス名: インデックス名を入力します。
ハイフン (-)、アンダースコア (_)、またはプラス記号 (+) で始めることはできません。
漢字、大文字、スラッシュ (/)、バックスラッシュ (\)、縦線 (|)、アスタリスク (*)、半角疑問符 (?)、半角コロン (:)、半角ピリオド (.)、半角引用符 (")、ハッシュ記号 (#)、山かっこ (<>)、またはスペースはサポートしていません。
長さは最大 255 文字です。
マッピングフィールド: フィールド名を入力し、フィールドタイプを選択します。複数のフィールドを追加できます。
フィールド名: 小文字で始まり、小文字、数字、アンダースコア(_)のみを含める必要があります。長さは最大 64 文字です。
フィールドタイプ: 対応するフィールドのフィールドタイプを選択します。
説明タグにルックアップテーブルがある場合、システムはデフォルトでタグのコード名を作成します。
[OK] をクリックします。
読み込みポリシー
デフォルトは 上書きポリシー で、変更できません。
入力タグ
マッピングするタグを選択し、
ボタンをクリックしてフィールドマッピング関係を構成します。説明この項目は、タグ同期が必要ですか が選択されている場合にのみ構成する必要があります。
アプリケーションが権限を取得しているオーディエンスグループのエンティティ ID に関連するタグのみをサポートします。
マッピング関係
システムは、選択されたタグとそのマッピングフィールド関係を表示します。出力タグマッピングのマッピングフィールドを選択する必要があります。
同じ名前のマッピング: [同じ名前のマッピング] をクリックして、タグとそのマッピングフィールドを同じ名前で関連付けます。
消去:
アイコンをクリックして、マッピングされた関係を消去します。出力コンテンツ: 構成されたルックアップテーブルを持つタグの出力コンテンツを選択します。タグ値 と コード名 を選択できます。デフォルトでは、すべてのタグ値が選択されています。すべてのページを選択するには、出力タグリストの下にある タグ値 と コード名 を選択します。
説明この項目は、タグ同期が必要ですか が選択されている場合にのみ構成する必要があります。
操作構成
スケジュールサイクル
特定の時間範囲内でのタスクをスケジュールするためのサイクル。日次スケジュールをサポートしています。タグのオフラインタスクは、構成されたスケジュール時間に従って毎日実行されます。
重要開始後、インデックス内のデータは削除されます。新しいデータが正常に書き込まれるまで、ページングクエリ結果は空で、サービスは非アクティブな状態です。スケジュール時間は、ビジネスが使用されていない時間帯に設定するか、ユーザーに使用可能な時間を通知することをお勧めします。
[公開] をクリックして、オーディエンスグループのページングクエリサービスの作成を完了します。
オーディエンスグループのページングクエリの管理
オーディエンスグループのページングクエリページには、タスク名、所有者、アプリケーション名、オーディエンスグループ名、エンティティ、エンティティ ID、タスクステータス、実行ステータス、スケジュールタイプ、使用可能な操作などの詳細が表示されます。
(オプション) [自分のタスクのみ] を選択し、タスク名を入力するか、アプリケーション名、エンティティ-エンティティ ID、ターゲットソースタイプ、タスクステータス、実行ステータス、スケジュールタイプ に基づいて [フィルター] オプションを使用してフィルターを適用できます。
オーディエンスグループのページングクエリページリストの [アクション] 列では、さまざまな操作を実行できます。
操作項目
説明
編集
タスクステータスが 公開中 または 非公開中 でない場合は、
アイコンをクリックして [オフラインサービスの編集] ページで編集し、再公開できます。タスク名、スケジュールタイプ、および読み込みポリシーの変更はサポートされていません。詳細
アイコンをクリックして、[オフラインサービスの表示] ページで現在のタグオフラインサービスの詳細情報を表示します。タスクステータスが 編集中、公開失敗、公開済み、または 非公開 の場合は、ページ下部の [編集] をクリックして、現在のオーディエンスグループのページングクエリサービスを編集できます。インスタンスの表示
アイコンをクリックして、現在のオーディエンスグループのページングクエリサービスによって生成された実行インスタンスを表示します。非公開
タスクステータス が 公開済み または 非公開失敗 の場合は、
非公開アイコンをクリックして、現在のオーディエンスグループのページングクエリサービスを非公開にできます。説明サービスを非公開にしても、ターゲットデータソース内のターゲットテーブルと中間一時テーブルは削除されません。
データバックフィル
実行ステータス が 実行中 の場合は、
データバックフィルアイコンをクリックしてデータバックフィルを実行できます。デフォルトでは、データバックフィルは前日 (T-1) のデータに対して行われます。実行
手動スケジュール タイプのタスクの場合、
実行アイコンをクリックして、データタイムスタンプ を選択することで、実行 ダイアログボックスで手動で実行できます。呼び出しコードの表示
ページングクエリサービスのリクエストパスと呼び出しコードを表示します。
削除
タスクステータスが 非公開 または 公開失敗 の場合は、
削除アイコンをクリックして、現在のオーディエンスグループのページングクエリサービスを削除できます。