カスタムコンテンツ属性の付与

概要

Piano Insight では、ページをクロールして、そのページからキーワードを抽出します。

キーワードとは別にカスタムの属性を各ページに付与することができます。

カスタムのコンテンツ属性の付与方法として、下記の3種類の方法があります。

metaタグによる属性の付与
指定したURLのパターンに合致したページヘの属性の付与
カスタムカテゴリーによる属性の付与

1. metaタグによる属性の付与

head内のメタタグに任意のグループと値を挿入いただくことにより、そのページをクロールする際に、その属性を追加します

下記の赤字部にグループ名（変数名と同等）を記載します。また、青字部に値を記載します。

※ metaタグを付与後にクロールされることで、属性が付与されます。

番号	利用可能サービス	概要
a	Cxense Advertising	キーワードターゲティングで利用したい場合	キーワードターゲティングの広告として利用したいキー・バリューを下記のフォーマットで記述します。 <meta name="cXenseParse:{お客様ごとの3文字の接頭辞}-marker-{キー}" content="バリュー"/> 例：お客様ごとの3文字の接頭辞をxxx、キーをgenre、値をsports と設定したい場合 <meta name="cXenseParse:xxx-marker-genre" content="sports"/>
b	Cxense Advertising	リターゲティングで利用したい場合	リターゲティング広告として利用したいキー・バリューを下記のフォーマットで記述します。 <meta name="cXenseParse:{お客様ごとの3文字の接頭辞}-target-{キー}" content="バリュー"/> 例：お客様ごとの3文字の接頭辞をxxx、キーをgenre、値をsports と設定したい場合 <meta name="cXenseParse:xxx-target-genre" content="sports"/>
c	Piano Insight Piano Content Cxense Search	コンテンツ/ユーザプロファイルの統計での集計フィルターとして利用 (Cxense Insight) 検索フィールドとして利用(Piano Content / Cxense Search)	フィルターや検索フィールドで利用したい値がある場合には、下記の形式で記述します。 <meta name="cXenseParse:{お客様ごとの3文字の接頭辞}-{キー}" content="バリュー"/> 例：お客様ごとの3文字の接頭辞をxxx、キーをgenre、値をsports と設定したい場合 <meta name="cXenseParse:xxx-genre" content="sports"/>
d	Cxense Search	ファセットとして利用(Cxense Search)	Cxense Search でファセットとして利用したい値がある場合には、下記の形式で記述します。 `<meta name="cXenseParse:recs:custom[0-4]"content="バリュー" />` recs:custom[0-4] は、事前定義されたフィールド名となっており、下記の5つを利用可能です。 `recs:custom0 recs:custom1 recs:custom2 recs:custom3 recs:custom4` 例：recs:custom0にBlog と設定したい場合 `<meta name="cXenseParse:recs:custom0"content="Blog" />`
e	Cxense Search Piano Content	公開日などの日付フォーマットとして利用	<meta name="cXenseParse:recs:publishtime" content="2012-08-28T18:11:24.802Z"/> ※ 注意：UTCで指定します。JSTは利用できません。
f	Piano Content	レコメンド対象外フラグとして利用	<meta name="cXenseParse:recs:recommendable" content="false">

Cxense Search/ Piano Content をご利用頂く際には、Piano Content - Review and Refinement に標準で読み込まれるtitleやpublishtimeへ任意の値を読み込むための

タグの設定方法を記載しておりますので、ご確認ください。

また、同じキー名に複数の値を設定する場合には、同じキーのタグを設定したい数分追加します。

<meta name="cXenseParse:xxx-category" content="it" />
<meta name="cXenseParse:xxx-category" content="enterprise" />

参考リンク：Document parsing と Piano Content - Review and Refinement

2. 指定したURLのパターンに合致したページヘの属性の付与

Cxense Insightの /profile/content/external/update API を実行してURLパターンによって、指定したキーとバリューを設定することができます。

この方法は、ページヘの追加のmetaタグの挿入作業は必要ありません。

※ 実行後に再クロール後に有効になります。APIを実行しただけでは有効になりません。

利用方法のサンプルは、下記のとおりです。

詳細については、/profile/content/external/updateをご参照ください。

項目名	設定
対象URL	URLのパターン
適合パターン	pattern(URLを正規表現で定義) exact (URLを完全一致で定義)
コンテンツデータ追加方法	enrich（指定キー名でのバリューの追加） modify (指定キー名でのバリューによる上書き) replace（指定キー名・バリューを設定、それ以外のキーは全て破棄）
キー名	任意のキー名（日本語文字列不可）ただし、キー名の前に{お客様ごとの3文字の接頭辞}- をつける必要が有ります。例: cxd-maincategory (お客様ごとの３文字の接頭辞がcxdの場合） ※ お客様ごとの3文字の接頭辞が、わからない場合には、サポートへお問い合わせください。
バリュー	任意の値（日本語文字列可） ※ 日本語はUnicode エスケープシーケンス（\uXXXX)形式で記述する必要があります。

注意

patternならびにexactの両方にURLパターンが一致している場合、patternで設定されている定義は利用されないことにご注意下さい。

$ python cx.py /profile/content/external/update '{
    "siteId": "9222300742735526873111"
    "configuration": {
        ".*example.co.*?/": {
            "match": "pattern",
            "mode": "enrich",
            "profile": [
                {
                    "groups": [
                        {
                            "group": "abc-description",
                            "weight": 0.75
                        }
                    ],
                    "item": "example commercial"
                },
                {
                    "groups": [
                        {
                            "group": "abc-usertype",
                            "weight": 0.5
                        }
                    ],
                    "item": "business user"
                }
            ]
        },
        "http://example.net/": {
            "match": "exact",
            "mode": "replace",
            "profile": [
                {
                    "groups": [
                        {
                            "group": "abc-description",
                            "weight": 0.5
                        }
                    ],
                    "item": "example network equipment site"
                }
            ]
        },
        "http://example.org/": {
            "match": "exact",
            "mode": "replace",
            "profile": [
                {
                    "groups": [
                        {
                            "group": "abc-description",
                            "weight": 0.7
                        }
                    ],
                    "item": "example organization site"
                }
            ]
        }
    }
}

3. カスタムカテゴリーによる属性の付与

下記利用例のように、「新築」というキーワードが本文中に含まれる場合に、そのページに「火災保険」や「住宅保険」、「保険」などの

カテゴリー情報を付与できます。

この機能を利用することにより、Webページの本文に含まれるキーワードを利用して、

カテゴリー化し、広告のターゲティングを効率的に行うことができます。

これらは、Excelシートにて管理します。

参考リンク：Custom taxonomies

Last updated: July 15, 2026