翻訳: 無効
ad_impression
このイベントは、ユーザーに広告が表示されたときに使用されます。
- Measurement Protocol を使用して送信された
ad_impression
は含まれません Google 広告などの他の広告プラットフォームへのエクスポートにおけるデータの割合。 - Measurement Protocol を使用して
ad_impression
イベントを送信すると、リンクされた Google 広告サービスのタグ設定または SDK を構成している場合、インプレッションが重複する可能性があります。Measurement Protocol を使用してad_impression
イベントを送信するのは、 捕捉されなかった場合
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
ad_platform |
string |
いいえ | MoPub | 広告プラットフォーム。 |
ad_source |
string |
いいえ | AdColony | 広告ソース。 |
ad_format |
string |
いいえ | バナー | 広告フォーマット。 |
ad_unit_name |
string |
いいえ | Banner_03 | 広告ユニット名。 |
currency |
string |
いいえ | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
いいえ | 3.99 | 広告インプレッションの値。 * 有意義なレポートを作成するには、通常、 value を指定する必要があります。
* value を設定する場合は currency を指定する必要があります。
|
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events":[{
"name":"ad_impression",
"params":{
"ad_platform": "MoPub",
"ad_source": "AdColony",
"ad_format": "Banner",
"ad_unit_name": "Banner_03",
"currency": "USD",
"value": 3.99
}
}]
})
});
add_payment_info
このイベントは、ユーザーが e コマースの決済手続きで支払い情報を送信したことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 * value を items 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして設定する場合、
value 。
* value を設定する場合は currency が必要です。
|
coupon |
string |
× | SUMMER_FUN | イベントに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
payment_type |
string |
× | Credit Card | 選択した支払い方法。 |
items |
Array<Item> |
○ | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_payment_info",
"params": {
"currency": "USD",
"value": 30.03,
"coupon": "SUMMER_FUN",
"payment_type": "Credit Card",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
add_shipping_info
このイベントは、ユーザーが e コマースの決済手続きで支払い情報を送信したことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 * value を items 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping や tax は含めないでください。* 有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして登録する場合は、
value 。
* value を設定する場合は currency が必要です。
|
coupon |
string |
× | SUMMER_FUN | イベントに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
shipping_tier |
string |
× | Ground |
購入された商品アイテムの配送方法で選択されている送料区分(Ground 、Air 、Next-day など)。
|
items |
Array<Item> |
○ | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_shipping_info",
"params": {
"currency": "USD",
"value": 30.03,
"coupon": "SUMMER_FUN",
"shipping_tier": "Ground",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
add_to_cart
このイベントは、購入のために商品アイテムがカートに追加されたことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 * value を次のフィールドの全アイテムの (price * quantity) の合計に設定します。
items 。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして設定する場合、
value 。
* value を設定する場合は currency が必要です。
|
items |
Array<Item> |
○ | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_to_cart",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
add_to_wishlist
このイベントは、商品アイテムがウィッシュリストに追加されたことを示します。アプリで人気のあるギフトアイテムを特定するには、このイベントを使用します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 * value を (price * quantity) のすべての商品アイテムの合計に設定します
items 。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常、 value を指定する必要があります。
イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
|
items |
Array<Item> |
○ | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_to_wishlist",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
begin_checkout
このイベントは、ユーザーが購入手続きを開始したことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 * value を (price * quantity) のすべての商品アイテムの合計に設定します
items 。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして登録する場合は
value 。
* value を設定する場合は currency が必要です。
|
coupon |
string |
× | SUMMER_FUN | イベントに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
items |
Array<Item> |
○ | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "begin_checkout",
"params": {
"currency": "USD",
"value": 30.03,
"coupon": "SUMMER_FUN",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
campaign_details
このイベントを使って、今後のイベントに適用されるキャンペーンの詳細情報を送信します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
campaign_id |
string |
× | google_1234 | キャンペーン ID。 |
campaign |
string |
× | Summer_fun | 特定のプロモーションまたは戦略的キャンペーンを識別するために使用する名前。 |
source |
string |
× | キャンペーンのトラフィック ソース(google、email など)。 | |
medium |
string |
× | cpc | キャンペーン メディア(メール、クリック単価など)。 |
term |
string |
× | summer+travel | 広告にキーワードを設定している有料検索で使用するキャンペーンのキーワード。 |
content |
string |
× | logolink | A/B テストやコンテンツ ターゲット広告で、同じ URL を参照する広告やリンクを区別するために使用するキャンペーンのコンテンツ。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink"
}
}]
})
});
close_convert_lead
このイベントは、見込み顧客がコンバージョンを達成して成約に至った時間を測定します(例: あります。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントの value の通貨(
3 文字
ISO 4217 形式で指定します。* value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 *有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして登録する場合は、
value 。
* value を設定する場合は currency を指定する必要があります。
|
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "close_convert_lead",
"params": {
"currency": "USD",
"value": 30.03
}
}]
})
});
close_unconvert_lead
このイベントは、ユーザーがコンバージョンに至った見込み顧客になっていないとマークされたときに測定されます。 理由が示されます。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントの value の通貨(3 文字の ISO 4217 形式)。* value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 *有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして登録する場合は、
value 。
* value を設定する場合は currency を指定する必要があります。
|
unconvert_lead_reason |
string |
いいえ | 未回答 | 見込み顧客がコンバージョンに至らなかった理由。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "close_unconvert_lead",
"params": {
"currency": "USD",
"value": 30.03,
"unconvert_lead_reason": "Never responded"
}
}]
})
});
disqualify_lead
このイベントは、ユーザーが見込み顧客として不適格とマークされたタイミングを測定します。 失格の理由が記載されています。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントの value の通貨(3 文字の ISO 4217 形式)。* value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 *有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして登録する場合は、
value 。
* value を設定する場合は currency を指定する必要があります。
|
disqualified_lead_reason |
string |
いいえ | 購入は考えていない | 見込み顧客が不適格とマークされた理由。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "disqualify_lead",
"params": {
"currency": "USD",
"value": 30.03,
"disqualified_lead_reason": "Not looking to buy"
}
}]
})
});
earn_virtual_currency
このイベントは、ユーザーがゲーム内で仮想通貨を獲得したタイミングを測定します。仮想経済について詳しく把握するには、このイベントを spend_virtual_currency とともにログに記録します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
virtual_currency_name |
string |
× | Gems | 仮想通貨の名前。 |
value |
number |
× | 5 | 仮想通貨の価値。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "earn_virtual_currency",
"params": {
"virtual_currency_name": "Gems",
"value": 5
}
}]
})
});
generate_lead
このイベントは、見込み顧客が発掘されたタイミングを測定します(フォームの使用など)。ログに記録することで、マーケティング キャンペーンの効果と、リマーケティング後にビジネスを再び利用した顧客の数を把握できます。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントの value の通貨(
3 文字
ISO 4217 形式で指定します。* value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 *有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして登録する場合は、
value 。
* value を設定する場合は currency を指定する必要があります。
|
lead_source |
string |
いいえ | 展示会 | 見込み顧客の情報源。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "generate_lead",
"params": {
"currency": "USD",
"value": 30.03,
"lead_source": "Trade show"
}
}]
})
});
join_group
ユーザーが団体、チーム、ファミリーなどのグループに参加したときに、このイベントをログに記録します。特定のグループまたはソーシャル機能の人気度を分析するには、このイベントを使用します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
group_id |
string |
× | G_12345 | グループの ID。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events":[{
"name":"join_group",
"params":{
"group_id":"G_12345"
}
}]
})
});
level_up
このイベントは、ユーザーがゲーム内でレベルアップしたことを示します。ユーザーベースのレベル分布を測定して完了しにくいレベルを特定するには、このイベントを使用します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
level |
number |
× | 5 | キャラクターのレベル。 |
character |
string |
× | Player 1 | レベルアップしたキャラクター。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "level_up",
"params": {
"level": 5,
"character": "Player 1"
}
}]
})
});
login
ユーザーがウェブサイトまたはアプリにログインしたことを示すには、このイベントを送信します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
method |
string |
× | ログインに使用するメソッド。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "login",
"params": {
"method": "Google"
}
}]
})
});
post_score
このイベントは、ユーザーがスコアを投稿したときに送信します。ゲーム内でのユーザーのパフォーマンスを把握して、ハイスコアをオーディエンスおよび行動と関連付けるには、このイベントを使用します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
score |
number |
○ | 10000 | 投稿するスコア。 |
level |
number |
× | 5 | スコアのレベル。 |
character |
string |
× | Player 1 | スコアを達成したキャラクター。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "post_score",
"params": {
"score": 10000,
"level": 5,
"character": "Player 1"
}
}]
})
});
purchase
このイベントは、ユーザーが 1 つ以上の商品アイテムを購入したことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 * value を次のフィールドの全アイテムの (price * quantity) の合計に設定します。
items 。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常、 value を指定する必要があります。
イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
|
transaction_id |
string |
はい | T_12345 | 取引を一意に識別する ID。transaction_id パラメータを使用すると、購入イベントの重複を回避できます。 |
coupon |
string |
いいえ | SUMMER_FUN | イベントに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
shipping |
number |
× | 3.33 | 取引に関連付けられた送料。 |
tax |
number |
× | 1.11 | 取引に関連付けられた税金。 |
items |
Array<Item> |
○ | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "purchase",
"params": {
"currency": "USD",
"transaction_id": "T_12345",
"value": 30.03,
"coupon": "SUMMER_FUN",
"shipping": 3.33,
"tax": 1.11,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
qualify_lead
このイベントは、ユーザーが認定を受けるための基準を満たしているとマークされた時点で測定されます。 獲得できます
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントの value の通貨(単位:
3 文字
ISO 4217 形式で指定します。* value を設定する場合、currency は必須です
収益指標を正確に計算できるようにする必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 *有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして登録する場合は、
value 。
* value を設定する場合は currency を指定する必要があります。
|
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "qualify_lead",
"params": {
"currency": "USD",
"value": 30.03
}
}]
})
});
refund
このイベントは、1 つ以上の商品アイテムについてユーザーに払い戻しが行われたことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
transaction_id |
string |
○ | T_12345 | 取引を一意に識別する ID。 |
value |
number |
○* | 30:03 | イベントの金銭的価値。 * value を items 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常、 value を指定する必要があります。
イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
|
coupon |
string |
× | SUMMER_FUN | イベントに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
shipping |
number |
× | 3.33 | 取引に関連付けられた送料。 |
tax |
number |
× | 1.11 | 取引に関連付けられた税金。 |
items |
Array<Item>
|
×* | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "refund",
"params": {
"currency": "USD",
"transaction_id": "T_12345",
"value": 30.03,
"coupon": "SUMMER_FUN",
"shipping": 3.33,
"tax": 1.11,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
remove_from_cart
このイベントは、商品アイテムがカートから削除されたことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 * value を次のフィールドの全アイテムの (price * quantity) の合計に設定します。
items 。shipping や tax は含めないでください。* 有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして登録する場合は、
value 。
* value を設定する場合は currency が必要です。
|
items |
Array<Item> |
○ | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "remove_from_cart",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
screen_view
このイベントを使用して、画面が遷移したことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
screen_class |
string |
いいえ | MainActivity | 画面のクラス。 |
screen_name |
string |
いいえ | About | スクリーンの名前。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "screen_view",
"params": {
"screen_class": "MainActivity",
"screen_name": "About"
}
}]
})
});
search
ユーザーが検索を行ったときに、このイベントをログに記録します。このイベントを使用すると、ウェブサイトやアプリで検索を行っているユーザーを識別できます。たとえば、ユーザーが検索後に検索結果ページを閲覧したときにこのイベントを送信できます。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
search_term |
string |
○ | t-shirts | 検索されたキーワード。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "search",
"params": {
"search_term": "t-shirts"
}
}]
})
});
select_content
このイベントは、ユーザーが特定のタイプのコンテンツを選択したことを示します。 このイベントを使用すると、ウェブサイトやアプリで人気のあるコンテンツとコンテンツのカテゴリを特定できます。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
content_type |
string |
× | product | 選択されたコンテンツの種類。 |
content_id |
string |
× | C_12345 | 選択されたコンテンツの識別子。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_content",
"params": {
"content_type": "product",
"content_id": "C_12345"
}
}]
})
});
select_item
このイベントは、リストから商品アイテムが選択されたことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 商品アイテム単位で設定されている場合は無視されます。 |
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 商品アイテム単位で設定されている場合は無視されます。 |
items |
Array<Item> |
○* | イベントの商品アイテム。 * items 配列では、選択された商品アイテムを表す要素を 1 つだけ含むことが想定されています。複数の要素が指定されている場合、items の最初の要素のみが使用されます。
|
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_item",
"params": {
"item_list_id": "related_products",
"item_list_name": "Related products",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
select_promotion
このイベントは、リストからプロモーションが選択されたことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
creative_name |
string |
× | summer_banner2 | プロモーション用のクリエイティブの名前。 商品アイテム単位で設定されている場合は無視されます。 |
creative_slot |
string |
× | featured_app_1 | イベントに関連付けられたプロモーション用のクリエイティブ スロットの名前。 商品アイテム単位で設定されている場合は無視されます。 |
promotion_id |
string |
× | P_12345 |
イベントに関連付けられたプロモーションの ID。 商品アイテム単位で設定されている場合は無視されます。 |
promotion_name |
string |
× | Summer Sale |
イベントに関連付けられたプロモーションの名前。 商品アイテム単位で設定されている場合は無視されます。 |
items |
Array<Item>
|
× | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
creative_name |
string |
× | summer_banner2 | プロモーション用のクリエイティブの名前。 設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name (存在する場合)が使用されます。 |
creative_slot |
string |
× | featured_app_1 | 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。 設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot (存在する場合)が使用されます。 |
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
promotion_id |
string |
いいえ | P_12345 |
商品アイテムに関連付けられたプロモーションの ID。 設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id (存在する場合)が使用されます。
|
promotion_name |
string |
× | Summer Sale |
商品アイテムに関連付けられたプロモーションの名前。 設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name (存在する場合)が使用されます。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_promotion",
"params": {
"creative_name": "Summer Banner",
"creative_slot": "featured_app_1",
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"creative_name": "summer_banner2",
"creative_slot": "featured_app_1",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"quantity": 3
}
]
}
}]
})
});
share
このイベントは、ユーザーがコンテンツを共有した際に使用されます。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
method |
string |
× | コンテンツを共有する方法。 | |
content_type |
string |
× | image | 共有コンテンツの種類。 |
item_id |
string |
× | C_12345 | 共有コンテンツの ID。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "share",
"params": {
"method": "Twitter",
"content_type": "image",
"item_id": "C_12345"
}
}]
})
});
sign_up
このイベントは、ユーザーがアカウントに登録したことを示します。ログインしているユーザーとログインしていないユーザーの行動の違いを把握するには、このイベントを使用します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
method |
string |
× | 登録に使用された方法。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "sign_up",
"params": {
"method": "Google"
}
}]
})
});
spend_virtual_currency
このイベントでは、アプリ内の仮想アイテムの売り上げを測定して、最も人気のある仮想アイテムを特定することができます。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
value |
number |
○ | 5 | 仮想通貨の価値。 |
virtual_currency_name |
string |
○ | Gems | 仮想通貨の名前。 |
item_name |
string |
× | Starter Boost | 仮想通貨が使用されている商品アイテムの名前。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "spend_virtual_currency",
"params": {
"value": 5,
"virtual_currency_name": "Gems",
"item_name": "Starter Boost"
}
}]
})
});
tutorial_begin
このイベントは、オンボーディング プロセスの開始を示します。チュートリアルを完了したユーザー数を把握するには、このイベントを目標到達プロセスで tutorial_complete とともに使用します。
パラメータ
このイベントで使用するパラメータの候補はありません。
このイベントのパラメータはありません。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "tutorial_begin"
}]
})
});
tutorial_complete
このイベントは、ユーザーがオンボーディング プロセスを完了したことを示します。チュートリアルを完了したユーザー数を把握するには、このイベントを目標到達プロセスで tutorial_begin とともに使用します。
パラメータ
このイベントで使用するパラメータの候補はありません。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "tutorial_complete"
}]
})
});
unlock_achievement
ユーザーがレベルを達成したときに、このイベントをログに記録します。このイベントを使用すると、ユーザーによるゲームの利用状況を把握できます。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
achievement_id |
string |
○ | A_12345 | 達成されたレベルの ID。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "unlock_achievement",
"params": {
"achievement_id": "A_12345"
}
}]
})
});
view_cart
このイベントは、ユーザーがカートを表示したことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 * value を次のフィールドの全アイテムの (price * quantity) の合計に設定します。
items 。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常、 value を指定する必要があります。
イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
|
items |
Array<Item> |
○ | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_cart",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
view_item
このイベントは、一部のコンテンツがユーザーに表示されたことを示します。最もよく閲覧されている商品アイテムを特定するには、このイベントを使用します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。 * value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 * value を items 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして登録する場合は、
value 。
* value を設定する場合は currency が必要です。
|
items |
Array<Item> |
○ | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_item",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
],
}
}]
})
});
view_item_list
ユーザーに特定のカテゴリの商品アイテムのリストが表示されたときに、このイベントをログに記録します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 商品アイテム単位で設定されている場合は無視されます。 |
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 商品アイテム単位で設定されている場合は無視されます。 |
items |
Array<Item> |
○ | イベントの商品アイテム。 |
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_item_list",
"params": {
"item_list_id": "related_products",
"item_list_name": "Related products",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
view_promotion
このイベントは、リストからプロモーションが表示されたことを示します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
creative_name |
string |
× | summer_banner2 | プロモーション用のクリエイティブの名前。 商品アイテム単位で設定されている場合は無視されます。 |
creative_slot |
string |
× | featured_app_1 | イベントに関連付けられたプロモーション用のクリエイティブ スロットの名前。 商品アイテム単位で設定されている場合は無視されます。 |
promotion_id |
string |
× | P_12345 |
イベントに関連付けられたプロモーションの ID。 商品アイテム単位で設定されている場合は無視されます。 |
promotion_name |
string |
× | Summer Sale |
イベントに関連付けられたプロモーションの名前。 商品アイテム単位で設定されている場合は無視されます。 |
items |
Array<Item> |
○* | イベントの商品アイテム。 * items 配列では、プロモーションに関連付けられた商品アイテムを表す要素を 1 つだけ含むことが想定されています。複数の要素が指定されている場合、items の最初の要素のみが使用されます。
|
商品アイテム パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
item_id |
string |
○* | SKU_12345 |
商品アイテムの ID。
* |
item_name |
string |
○* | Stan and Friends Tee |
商品アイテムの名前。
* |
affiliation |
string |
× | Google Store |
仕入れ先業者や実店舗を指定する商品アフィリエーション。 注: 「affiliation」はアイテム スコープでのみ使用できます。 |
coupon |
string |
× | SUMMER_FUN | 商品アイテムに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
|
creative_name |
string |
× | summer_banner2 | プロモーション用のクリエイティブの名前。 設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name (存在する場合)が使用されます。 |
creative_slot |
string |
× | featured_app_1 | 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。 設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot (存在する場合)が使用されます。 |
discount |
number |
× | 2.22 | 商品アイテムに関連付けられた割引額。 |
index |
number |
いいえ | 5 | リスト内の商品アイテムのインデックスまたは位置。 |
item_brand |
string |
× | 商品アイテムのブランド。 | |
item_category |
string |
× | Apparel | 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。 |
item_category2 |
string |
× | Adult | 商品アイテムのカテゴリの第 2 階層またはその他の分類。 |
item_category3 |
string |
× | Shirts | 商品アイテムのカテゴリの第 3 階層またはその他の分類。 |
item_category4 |
string |
× | Crew | 商品アイテムのカテゴリの第 4 階層またはその他の分類。 |
item_category5 |
string |
× | Short sleeve | 商品アイテムのカテゴリの第 5 階層またはその他の分類。 |
item_list_id |
string |
× | related_products | ユーザーに商品アイテムが表示されたリストの ID。 設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id (存在する場合)が使用されます。
|
item_list_name |
string |
× | Related products | ユーザーに商品アイテムが表示されたリストの名前。 設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name (存在する場合)が使用されます。
|
item_variant |
string |
× | green | 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。 |
location_id |
string |
× | ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) |
商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。 注: 「location_id」はアイテム スコープでのみ使用できます。 |
price |
number |
いいえ | 10:01 |
指定された通貨パラメータの単位で表した商品アイテムの単価。
商品アイテムに割引を適用する場合は、 price を割引価格の単価に設定します。
discount パラメータで割引単価を指定します。
|
promotion_id |
string |
いいえ | P_12345 |
商品アイテムに関連付けられたプロモーションの ID。 設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id (存在する場合)が使用されます。
|
promotion_name |
string |
× | Summer Sale |
商品アイテムに関連付けられたプロモーションの名前。 設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name (存在する場合)が使用されます。
|
quantity |
number |
いいえ | 3 |
商品アイテムの数量。 |
items
配列には既定のパラメータとは別に、27 の
カスタム パラメータ
を含めることができます。
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_promotion",
"params": {
"creative_name": "Summer Banner",
"creative_slot": "featured_app_1",
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"creative_name": "summer_banner2",
"creative_slot": "featured_app_1",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"quantity": 3
}
]
}
}]
})
});
view_search_results
ユーザーに検索結果が表示されたときに、このイベントをログに記録します。なお、Google アナリティクスの拡張イベント計測機能を使って、view_search_results イベントの自動収集を有効にできます。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
search_term |
string |
× | Clothing | 検索に使用されたキーワード。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_search_results",
"params": {
"search_term": "Clothing"
}
}]
})
});
working_lead
このイベントは、ユーザーが担当者と連絡を取ったタイミングを測定します。
パラメータ
名前 | タイプ | 必須 | 値の例 | 説明 |
---|---|---|---|---|
currency |
string |
○* | USD |
イベントの value の通貨(
3 文字
ISO 4217 形式で指定します。* value を設定する場合、currency は必須です
収益指標を正確に計算できるようにする必要があります。
|
value |
number |
○* | 30:03 | イベントの金銭的価値。 *有意義なレポートを作成するには、通常、 value を指定する必要があります。
Google Chat で
そのイベントをキーイベントとして登録する場合は、
value 。
* value を設定する場合は currency を指定する必要があります。
|
lead_status |
string |
いいえ | 開始された会話 | リードのステータス。 |
イベント送信
このイベントを Google アナリティクスのイベント ビルダーで試す
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "working_lead",
"params": {
"currency": "USD",
"value": 30.03,
"lead_status": "Started conversations"
}
}]
})
});