データフィードの作成

データフィードを作成する際には、次の情報をAdobeに提供します。

  • 生データファイルの送信先に関する情報

  • 各ファイルに含めるデータ

NOTE
データフィードを作成する前に、データフィードに関する基本的な知識を持ち、必要な前提条件をすべて満たしていることを確認することが重要です。 詳しくは、 データフィードの概要.

データフィードの作成と設定

  1. Adobe ID の資格情報を使用して experiencecloud.adobe.com にログインします。

  2. 右上の 9 つの四角形のアイコンを選択し、「 Analytics.

  3. 上部ナビゲーションバーで、に移動します。 管理者 > データフィード.

  4. 選択 追加.

    データフィードを追加

    ページが 3 つの主なカテゴリと共に表示されます。 フィード情報, 宛先、および データ列の定義.

  5. Adobe Analytics の フィード情報 「 」セクションで、次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
    フィールド 関数
    名前 データフィードの名前。 選択したレポートスイート内で一意である必要があり、最大 255 文字まで設定できます。
    レポートスイート データフィードの基になるレポートスイート。 同じレポートスイートに対して複数のデータフィードを作成する場合は、異なる列定義を持つ必要があります。データフィードをサポートするのはソースレポートスイートのみです。仮想レポートスイートはサポートされていません。
    完了時に電子メールを送信 フィードの処理が終了したときに通知される電子メールアドレス。 電子メールアドレスは正しい形式にする必要があります。
    フィード間隔 選択 毎日 :バックフィルまたは履歴データ用。 毎日のフィードには、レポートスイートのタイムゾーンの午前 0 時から午前 0 時までの 1 日分のデータが含まれます。 選択 1 時間ごと 継続データ用(希望する場合は、継続フィードでも Daily を使用できます)。 時間別フィードには、1 時間分のデータが含まれます。
    遅延処理 データフィードファイルを処理する前に、所定の時間待ちます。 遅延は、モバイル実装に、オフラインデバイスがオンラインになり、データを送信する機会を与えるのに役立ちます。また、以前に処理されたファイルを管理する際に、組織のサーバー側のプロセスに対応するためにも使用できます。ほとんどの場合、遅延は必要ありません。フィードは、最大 120 分遅れる可能性があります。
    開始日と終了日 開始日は、データフィードを開始する日付を示します。 履歴データのデータフィードの処理を直ちに開始するには、データを収集している過去の任意の日付にこの日付を設定します。 開始日と終了日は、レポートスイートのタイムゾーンに基づきます。
    連続フィード このチェックボックスを選択すると、終了日が削除され、フィードが無期限に実行されます。 フィードが履歴データの処理を完了すると、フィードはデータが特定の時間または日に収集を完了するのを待ちます。現在の時間または日が終わると、指定した遅延の後に処理が開始されます。
  6. Adobe Analytics の 宛先 セクション内の タイプ ドロップダウンメニューで、データを送信する宛先を選択します。

    note note
    NOTE
    レポートの宛先を設定する際は、次の点を考慮してください。
    • レポートの送信先には、クラウドアカウントを使用することをお勧めします。 レガシー FTP および SFTP アカウント は使用可能ですが、お勧めしません。

    • クラウドアカウントはAdobe Analyticsユーザーアカウントに関連付けられています。 他のユーザーは、設定したクラウドアカウントを使用または表示できません。

    データフィードの宛先ドロップダウンメニュー

    データフィードの作成時に、次のいずれかのタイプの宛先を使用します。 設定手順については、宛先のタイプを展開します。 ( 追加の 従来の宛先 はまた使用できますが、お勧めしません )。

    accordion
    Amazon S3

    フィードは Amazon S3 バケットに直接送信できます。この宛先タイプには、Amazon S3 アカウントと場所(バケット)のみが必要です。

    Adobe Analyticsは、クロスアカウント認証を使用して、Adobe AnalyticsからAmazon S3 インスタンスの指定した場所にファイルをアップロードします。

    Amazon S3 バケットをデータフィードの宛先として設定するには:

    1. Adobe Analytics Admin Console で、 宛先 セクション、選択 Amazon S3.

      Amazon S3 の宛先

    2. 選択 場所を選択.

      Amazon S3 の書き出し場所ページが表示されます。

    3. (条件付き)以前にAmazon S3 アカウントと場所を追加している場合:

      1. 次の中からアカウントを選択します: アカウントを選択 ドロップダウンメニュー。

      2. 次の場所から場所を選択します。 場所を選択 ドロップダウンメニュー。

      3. 選択 保存 > 保存.

        これで、宛先は、指定したAmazon S3 の場所にデータを送信するように設定されました。

    4. (条件付き)Amazon S3 アカウントをまだ追加していない場合は、次の手順に従います。

      1. 選択 アカウントを追加 ​次の情報を指定します。

        table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto
        フィールド 関数
        アカウント名 アカウントの名前。 任意の名前を指定できます。
        アカウントの説明 アカウントの説明。
        役割 ARN AdobeがAmazon S3 アカウントへのアクセス権を取得するために使用できる役割 ARN(Amazon Resource Name) を指定する必要があります。 これを行うには、ソースアカウントの IAM アクセス許可ポリシーを作成し、そのポリシーをユーザーに関連付けてから、宛先アカウントのロールを作成します。 詳しくは、 このAWSドキュメント.
        ユーザー ARN ユーザー ARN(Amazon Resource Name) は、Adobeが提供します。 作成したポリシーにこのユーザーを添付する必要があります。
      2. 選択 場所を追加 ​次の情報を指定します。

        table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto
        フィールド 関数
        名前 アカウントの名前。
        説明 アカウントの説明。
        バケット

        Adobe Analyticsデータを送信するAmazon S3 アカウント内のバケット。

        Adobeが提供したユーザー ARN に S3:PutObject 権限を持っています。 この権限を持つユーザー ARN は、以降のアップロードで、初期ファイルをアップロードし、ファイルを上書きできます。

        プレフィックス データを配置するバケット内のフォルダー。 フォルダー名を指定し、名前の後にバックスラッシュを追加してフォルダーを作成します。 例:folder_name/
      3. 選択 作成 > 保存.

        これで、宛先は、指定したAmazon S3 の場所にデータを送信するように設定されました。

    accordion
    Azure RBAC

    RBAC 認証を使用して、Azure コンテナに直接フィードを送信できます。 この宛先の種類には、アプリケーション ID、テナント ID、およびシークレットが必要です。

    Azure RBAC アカウントをデータフィードの宛先として設定するには:

    1. まだ認証にAdobe Analyticsが使用できる Azure アプリケーションを作成していない場合は、アクセス制御 (IAM) のアクセス権限を付与します。

      詳しくは、 Azure Active Directory アプリケーションの作成方法に関するMicrosoft Azure ドキュメント.

    2. Adobe Analytics Admin Console で、 宛先 セクション、選択 Azure RBAC.

      Azure RBAC の宛先

    3. 選択 場所を選択.

      Azure RBAC の書き出し場所ページが表示されます。

    4. (条件付き)以前に Azure RBAC アカウントと場所を追加している場合:

      1. 次の中からアカウントを選択します: アカウントを選択 ドロップダウンメニュー。

      2. 次の場所から場所を選択します。 場所を選択 ドロップダウンメニュー。

      3. 選択 保存 > 保存.

        これで、宛先は、指定した Azure RBAC の場所にデータを送信するように設定されました。

    5. (条件付き)以前に Azure RBAC アカウントを追加していない場合は、次の手順に従います。

      1. 選択 アカウントを追加 ​次の情報を指定します。

        table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto
        フィールド 関数
        アカウント名 Azure RBAC アカウントの名前。 この名前は、 アカウントを選択 ドロップダウンフィールドに含めることができます。任意の名前を指定できます。
        アカウントの説明 Azure RBAC アカウントの説明。 この説明は、 アカウントを選択 ドロップダウンフィールドに含めることができます。任意の名前を指定できます。
        アプリケーション ID 作成した Azure アプリケーションからこの ID をコピーします。 Microsoft Azure では、この情報は 概要 」タブをクリックします。 詳しくは、 Microsoft Azure ドキュメント:Microsoft identity platform でのアプリケーションの登録方法に関する.
        テナント ID 作成した Azure アプリケーションからこの ID をコピーします。 Microsoft Azure では、この情報は 概要 」タブをクリックします。 詳しくは、 Microsoft Azure ドキュメント:Microsoft identity platform でのアプリケーションの登録方法に関する.
        秘密鍵 作成した Azure アプリケーションからシークレットをコピーします。 Microsoft Azure では、この情報は 証明書と秘密鍵 」タブをクリックします。 詳しくは、 Microsoft Azure ドキュメント:Microsoft identity platform でのアプリケーションの登録方法に関する.
      2. 選択 場所を追加 ​次の情報を指定します。

        table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto
        フィールド 関数
        名前 場所の名前。 この名前は、 場所を選択 ドロップダウンフィールドに含めることができます。任意の名前を指定できます。
        説明 場所の説明。 この説明は、 場所を選択 ドロップダウンフィールドに含めることができます。任意の名前を指定できます。
        アカウント Azure ストレージアカウント。
        コンテナ Adobe Analyticsデータを送信するアカウント内のコンテナです。 前に作成した Azure アプリケーションにファイルをアップロードする権限を付与してください。
        プレフィックス

        データを配置するコンテナ内のフォルダーです。 フォルダー名を指定し、名前の後にバックスラッシュを追加してフォルダーを作成します。 例:folder_name/

        Azure RBAC アカウントの設定時に指定したアプリケーション ID が、 Storage Blob Data Contributor ロールを使用して、コンテナ(フォルダー)にアクセスできます。

        詳しくは、 Azure の組み込みの役割.

      3. 選択 作成 > 保存.

        これで、宛先は、指定した Azure RBAC の場所にデータを送信するように設定されました。

    accordion
    Azure SAS

    SAS 認証を使用して、Azure コンテナに直接フィードを送信できます。 この宛先の種類には、アプリケーション ID、テナント ID、キーボールト URI、キーボールト秘密鍵名、および秘密鍵が必要です。

    Azure SAS をデータフィードの宛先として設定するには:

    1. Adobe Analyticsが認証に使用できる Azure アプリケーションをまだ作成していない場合は、作成します。

      詳しくは、 Azure Active Directory アプリケーションの作成方法に関するMicrosoft Azure ドキュメント.

    2. Adobe Analytics Admin Console で、 宛先 セクション、選択 Azure SAS.

      Azure SAS の宛先

    3. 選択 場所を選択.

      「Azure SAS の書き出し場所」ページが表示されます。

    4. (条件付き)以前に Azure SAS アカウントと場所を追加した場合:

      1. 次の中からアカウントを選択します: アカウントを選択 ドロップダウンメニュー。

      2. 次の場所から場所を選択します。 場所を選択 ドロップダウンメニュー。

      3. 選択 保存 > 保存.

        これで、宛先は、指定した Azure SAS の場所にデータを送信するように設定されました。

    5. (条件付き)Azure SAS アカウントをまだ追加していない場合は、次の手順に従います。

      1. 選択 アカウントを追加 ​次の情報を指定します。

        table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto
        フィールド 関数
        アカウント名 Azure SAS アカウントの名前。 この名前は、 アカウントを選択 ドロップダウンフィールドに含めることができます。任意の名前を指定できます。
        アカウントの説明 Azure SAS アカウントの説明。 この説明は、 アカウントを選択 ドロップダウンフィールドに含めることができます。任意の名前を指定できます。
        アプリケーション ID 作成した Azure アプリケーションからこの ID をコピーします。 Microsoft Azure では、この情報は 概要 」タブをクリックします。 詳しくは、 Microsoft Azure ドキュメント:Microsoft identity platform でのアプリケーションの登録方法に関する.
        テナント ID 作成した Azure アプリケーションからこの ID をコピーします。 Microsoft Azure では、この情報は 概要 」タブをクリックします。 詳しくは、 Microsoft Azure ドキュメント:Microsoft identity platform でのアプリケーションの登録方法に関する.
        キーボールト URI

        Azure Key Vault の SAS トークンへのパス。 Azure SAS を構成するには、Azure Key Vault を使用して SAS トークンを秘密鍵として保存する必要があります。 詳しくは、 Azure Key Vault からシークレットを設定および取得する方法に関するMicrosoft Azure ドキュメント.

        キー Vault URI の作成後:

        • 作成した Azure アプリケーションに権限を付与するために、Key Vault にアクセスポリシーを追加します。

        • アプリケーション ID が Key Vault Certificate User キー vault URI にアクセスするための組み込みの役割です。

          詳しくは、 Azure の組み込みの役割.

        詳しくは、 Key Vault アクセスポリシーの割り当て方法に関するMicrosoft Azure ドキュメント.

        キー Vault の秘密鍵の名前 Azure Key Vault に秘密鍵を追加する際に作成した秘密鍵の名前。 Microsoft Azure では、この情報は、次の場所で作成した Key Vault 内の Key Vault 設定ページ。 詳しくは、 Azure Key Vault からシークレットを設定および取得する方法に関するMicrosoft Azure ドキュメント.
        秘密鍵 作成した Azure アプリケーションからシークレットをコピーします。 Microsoft Azure では、この情報は 証明書と秘密鍵 」タブをクリックします。 詳しくは、 Microsoft Azure ドキュメント:Microsoft identity platform でのアプリケーションの登録方法に関する.
      2. 選択 場所を追加 ​次の情報を指定します。

        table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto
        フィールド 関数
        名前 場所の名前。 この名前は、 場所を選択 ドロップダウンフィールドに含めることができます。任意の名前を指定できます。
        説明 場所の説明。 この説明は、 場所を選択 ドロップダウンフィールドに含めることができます。任意の名前を指定できます。
        コンテナ Adobe Analyticsデータを送信するアカウント内のコンテナです。
        プレフィックス

        データを配置するコンテナ内のフォルダーです。 フォルダー名を指定し、名前の後にバックスラッシュを追加してフォルダーを作成します。 例:folder_name/

        Azure SAS アカウントを構成する際に、Key Vault のシークレット名フィールドで指定した SAS トークンストアに、 Write 権限。 これにより、SAS トークンが Azure コンテナにファイルを作成できます。

        SAS トークンでファイルも上書きする場合は、SAS トークンストアに Delete 権限。

        詳しくは、 BLOB ストレージリソース (Azure BLOB ストレージのドキュメント)を参照してください。

      3. 選択 作成 > 保存.

        これで、宛先は、指定した Azure SAS の場所にデータを送信するように設定されました。

    accordion
    Google Cloud Platform

    フィードは、Google Cloud Platform(GCP) バケットに直接送信できます。 この宛先タイプには、GCP アカウント名と場所(バケット)名のみが必要です。

    Adobe Analyticsは、クロスアカウント認証を使用して、Adobe Analyticsから GCP インスタンスの指定した場所にファイルをアップロードします。

    GCP バケットをデータフィードの宛先として設定するには:

    1. Adobe Analytics Admin Console で、 宛先 セクション、選択 Google Cloud Platform.

      Google Cloud Platform の宛先

    2. 選択 場所を選択.

      「 GCP Export Locations 」ページが表示されます。

    3. (条件付き)以前に GCP アカウントと場所を追加した場合:

      1. 次の中からアカウントを選択します: アカウントを選択 ドロップダウンメニュー。

      2. 次の場所から場所を選択します。 場所を選択 ドロップダウンメニュー。

      3. 選択 保存 > 保存.

        これで、指定した GCP の場所にデータを送信するように宛先が設定されました。

    4. (条件付き)GCP アカウントをまだ追加していない場合は、次の手順に従います。

      1. 選択 アカウントを追加 ​次の情報を指定します。

        table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto
        フィールド 関数
        アカウント名 アカウントの名前。 任意の名前を指定できます。
        アカウントの説明 アカウントの説明。
        プロジェクト ID Google Cloud プロジェクト ID。 詳しくは、 プロジェクト ID の取得に関するGoogle Cloud ドキュメント.
      2. 選択 場所を追加 ​次の情報を指定します。

        table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto
        フィールド 関数
        プリンシパル プリンシパルはAdobeで提供されます。 このプリンシパルにフィードを受け取る権限を付与する必要があります。
        名前 アカウントの名前。
        説明 アカウントの説明。
        バケット

        Adobe Analyticsデータを送信する GCP アカウント内のバケット。

        Adobeが提供するプリンシパルに対して、次のいずれかの権限を付与していることを確認します。

        • roles/storage.objectCreator:プリンシパルで GCP アカウント内のファイルの作成のみを制限する場合は、この権限を使用します。
          重要: スケジュールされたレポートでこの権限を使用する場合は、新たにスケジュールされたエクスポートを作成するたびに一意のファイル名を使用する必要があります。 そうしないと、プリンシパルは既存のファイルを上書きするアクセス権を持たないので、レポートの生成に失敗します。
        • (推奨) roles/storage.objectUser:プリンシパルに、GCP アカウント内のファイルの表示、リスト、更新、削除のアクセス権を付与する場合は、この権限を使用します。
          この権限を持つプリンシパルは、以降のアップロードで既存のファイルを上書きできます。新しくスケジュールされた書き出しごとに一意のファイル名を自動生成する必要はありません。

        権限の付与について詳しくは、 プリンシパルをバケットレベルのポリシーに追加する ( Google Cloud ドキュメント ) を参照してください。

        プレフィックス データを配置するバケット内のフォルダー。 フォルダー名を指定し、名前の後にバックスラッシュを追加してフォルダーを作成します。 例:folder_name/
      3. 選択 作成 > 保存.

        これで、指定した GCP の場所にデータを送信するように宛先が設定されました。

  7. Adobe Analytics の データ列の定義 セクションで、最新の すべてのAdobe Columns ドロップダウンのテンプレートを選択し、次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
    フィールド 関数
    エスケープ文字を削除 データを収集する際に、一部の文字(改行など)が問題の原因となる場合があります。 フィードファイルからこれらの文字を削除する場合は、このチェックボックスをオンにします。
    圧縮形式 使用する圧縮のタイプ。 Gzip ファイルを出力 .tar.gz 形式を使用します。 郵便番号 ファイルを出力 .zip 形式を使用します。
    パッケージタイプ 選択 複数のファイル ほとんどのデータフィードで使用できます。 このオプションは、非圧縮の 2GB チャンクにデータをページ分けします。 (複数のファイルを選択し、レポートウィンドウの非圧縮データが 2GB 未満の場合、1 つのファイルが送信されます)。 選択 単一ファイル は、 hit_data.tsv ファイルを 1 つの、潜在的に大規模なファイルに格納します。
    マニフェスト

    Adobeが マニフェストファイル を宛先に送信する必要があります(フィード間隔でデータが収集されない場合)。 次を選択した場合、 マニフェストファイル ​に値を指定すると、データが収集されない場合に、次のようなマニフェストファイルを受け取ります。

    text

    Datafeed-Manifest-Version: 1.0

    Lookup-Files: 0

    Data-Files: 0

    Total-Records: 0

    列テンプレート 多数のデータフィードを作成する場合、Adobeでは列テンプレートを作成することをお勧めします。 列テンプレートを選択すると、指定した列が自動的にテンプレートに含まれます。また、アドビでは、デフォルトで複数のテンプレートを提供しています。
    使用可能な列 Adobe Analyticsで使用可能なすべてのデータ列。 「すべて追加」をクリックして、データフィードにすべての列を含めます。
    含まれる列 データフィードに含める列。 データフィードからすべての列を削除するには、すべて削除をクリックします。
    CSV をダウンロード 含まれるすべての列を含む CSV ファイルをダウンロードします。
  8. 選択 保存 をクリックします。

    履歴データの処理は直ちに開始されます。 データが 1 日分の処理を終了すると、ファイルは設定した宛先に送信されます。

    データフィードにアクセスする方法とその内容をより深く理解するには、 データフィードの内容 — 概要.

従来の宛先

IMPORTANT
この節で説明する宛先は従来のもので、お勧めしません。 データフィードを作成する際は、代わりに、 Amazon S3、Google Cloud Platform、Azure RBAC、Azure SAS のいずれかの宛先を使用してください。 詳しくは、 データフィードの作成と設定 を参照してください。

次の情報は、レガシーの各宛先の設定情報を示します。

FTP

データフィードのデータは、Adobeまたは顧客がホストする FTP の場所に配信できます。 FTP ホスト、ユーザー名、パスワードが必要です。パスフィールドを使用して、フィードファイルをフォルダーに配置します。フォルダーが既に存在する必要があります。指定されたパスが存在しない場合、フィードはエラーをスローします。

使用可能フィールドに入力する際は、次の情報を参照してください。

  • ホスト:目的の FTP の宛先 URL を入力します。 例:ftp://ftp.omniture.com
  • パス:空白のままにできます
  • ユーザー名:FTP サイトにログインするユーザー名を入力します。
  • パスワードとパスワードの確認:FTP サイトにログインするためのパスワードを入力します。

SFTP

データフィードの SFTP サポートを利用できます。SFTP ホスト、ユーザー名、および宛先サイトに有効な RSA または DSA 公開鍵が含まれている必要があります。フィードの作成時に、適切な公開キーをダウンロードできます。

S3

フィードは Amazon S3 バケットに直接送信できます。この宛先タイプには、バケット名、アクセスキー ID および秘密キーが必要です。詳しくは、Amazon S3 ドキュメント内の Amazon S3 バケットの命名要件を参照してください。

データフィードのアップロードに使用するユーザーには、次の権限が必要です。

以下の 16 の標準 AWS 地域がサポートされます(必要に応じて適切な署名アルゴリズムを使用)。

  • us-east-2
  • us-east-1
  • us-west-1
  • us-west-2
  • ap-south-1
  • ap-northeast-2
  • ap-southeast-1
  • ap-southeast-2
  • ap-northeast-1
  • ca-central-1
  • eu-central-1
  • eu-west-1
  • eu-west-2
  • eu-west-3
  • eu-north-1
  • sa-east-1
NOTE
Cn-north-1 地域はサポートされていません。

Azure BLOB

データフィードは Azure BLOB の宛先をサポートしています。コンテナ、アカウント、およびキーが必要です。Amazon は保存データを自動的に暗号化します。データをダウンロードすると、自動的に復号化されます。詳細については、Microsoft Azure ドキュメント内の「ストレージアカウントの作成」を参照してください。

NOTE
フィード宛先のディスク領域を管理するには、独自のプロセスを実装する必要があります。アドビはサーバーからデータを削除しません。
recommendation-more-help
6b7d49d5-f5fe-4b7f-91ae-5b0745755ed2