インデックスの設定

セールスフィードクローラーの構成

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

セールスフィードクローラーは、以下のような文書から商取引固有のデータをインデックス化するために使われるフィードクローラーの一種です:

区切り符を含むテキストファイル。
CSVファイルです。
JSON文字列ファイル。

セールスフィードクローラーを設定するには、フィードクローラーの設定手順に従い、コネクタタイプを求められたら「 セールスフィードクローラー 」を選択してください。

!注売上フィード分析は毎日計算されます。売上フィードクローラーにファイルを1日1回以上アップロードしないでください。週に一度は販売フィードファイルをクローラーにアップロードすることを推奨します。

セールスフィードクローラーには以下の構成が存在しなければなりません:

エクストラクタロジック

セールスフィードクローラーのエクストラクタロジックはフィードクローラーに似ていますが、トランザクションキー、イベントタイプ、エンティティタイプなどのフィールドが含まれます。

!重要データが正しく処理されるために、抽出ロジックのtransaction_key、entity_type、event_typeフィールドを変更してはいけません。

トランザクションキー

セールスフィードクローラーは、そのセッションのみ、または単一の顧客でイベントをグループ化するためにtransaction_keyを使用します。これらのキーはセールスフィードクローラーで事前に設定されており、編集は不要です。しかし、エクストラクタマッピングを更新して値を上書きすることで、カスタム値をセールスフィードセッション化に使うことができます。

!注セールスフィードクローラーでは、JavaScriptエクストラクタタイプのみがサポートされます。

アップロードされたファイルにuser_idが含まれている場合、Searchはそれをトランザクションキーとして使います。
アップロードされたファイルにuser_idが含まれていない場合、Search order_id と order_dateを組み合わせて新しい一意キーを作成します。

いずれか、または両方がuuid.listと見なされます。

イベントの種類

抽出関数では、event_typesをentity_page_viewやcart_addのようなサブイベントに分割するために使われます。これにより、recommendations、パーソナライズ、レシピでのデータセットの改善が図られます。このリストは編集不要です。

エンティティの種類

抽出関数では、entity_typeはデフォルトでproductに設定されています。カタログが正しくリンクされていることを確認するために、これは製品エンティティの名前と同じでなければなりません。

フィールド名

以下のフィールドはセールスフィードクローラーでサポートされており、必須フィールドは必須欄に記載されています。セールスフィードファイルにこれらのフィールド名が含まれていない場合は、ファイル内で変更するか、エクストラクタコードを使って変換・マッピングすることができます。

表1。フィールド名

Searchフィールド

概要

必須

conversion_id

変換イベントに関連付けられた一意の番号またはID。例えば、注文ID。

はい

document_id

一意インデックス文書ID。商取引では、通常 sku または product_idです。このIDはSearchユーザーインターフェースの Content Collection セクションで確認できます。

はい

group_by

SKUのグループを識別する一意文字列です。もし製品がSKUと同じであれば、そのSKUの価値と同じ価値になることがあります。

例えば、特定のシャツのサイズや色のすべてのサイズバリエーションがこのカテゴリに入ることがあります。指定されていない場合は、特定のURLを共有するすべての商品がまとめられます。

いいえ

entity_type

エンティティの種類(商品/コンテンツ/カテゴリなど)です。

はい

date

変換が行われた日時。

はい

price

変換が行われた時のカタログ価格。

はい

sale_price

コンバージョンが行われた価格(割引を含む)。

はい

quantity

変換された量 document_id 。

はい

order_total

順序の総量(複数の document_id が変換されている場合、複数行でも同じです)。

はい

user_id

購入したユーザーまたは顧客に関連付けられたユニークなID。通常、これはCRMシステム上で顧客に割り当てられるIDです。

これは、分析のためにイベント(IDuser.id)で使われる同じユーザーであり、order

、user

。

いいえ

user_eid

ユーザーのメールアドレスのハッシュ(md5またはSHA256)、またはメールサービスプロバイダーが使用する他のIDです。

いいえ

user_email

ユーザーまたは顧客のメールアドレス。

いいえ

billing_zipcode

顧客の請求先住所のZipコード。

いいえ

billing_region

顧客の請求先住所の州または地域。

いいえ

billing_country

顧客の請求先住所の国。

いいえ

store_id

変換が行われた店舗のユニークID。

いいえ

store_zipcode

変換が行われた店舗のZipコード。

いいえ

store_region

変換が行われた店舗の州または地域。

いいえ

store_country

改造が行われた店舗の国。

いいえ

この記事を改善するための提案がある場合は、お知らせください!