This feature is part of an open beta. Keep in mind that the feature is subject to change.
以下の手順は、ユーザー提供データの収集を設定する予定で、gtag.js を使ってウェブサイトにコード スニペットを追加する方法を習得したいとお考えの管理者と編集者を対象としています。ウェブサイトのコードを更新すると、アナリティクスでユーザー提供データが収集される際に、メールアドレス、電話番号や、名前、住所をページで使用しやすくなります。
概要
ウェブサイトのコードを更新するには、event、config、または set コマンド内で gtag( ) 関数を使用して user_data の値とユーザー提供データの各フィールドを設定します。
2 種類以上のコマンド（event や config など）で同じデータを渡すと、event コマンドで config コマンドがオーバーライドされ、config コマンドで set コマンドがオーバーライドされます。Google タグのパラメータの優先順位に関する詳細
ユーザー提供データを収集するすべてのページ（申し込みページ、見込み顧客発掘のページ、購入手続きページなど）でコードを更新する必要があります。セッション内でデータを複数回送信すると、データをアナリティクスに確実に送信できます。
始める前に
この手順は、以下の条件を満たしていることを前提としています。
- ウェブサイトのソースコードへのアクセス権が付与されている
- ユーザー提供データの収集を有効にし、ユーザー提供データ機能を許可している
Hashing the data
You can send hashed or unhashed data from a website. If you send unhashed data, Google normalizes and hashes the data before the data reaches Google's servers. To ensure Analytics interprets the data correctly and to comply with the User-provided data policy, you must use the correct key name (in the next section).
To hash the data:
- Use hex SHA256.
To normalize the data:
- Remove leading or trailing whitespaces.
- Convert the text to lowercase.
- Format phone numbers according to the E.164 standard.
Defining the fields in your code
You must provide at least one of these fields:
- Email (preferred).
- Address (first name, last name, postal code, and country are required). You can optionally provide street address, city, and region as additional match keys.
- A phone number can also be provided along with an email or full name and address.
Make sure the data is available when the Google tag fires. If the data is collected on a previous page, make sure it’s available in your code on the current page so you can configure the field.
Fields to set
The following table describes each field you can set. The key name shows how you must reference the field in your code. You must pass the data as a String type. When defining name and address, make sure to define each component as an individual variable (for example, first name, last name, and so on).
Note: If you want to send unhashed data and let Google normalize and hash the data, use the first key name for each data field. For example, email in the Email address data field below. If you want to send hashed data, use the key name that begins with sha256_.
| Data Field | Key Name | Description |
|---|---|---|
| Email address | email |
User email. Example: ‘[email protected]’ |
sha256_email_address |
Hashed user email. Example: ‘a8af8341993604f29cd4e0e5a5a4b5d48c575436c38b28abbfd7d481f345d5db’ |
|
| Phone number | phone_number |
User phone number. Must be in E.164 format, which means it must be 11 to 15 digits including a plus sign (+) prefix and country code with no dashes, parentheses, or spaces. Example: ‘+11231234567’ |
sha256_phone_number |
Hashed user phone number. Example: ‘e9d3eef677f9a3b19820f92696be53d646ac4cea500e5f8fd08b00bc6ac773b1’ |
|
| First name | address.first_name |
User first name. Example: 'John' |
address.sha256_first_name |
Hashed user first name. Example: ‘96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a’ |
|
| Surname | address.last_name |
User last name. Example: 'Doe' |
address.sha256_last_name |
Hashed user last name. Example: ‘799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f’ |
|
| Street address | address.street |
User street address. Example: '123 New Rd' |
| City | address.city |
User city name. Example: `Southampton’ |
| Region | address.region |
User province, state, or region. Example: `Hampshire’ |
| Postal code | address.postal_code |
User post code. Example: 'SO99 9XX' |
| Country | address.country |
User country code. Example: 'UK'. Use 2-letter country codes, per the ISO 3166-1 alpha-2 standard. |
コードにフィールドを実装する
顧客データを収集する各ページで、定義する各フィールドを使って user_data パラメータを設定します。
例を見る
次のサンプルには、顧客データの変数名が含まれています。コード内の変数名がウェブサイト上の属性と一致していることを確認してください。たとえば、「email_address」という名前の変数にメールアドレスを格納する場合は、スニペット内の「yourEmailVariable」を「email_address」に変更します。
文字列型のフィールドをハードコーディングしたり、変数の代わりに関数を使用したりすることもできます。
// 実装
<script>
gtag('set', 'user_data', {
"email": yourEmailVariable, ***yourEmailVariable は、ユーザーのメールアドレスのデータを格納する実際の JavaScript 変数の名前に変更します。以下の他の変数についても同様に処理します。値がハッシュ化されていないことを確認してください。
"phone_number": yourPhoneVariable,
"address": {
"first_name": yourFirstNameVariable,
"last_name": yourLastNameVariable,
"street": yourStreetAddressVariable,
"city":yourCityVariable,
"region": yourRegionVariable,
"postal_code": yourPostalCodeVariable,
"country": yourCountryVariable
}
});
</script>
電話番号は E.164 形式で指定します。この形式は、ダッシュ、かっこ、スペースを含まない、プラス記号（+）と国コードを付加した 11～15 桁の数字である必要があります。
空白のフィールドを削除する
上記のサンプルコードで特定のフィールドを収集しない場合は、そのフィールドを空白にするのではなく、コードからフィールド全体を削除してください。たとえば、メールアドレスと電話番号のみを収集しているサイトの場合、コードは次のようになります。
<script>
gtag('set', 'user_data', {
"email": {{ yourEmailVariable }},
"phone_number": {{ yourPhoneVariable }}
});
</script>
複数の値を追加する
配列を使って複数の値（電話番号とメールアドレスは最大 3 個、住所は最大 2 個）を指定できます。複数の値をキャプチャすると、一致の可能性が高くなります。
gtag('set', 'user_data', {
"email": [yourEmailVariable1, yourEmailVariable2],
"phone_number": [yourPhoneVariable1, yourPhoneVariable2],
"address": [
{
{
]
});
</script>