TSVファイルにおける顧客データの列名と説明
CitrusAdでは、TSV形式の顧客データのみをサポートしています。TSVファイルの列名とその内容を下表に示します。顧客データの場合、必須の列は次のみになります： customer_id.
| 列名 | 必須/任意 | データタイプ | 説明 |
|---|---|---|---|
customer_id | 必須 | テキスト | これは、小売業者のシステムにおける顧客の識別子です。 |
year_of_birth | 任意 | 数値 | もう使われていません。これは顧客の誕生年です。これは数値である必要があります。 |
gender | 任意 | テキスト | もう使われていません。これは顧客の性別です。値を指定する場合は、{"UNDEFINED", "FEMALE", "MALE", "OTHER"}のいずれかにする必要があります。 値は大文字と小文字を区別しません。 |
postcode | 任意 | テキスト | もう使われていません。顧客の連絡先住所の郵便番号です。 |
suburb | 任意 | テキスト | もう使われていません。顧客の連絡先住所の地区名です。 |
status | 差分更新を同期する場合は必須 | テキスト | 差分変更をファイルで同期する場合、これは顧客IDに対して実行するアクションを示すために使用されます。 指定できる値は INSERT、 UPDATE、およびDELETE |
target_data | 任意 | Jsonマップ | 値を指定する場合は、jsonマップにする必要があります。（例） {"customer_type" : "corporate", "customer_country" : "Australia"} |
customer_targeting:KEY | 任意 | テキスト | このタイプの列を使用する場合、小売業者はKEYに値を入力する必要があります。例えば、列名は「customer_targeting:customer_type」、列内のセルの値は「corporate」、「smb」、「retailer」などにできます。 TSVファイルには、この構文を持つ列が複数存在する可能性があります。 |
完全なファイル同期の場合、顧客用の見出し行と3個のデータ行を含むTSVファイルの例は以下の表の通りです。なお、生データはテキストファイルですが、読みやすいように表にしています。
customer_id | year_of_birth | gender | postcode | suburb | customer_targeting:customer_type |
|---|---|---|---|---|---|
| 0937832 | 1990 | MALE | 3000 | メルボルン | 小売業者 |
| 0347293 | 1993 | FEMALE | 4000 | ブリスベン | 小売業者 |
| 0293423 | OTHER | 4064 | ミルトン | 企業 |
同期オプション
全更新
全更新モードを使用すると、小売業者は顧客情報の完全なファイルを同期できます。これは、セットアップが簡単なため、小売業者が統合で使用する一般的な方法です。
差分更新
差分更新は、顧客に対する更新または変更のみを同期するようにファイルを調整することで可能になります。これは、多数のユーザーを抱える大規模な小売業者に向いています。
ファイルにはユーザーに対して実行するアクションを status 示す列が含まれている必要があります。指定できる値は、 INSERT、 UPDATE、およびDELETE.
以下のファイルの例を参照してください。
customer_id | status | year_of_birth | gender | postcode | suburb | customer_targeting:customer_type |
|---|---|---|---|---|---|---|
| 1 | INSERT | 1990 | MALE | 3000 | メルボルン | 小売業者 |
| 2 | UPDATE | 1993 | FEMALE | 4000 | ブリスベン | 小売業者 |
| 3 | DELETE | OTHER | 4064 | ミルトン | 企業 |
全更新フィードでは、差分変更を同期できません。
上記のフィードの場合、顧客ID1は新規、顧客2は更新中、顧客3は小売業者によって削除されています。