詳細情報:
ETL ファイルの要件
ETL ファイルには、ユーザー、商品、登録リストメンバー、プロモーション、取引などのエントリが含まれます。これらのファイルは CSV 形式で、暗号化または圧縮できます。ファイル形式は、各 ETL データフィードの明示的なスキーマ要件に従う必要があります。通常、ETL ファイルは SFTP サイトを使用して自動的にアップロードしますが、手動でファイルをアップロードすることもできます。
ファイル名と拡張子
- すべてのファイルは RFC-4180 CSV ファイル形式である必要があります。
- 文字コードは UTF-8 である必要があります。また、すべての最大長は UTF-8 でエンコードされたバイト数です。
- ETL ファイルは圧縮および暗号化できます。有効な圧縮ファイル拡張子は .zip および .gz です。有効な暗号化拡張子は .pgp です。
- ファイル名が ETL データフィードスキーマの定義された構造と一致しない限り、ファイルは処理されません。ETL ファイルのスキーマはカスタマイズできません。
- 各データフィードのファイル名の形式に一貫性を持たせる。ほとんどの条件下では、ETL データフィード名の後に日時が続きます (
user-yyyy-mm-dd_hh-mm-ss.csvなど)。Marketing Cloud Personalization では、複数のファイルが同時にアップロードされると、日付を使用してファイルが順番に処理されます。 - ETL 処理のために Automation Studio からファイルを送信する場合、ファイル名に分と秒を使用しないようにします。つまり、Automation Studio から 1 日に複数のファイルを処理する場合は、
user-yyyy-mm-dd_hh.csv形式でファイルに名前を付けます。Automation Studio から 1 日に 1 つのファイルのみを処理する場合は、user-yyyy-mm-dd.csv形式でファイルに名前を付けます。
ファイルヘッダー構造
組み込み ETL コンポーネントで処理されるファイルは、ETL 種別に関係なく一貫して処理されます。一部のデータフィードタイプでは、対象データ型のため追加のヘッダー定義にアクセスできますが、項目は通常いくつかの異なるカテゴリに分類されます。
| フィールド | 説明 |
|---|---|
id
|
アップロードする項目の ID。User ETL データフィードなど、このヘッダーの名前が若干異なる場合があります。
|
categories
|
この項目は、商品、記事、およびブログ投稿の組み込みカタログオブジェクトにのみ適用されます。 |
relatedCatalogObject
|
さまざまな ETL データフィードで関連カタログオブジェクトを処理する構造。 |
attribute
|
システムおよびカスタム属性定義を処理するための構造。Personalization では、スキーマで定義された属性種別として attribute: で始まるすべてのフィールド、またはカスタム属性の作成時に設定したすべてのフィールドが処理されます。カスタム属性を使用する場合、値は [パーソナライズ] で属性を表示するために使用される表示ラベルではなく、属性の一意の定義名である必要があります。カスタム日付属性は、Unix エポックタイムスタンプとして書式設定されます。 |
頻度
Personalization Gears システムには、SFTP サイトのファイル用のリスナーが組み込まれています。15 分ごとに、有効化された各 ETL データフィードで、その個々のデータフィードで予期されるファイル名構造に一致するファイルが/dataset/inboundディレクトリにあるかどうかが確認されます。ファイル処理頻度の一般的な推奨は毎日です。ただし、処理頻度の高いファイルが必要な場合や、古いデータを更新する必要がある場合は、1 時間ごとにファイルをアップロードすることを検討してください。アップロードの頻度が高いほど、システムでファイルを完全に処理する時間が確保され、ファイル処理キューが形成されなくなります。
システムフィールド
パーソナライズには、属性をサポートするいくつかの組み込みシステム項目があります。ETL データフィードのタイプごとに使用可能なシステム項目は異なり、明示的な処理プロセスがあります。システム属性と同じ名前の属性を作成すると、項目の名前属性を商品 ETL ファイルに含める場合など、データに悪影響を及ぼします。「name」はシステム項目ですが、Personalization は「attribute:name」列ヘッダーから読み取ります。[カタログおよびプロファイルオブジェクト] ページで商品カタログオブジェクトの「name」というカスタム属性を作成すると、ETL 処理中に悪影響が生じる可能性があります。
デフォルト値のリセット
User ETL データフィードを除き、すべての ETL データフィードで項目値をデフォルトにリセットできます (ID など、項目が必須の場合を除きます)。値のリセットは、処理中にレコードの列の値が空の場合に発生します。パーソナライズでは、値の不在が null として処理され、パーソナライズのレコードでそのキーの既存の値が削除されます。このプロセスを使用して、項目の古い説明を削除したり、トランザクションのカスタム属性を削除したり、商品のカテゴリを削除したりできます。
パーソナライズでは、各レコードには、デルタファイルでも各列に対応する値が含まれていることが想定されます。
設定解除値が不在値と若干異なる特定のシステム項目があります。これらのキーの一部は ETL タイプのサブセットにのみ適用されますが、次の表にすべてリストされています。
フィールド名 |
デフォルト値 |
|---|---|
price
|
0 |
listPrice
|
0 |
rating
|
0 |
numRatings
|
0 |
inventoryCount
|
1 (品目は在庫とみなされます) この値は、 |
published
|
1/1/1970 |
expiration
|
処理日 + 100 年 (2022 年 4 月 12 日に実行された場合、有効期限は 2021 年 4 月 12 日) |
promotable
|
True (項目は昇格可能) |
エラーとログ
- 列ヘッダーが ETL データフィードのスキーマの既存のシステム項目、カスタム属性、またはその他の有効な列ヘッダーと一致しない場合、Personalization はそれらのレコードをアップロードしません。列の値が有効なデータを反映していない場合、エラーが発生します。
- 「警告: 少なくとも 1 つの商品がアーカイブされています。更新は UI に表示されません」は、ETL ファイルの少なくとも 1 つの項目がアーカイブ済み状態であることを意味します。アイテムは、ETL ファイルに の
attribute:archived列ヘッダーと true の値を含めるか、カタログ内のアイテムの横にある [削除] をクリックするとアーカイブされます。アイテムをアーカイブ解除するには、ETL ファイル内に [attribute:archived] 列があり、アイテムの値が false であることを確認します。 - 「列または行の区切り文字が原因で抽出に失敗した可能性が最も高い」というエラーは、二重引用符が閉じられていない、値全体に余分なカンマがあるなどの文字ミスがあることを示します。
- ETL データフィードでエラーが発生すると、Personalization は各エラーメッセージを [ログ] ダイアログに記録します。ログには、エラーの原因となったファイル行番号が含まれます。
- エラーしきい値が 10% に達すると、パーソナライズは ETL ジョブに失敗します。エラーしきい値は変更できません。
- レコードの項目がヘッダーで示されるデータ型に正しく対応付けられていない場合、Personalization はレコードをスキップしてアップロードしません。この種のエラーのインスタンスが十分にある場合、Personalization は ETL ファイル全体を失敗します。
フィードの制限
フィード制限についての詳細は、「Limits for Marketing Cloud Personalization」を参照してください。
ファイルサイズの制限
推奨ファイルサイズ制限についての詳細は、「Limits for Marketing Cloud Personalization」を参照してください。
