分類データファイル(レガシー)
インポーターを使用すると、分類データをファイル内のAnalytics レポートに一括アップロードできます。 データのアップロードを正常におこなうために、インポートでは指定のファイル形式を使用する必要があります。
有効なデータファイルを作成するために、分類データを貼り付けることができるファイル構造を提供するテンプレートファイルをダウンロードできます。 詳しくは、分類テンプレートのダウンロードを参照してください。
分類での文字数制限について詳しくは、一般的なファイル構造を参照してください。
一般的なファイル構造
次の図は、データファイルの例です。
データファイルは、次の構造ルールに従う必要があります。
-
分類の値を0 (ゼロ)にすることはできません。
-
インポートおよびエクスポートする列の数を 30 以内にすることをお勧めします。
-
アップロードしたファイルは、BOM文字エンコーディングなしでUTF-8を使用する必要があります。
-
タブ、改行、引用符などの特殊文字は、バージョン 2.1 のファイル形式が指定されており、セルが適切にエスケープされている場合、セル内に埋め込むことができます。 特殊文字には次のものが含まれます。
code language-text \t tab character \r form feed character \n newline character " double quoteコンマは特殊文字ではありません。
-
分類名にはキャレット(^)を含めることはできません。この文字は下位分類を表すために使用されます。
-
ハイフンを使用する場合は注意してください。 例えば、Social のキーワードでハイフン(-)を使用すると、Social はハイフンを Not 演算子(マイナス記号)として認識します。 例えば、読み込むキーワードとして「
fragrance-free」を指定すると、Social はこのキーワードを「fraganceminusfree」と認識し、「fragrance」に関する投稿のみを収集し、「free」に関する投稿は収集されません。 -
レポートデータの分類では、文字数の制限が適用されます。 例えば、製品名が 100 文字(バイト)を超える製品の分類テキストファイル(
s.products)をアップロードしても、製品はレポートに表示されません。 トラッキングコードおよびすべてのカスタムコンバージョン変数(eVar)では、255 バイトを使用できます。 このポリシーは、同じ255 バイトの制限を受ける分類とサブ分類の列の値にも適用されます。 -
タブ区切りのデータファイルにします(スプレッドシートアプリケーションやテキストエディターを使用してテンプレートファイルを作成します)。
-
ファイルの拡張子は、
.tabまたは.txtにします。 -
シャープ記号(#)は、ユーザーのコメントとして行を識別します。 Adobeは、#で始まる行を無視します。
-
2 ポンド記号の後にSC (
## SC)が付いた場合、その行はレポートで使用される前処理ヘッダーコメントとして識別されます。 これらの行は削除しないでください。 -
分類の書き出しでは、キー内の改行文字が原因でキーが重複する場合があります。 FTPまたはブラウザーの書き出しでは、FTP アカウントの引用をオンにすることで解決できます。 これにより、各キーを改行文字で囲む引用符が配置されます。
-
インポートファイルの最初の行のセル C1には、分類がファイルの残りの部分で引用符の使用をどのように処理するかを決定するバージョン識別子が含まれています。
- v2.0では、引用符は無視され、引用符がすべて指定されたキーと値の一部であると仮定されます。 例えば、次の値を考えてみましょう。「これは「いくつかの値」です。 v2.0では、これを文字通り「これは「ある値」です」と解釈します。
- v2.1では、分類に対して、引用符がExcel ファイルで使用されるファイル形式の一部であると仮定するように指示しています。 そのため、v2.1では、上記の例を次のようにフォーマットします。これは「ある値」です。
- v2.1がファイルに指定されている場合に問題が発生する可能性がありますが、実際に必要なのはv2.0です。つまり、引用符がExcel形式で違法な方法で使用されている場合です。 例えば、「VP NO REPS」という値がある場合は、「S/l Dress w/ Overlay」を選択します。 v2.1では、この形式が正しくありません(値は引用符で囲まれ、実際の値の一部である引用符は引用符でエスケープする必要があります)。この時点を超えて分類は機能しません。
- ファイルのヘッダー(セル C1)を変更してファイル形式を v2.0 に変更するか、ファイル全体で Excel の引用符を正しく使用してください。
-
データファイルの最初の(コメントなし)行には、その列内の分類データを識別するために使用される列見出しが含まれています。 インポーターには、列見出しに対する特定の形式が必要です。 詳しくは、列見出しの形式を参照してください。
-
データファイルのヘッダー行のすぐ後には、データ行があります。 データの各行には、各列見出しのデータフィールドを含める必要があります。
-
データファイルは、Adobeがファイルに構造を提供し、分類データを正しく読み込むために使用する次の制御コードをサポートしています。
Adobeがこのエレメントに対して一意のIDを自動生成することをリクエストします。
キャンペーンコンテキストでは、この制御値はAdobeに対して、各クリエイティブ要素に識別子を割り当てるように指示します。 「キー」を参照してください。
列見出しの形式
分類ファイルは次の列見出しをサポートしています。
キー
各値はシステム全体で一意である必要があります。 このフィールドの値は、Web サイトの JavaScript ビーコンで Analytics の変数に割り当てられた値に対応しています。 この列のデータには、autogen や一意のトラッキングコードが含まれる場合があります。
分類列の見出し
さらに、データファイルでは、サブクラスやその他の特殊なデータ列を識別するために、次の見出し規則がサポートされています。
分類見出し
例えば、Campaigns^Ownerは、Campaign Owner個の値を含む列の見出しです。 同様に、Creative Elements^Sizeは、Creative Elements分類のSize下位分類を含む列の列見出しです。
分類のトラブルシューティング
- 一般的なアップロードの問題:不適切なファイル形式およびファイルの内容に起因する問題について説明したナレッジベース記事です。