---
title: "エクスポート時のデータ"
slug: "data-in-the-export"
abstract: "Sitecore CDPのオーディエンスエクスポートで利用可能なデータと、出力に含める内容の決定方法についてです。"
---
# エクスポート時のデータ

このトピックでは、エクスポート可能なデータと、出力に何を含めるかの決定方法について説明します。

## セグメント内のゲストは輸出の基盤となります

オーディエンスのエクスポートはセグメント内のゲストからのデータに基づいています。 *Scheduled*または*Live*セグメントからは、オーディエンスをエクスポートし、ストリームAPI、バッチAPI、REST APIを使って[Sitecore CDPに送信](https://doc.sitecore.com/cdp/en/developers/api/en/sending-guest-data.html) されるゲストデータ(注文、イベント、延長データなど)を含めることができ、[ゲストプロファイルで利用](https://doc.sitecore.com/cdp/ja/users/sitecore-cdp/data-availability-in-sitecore-cdp/data-availability-in-sitecore-cdp.html "Data availability in Sitecore CDP")可能です。

> !重要セグメントを即座に作成し、オーディエンスエクスポートに利用できます。ただし、セグメントに含まれるゲストは前夜の深夜(UTC)までのデータのスナップショットに基づいています。例えば、過去1週間以内に購入したゲストのオーディエンスをエクスポートしたい場合、前夜0時(UTC)以降に購入したゲストは、セグメント構築に使われたデータのスナップショットには翌日まで含まれません。

### セグメント部分群

完全なオーディエンスエクスポートを作成する際は、選択したセグメントにフィルターをかけることができます。これにより、適切なオーディエンスをエクスポートする際に役立ちます。フィルターは開発者が手動で作成した [カスタム条件](https://doc.sitecore.com/cdp/ja/users/sitecore-cdp/developer-center/conditions/conditions.html "Conditions") に基づいています。

例えば、すべてのロイヤルティメンバーのセグメントがある場合、フィルターを使って特定の国や地域に関連するゲストのみをエクスポート対象に選択できます。または、過去1年以内にウェブサイトで注文を完了したゲストセグメントを考えてみましょう。フィルターを使うことで、過去2週間以内にウェブサイトで商品を検索したゲストのみを選択し、エクスポートにはこのサブグループのみを含めることができます。

## 全輸出とデルタ輸出

オーディエンスエクスポートを作成する際は、データセット全体をエクスポートするかデルタのみをエクスポートするかを選択します。

フルエクスポートには、後のステップで指定した全オーディエンスが含まれます。フルエクスポートは即時に実行することも、スケジュールされた間隔で実行することも可能です。例えば、毎日、週次、カスタムスケジュールで。

対照的に、デルタのエクスポートは1日1回実行されます。最初のエクスポートは完全なエクスポートと同じで、後のステップで指定した全オーディエンスを含みます。しかし、その後のエクスポートには、前回のラン以降セグメントに追加されたゲストと、前回以降セグメントから削除されたゲストのデータのみが含まれます。出力には削除されたゲストから追加されたゲスト用の [別ファイルが含まれ](https://doc.sitecore.com/cdp/ja/users/sitecore-cdp/audience-export/the-output-of-an-export.html#UUID-41e5dc72-4061-fd28-8ee6-58ce253fa513_section-idm4556678604860833879964884338 "Contents of the output") ているため、区別できます。

### 例

過去7日間にあなたのウェブサイトを訪れたゲストのセグメントを考えてみましょう。このセグメントは毎日変更され、一部のゲストが追加され、一部は毎日削除されます。

このオーディエンスをフルエクスポートでエクスポートすると、エクスポートが実行される際に、その時点でセグメントに属しているすべてのゲストがすべてのエクスポートに含まれます。

デルタエクスポートでこのオーディエンスをエクスポートすると、最初のエクスポートはフルエクスポートのように動作します。しかし次にデルタエクスポートを実行するときは、以下のゲストが含まれるようになります:

-   前回の公演当時は訪問者ではありませんでしたが、その後ゲストが増えて訪問者になりました。
-   前回のランの時には訪問者でしたが、それ以降は訪れていません(ゲストは削除されました)。

エクスポートには、前回と現在の運行時に訪問者だったゲストは含まれません。

### 適切な輸出タイプの選択

フルエクスポートとデルタエクスポートのどちらを選ぶ際は、オーディエンスをアクティベートする外部システムの要件を考慮してください。システムはデルタに対してより適している場合もあれば、それしか受け入れない場合もあります。

## 出力にデータを含める

オーディエンスエクスポートの「 **出力構造** 」タブで、どのデータとどの構造を含めるかを選びます。 **「列を追加**」をクリックすると、**String**フィールドと **ヘッダー** フィールド、**Attribute値** フィールドが表示されます。

**ヘッダー**フィールドでは、例えば*メール*など任意のユニークなテキストを入力できます。ヘッダーは、出力に[ヘッダーを含める](https://doc.sitecore.com/cdp/ja/users/sitecore-cdp/audience-export/the-output-of-an-export.html#UUID-41e5dc72-4061-fd28-8ee6-58ce253fa513_section-idm4613842249656033871475652859 "File formats")場合、CSV出力の最初の行に表示され、JSON出力のすべてのJSONオブジェクトのキー名として表示されます。

文字列フィールドの**Attribute value**フィールドには、以下のデータを含めることができます:

-   例えば *「20EuroOff」*のように、ダブルクォートで囲まれたハードコードされたテキスト。
-   [ゲストプロフィール内の](https://doc.sitecore.com/cdp/ja/users/sitecore-cdp/data-availability-in-sitecore-cdp/available-data-types/guest-data.html "Guest data")動的データの参照、例えば*${guest.email}*や*${guest.lastSeen}*など。
-   [JavaScriptで計算された動的カスタムデータの](https://doc.sitecore.com/cdp/ja/users/sitecore-cdp/audience-export/javascript-in-the-export.html "JavaScript in the export")参照、例えば*${jsResult.pageViewCount}*。
-   [JavaScriptユーティリティ関数は](https://doc.sitecore.com/cdp/ja/users/sitecore-cdp/audience-export/utility-functions.html "Utility functions")、例えば *${getDataExtension(guest.dataExtensions, "ext1", "MemberCardCategory", "not-available")}*を呼び出します。

> !注動的データを参照するには、FreeMarker変数表記法${}を使用します。動的データはオーディエンスエクスポートを実行する際に計算されます。
> 
> ゲストプロファイルの動的データを参照するには、「 **Data** 」タブをクリックし、**Guest data model**からパスをコピーすることもできます。

フィールドタイプを**ナンバー**フィールドに変更できます。ナンバーフィールドは、文字列化された代替形式("10"、"9.99")ではなく、ハードコーディングまたは計算された整数点や浮動点(10、9.99)を数値化したものを含めたい場合に便利です。数フィールドでは、次のように指定できます:

-   **最大桁数** - その数字の最大桁数。結果はこの桁数に丸められます。デフォルトは10です。この値は小数点数の最大数より大きくなければなりません。
-   **小数** 点数の最大数 - 小数点の右側にある最大桁数。デフォルトは2桁です。この値は桁数の最大数より小さい必要があります。

![String fields and number fields in the output structure of an audience export.](https://doc.sitecore.com/api/markdown-image/cdp/ja/users/sitecore-cdp/images/cdp-audience-export-js-3.jpg)

変更を保存した後は、属性値が正しいかを確認するために [オーディエンスエクスポートをテスト](https://doc.sitecore.com/cdp/ja/users/sitecore-cdp/audience-export/testing-the-export.html "Testing the export") することをお勧めします。