分類データファイル(レガシー)

WARNING
分類インポーターは、2026年8月31日(PT)に廃止されます。 引き続き機能を確保するには、分類セットエクスペリエンスを使用するように切り替えてください。

インポーターを使用すると、分類データをファイル内の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 はこのキーワードを「fragance minus free」と認識し、「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がファイルに構造を提供し、分類データを正しく読み込むために使用する次の制御コードをサポートしています。

制御コード
DESCRIPTION
<新しい行>
新しい行文字は、データファイル内のデータ行/レコード間でサポートされる唯一の区切り文字です。 通常、データファイルを自動生成するプログラムを作成する際に、これらの文字を具体的に挿入するだけで済みます。
~autogen~

Adobeがこのエレメントに対して一意のIDを自動生成することをリクエストします。

キャンペーンコンテキストでは、この制御値はAdobeに対して、各クリエイティブ要素に識別子を割り当てるように指示します。 「キー」を参照してください。

~period~
データ列が、項目に関連付けられた日付範囲を表すことを指定します。 「日付」を参照してください。
空のフィールド
現在のフィールドのNULL値を表します。 特定のデータ列が現在のレコードに適用されない場合に使用します。
PER修飾子
データ列が PER 修飾子のフィールドを示すことを指定します。 PER 修飾子の見出しを参照してください。

列見出しの形式

NOTE
インポートおよびエクスポートする列の数を 30 以内にすることをお勧めします。

分類ファイルは次の列見出しをサポートしています。

キー

各値はシステム全体で一意である必要があります。 このフィールドの値は、Web サイトの JavaScript ビーコンで Analytics の変数に割り当てられた値に対応しています。 この列のデータには、autogen や一意のトラッキングコードが含まれる場合があります。

分類列の見出し

NOTE
分類列の見出しの値は、分類の名前に完全に合致する必要があります。合致していない場合、インポートに失敗します。 例えば、管理者がキャンペーン設定マネージャーで「キャンペーン」から「内部キャンペーン名」に変更した場合は、ファイルの列見出しを同様に変更する必要があります。 「キー」は予約済みの分類(ヘッダー)値です。 「キー」という名前の新しい分類はサポートされていません。

さらに、データファイルでは、サブクラスやその他の特殊なデータ列を識別するために、次の見出し規則がサポートされています。

分類見出し

例えば、Campaigns^Ownerは、Campaign Owner個の値を含む列の見出しです。 同様に、Creative Elements^Sizeは、Creative Elements分類のSize下位分類を含む列の列見出しです。

分類のトラブルシューティング

recommendation-more-help
analytics-help-components