Skip to content

Shopify のデータ機能

この記事では、Shopify の機能の概要を示します。これには、追跡対象の Shopify データ、ペイロード例、履歴バックフィル、および製品の同期などが含まれます。

追跡対象の Shopify イベント

Shopify インテグレーションでは、e コマース推奨イベントを使用して、主要な買い物行動をキャプチャします。これらのイベントを使用した実装例およびマーケティング戦略については、e コマースユースケースを参照してください。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

{
    "name": "ecommerce.product_viewed",
    "properties": {
        "product_id": "12345",
        "product_name": "product",
        "variant_id": "123",
        "image_url": "www.image-url.com",
        "product_url": "mystorefront.myshopify.com/product",
        "price": 10,
        "currency": "USD",
        "source": "mystorefront.myshopify.com",
        "metadata": {
          "sku": "sku"
        },
        "type": [
          "price_drop",
          "back_in_stock"
        ]
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
    "name": "ecommerce.cart_updated",
    "properties": {
        "cart_id": "Z2NwLXVzLWVhc3QxOjAxSjk3UFg4RlFZMjVTVkRHRlc1RlI3SlRY",
        "currency": "USD",
        "total_value": 2000000,
        "products": [
            {
                "product_id": "8266836345064",
                "product_name": "PANTS!!!",
                "variant_id": "44610569208040",
                "image_url": "https://cdn.shopify.com/s/files/1/0604/4211/6328/files/1200px-Trousers-colourisolated.jpg?v=1689256168",
                "product_url": "https://test-store.myshopify.com/products/pants?variant=44610569208040",
                "quantity": 2,
                "price": 1000000,
                "metadata": {
                    "sku": "007"
                }
            }
        ],
        "source": "https://test-store.myshopify.com",
        "metadata": {}
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

{
    "name": "ecommerce.checkout_started",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "cart_id": "eeafa272cebfd4b22385bc4b645e762c",
        "total_value": 421.88,
        "currency": "USD",
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "checkout_id": "123123123",
        "metadata": {
            "checkout_url": "https://checkout.local/548380009/checkouts/123123123/recover?key=example-secret-token"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

{
    "name": "ecommerce.order_placed",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "cart_id": "eeafa272cebfd4b22385bc4b645e762c",
        "total_value": 421.88,
        "currency": "USD",
        "total_discounts": 5,
        "discounts": [],
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
            "order_status_url": "https://apple.myshopify.com/690933842/orders/123456abcd/authenticate?key=abcdefg",
            "order_number": 1234,
            "tags": [
                "heavy",
                "heavy2"
            ],
            "referring_site": "https://www.google.com",
            "payment_gateway_names": [
                "visa",
                "bogus"
            ]
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

{
 "name": "shopify_fulfilled_order",
 "time": "2022-05-23T14:44:34-04:00",
 "properties": {
   "order_id": 4444668657855,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143032066239,
       "sku": null,
       "title": "Dark Denim Top",
  "variant_id": 40094740549876,
       "variant_title": "Small Dark Denim Top",


       "vendor": "partners-demo",
       "name": "Dark Denim Top",
       "properties": [],
       "price": "60.00",
       "fulfillment_status": "fulfilled"
     }
   ],
   "shipping": [
     {
       "title": "Standard",
       "price": "0.00"
     }
   ],
   "total_price": "130.66",
   "confirmed": true,
   "total_discounts": "0.00",
   "discount_codes": [],
   "order_number": 1093,
   "order_status_url": "https://test-store.myshopify.com/",
   "cancelled_at": null,
   "tags": "",
   "closed_at": "2022-05-23T14:44:34-04:00",
   "fulfillment_status": "fulfilled",
   "fulfillments": [
     {
       "shipment_status": null,
       "status": "success",
       "tracking_company": "Other",
       "tracking_number": "456",
       "tracking_numbers": [
         "456"
       ],
       "tracking_url": "https://braze.com",
       "tracking_urls": [
         "https://braze.com"
       ],
       "line_items": [
         {
           "fulfillment_status": "fulfilled",
           "name": "Dark Denim Top",
           "price": "60.00",
           "product_id": 6143032066239,
           "quantity": 1,
           "requires_shipping": true,
           "sku": null,
           "title": "Dark Denim Top",
           "variant_id": 40094740549876,
           "variant_title": "Small Dark Denim Top",
           "vendor": "partners-demo"
         }
       ]
     }
   ]
 },
 "braze_id": "123abc123abc"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

{
 "name": "shopify_partially_fulfilled_order",
 "time": "2022-05-23T14:43:34-04:00",
 "properties": {
   "order_id": 4444668657855,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143032066239,
       "sku": null,
       "title": "Dark Denim Top",
       "variant_id": 40094740549876,
       "variant_title": "",
       "vendor": "partners-demo",
       "name": "Dark Denim Top",
       "properties": [],
       "price": "60.00",
       "fulfillment_status": "fulfilled"
     }
   ],
   "shipping": [
     {
       "title": "Standard",
       "price": "0.00"
     }
   ],
   "total_price": "130.66",
   "confirmed": true,
   "total_discounts": "0.00",
   "discount_codes": [],
   "order_number": 1093,
   "order_status_url": "https://test-store.myshopify.com/",
   "cancelled_at": null,
   "tags": "",
   "closed_at": null,
   "fulfillment_status": "partial",
   "fulfillments": [
     {
       "shipment_status": null,
       "status": "success",
       "tracking_company": "Other",
       "tracking_number": "123",
       "tracking_numbers": [
         "123"
       ],
       "tracking_url": "https://braze.com",
       "tracking_urls": [
         "https://braze.com"
       ],
       "line_items": [
         {
           "fulfillment_status": "fulfilled",
           "name": "Dark Denim Top",
           "price": "60.00",
           "product_id": 6143032066239,
           "properties": [],
           "quantity": 1,
           "requires_shipping": true,
           "sku": null,
           "title": "Dark Denim Top",
           "variant_id": 40094740549876,
           "variant_title": "",
           "vendor": "partners-demo"
         }
       ]
     }
   ]
 },
 "braze_id": "abc123abc123"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

{
 "name": "shopify_paid_order",
 "time": "2022-05-23T13:52:38-04:00",
 "properties": {
   "order_id": 4444596371647,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143033344191,
       "sku": null,
       "title": "LED High Tops",
       "variant_id": 40094740549876,
       "variant_title": null,
       "vendor": "partners-demo",
       "name": "LED High Tops",
       "properties": [],
       "price": "80.00",
       "fulfillment_status": null
     }
   ]
 }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

{
    "name": "ecommerce.order_cancelled",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "cancel_reason": "no longer necessary",
        "total_value": 421.88,
        "currency": "USD",
        "total_discounts": 5,
        "discounts": [],
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
            "order_status_url": "https://apple.myshopify.com/690933842/orders/123456abcd/authenticate?key=abcdefg",
            "order_number": 1234,
            "tags": [
                "heavy",
                "heavy2"
            ]
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

{
    "name": "ecommerce.order_refunded",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "total_value": 421.88,
        "currency": "USD",
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
		"order_note": "item was broken"
        }
    }
} 

1
2
3
4
5
6

{
	"name": "shopify_account_login",
	"properties": {
	"source": "braze-mock-storefront.myshopify.com"
  }
}

イベント: ecommerce.product_viewed
タイプ: 推奨イベント
トリガー: 顧客が製品ページを閲覧したとき
データソース: Braze SDK
ユースケース: ブラウズ放棄

イベント: ecommerce.cart_updated
タイプ: 推奨イベント
トリガー: 顧客がショッピングカートに商品を追加、削除、または更新したとき
データソース: Braze SDK
ユースケース: カート放棄

放棄カートキャンバスでは、まず最初のショッピングカートの Liquid タグを追加し、メッセージ内のショッピングカートのコンテキストを取得する必要があります。

1

{% shopping_cart {{context.${cart_id}}} %}

そして、次のショッピングカートの Liquid タグをメッセージに追加できます。

イベント: ecommerce.checkout_started
タイプ: 推奨イベント
トリガー: ユーザーがチェックアウトページに移動したとき
データソース: Braze REST API
ユースケース: チェックアウト放棄

放棄チェックアウトキャンバスでは、まず次の Liquid タグを使用する必要があります。

1
2

{% shopping_cart {{context.${cart_id}}} :abort_if_not_abandoned false %}
{{context.${cart_id}}}

次に、以下の Liquid タグをメッセージに追加し、チェックアウト時にカート内の商品を参照できます。

イベント: ecommerce.order_placed
タイプ: 推奨イベント
トリガー: ユーザーがチェックアウトプロセスを正常に完了し、注文を確定したとき
データソース: Braze REST API
ユースケース: 注文確認、購入後リターゲティング、アップセルまたはクロスセル

イベント: shopify_fulfilled_order
タイプ: カスタムイベント
トリガー: ユーザーの注文がフルフィルメントされ、発送の準備ができたとき
データソース: Braze REST API
ユースケース: (トランザクション) フルフィルメントの更新

イベント: shopify_partially_fulfilled_order
タイプ: カスタムイベント
トリガー: ユーザーの注文の一部がフルフィルメントされ、発送の準備ができたとき
データソース: Braze REST API
ユースケース: (トランザクション) フルフィルメントの更新

イベント: shopify_paid_order
タイプ: カスタムイベント
トリガー: ユーザーの注文が Shopify 内で支払い済みとマークされたとき
データソース: Braze REST API
ユースケース: (トランザクション) 支払い確認

イベント: shopify_cancelled_order
タイプ: カスタムイベント
トリガー: ユーザーの注文がキャンセルされたとき
データソース: Braze REST API
ユースケース: (トランザクション) 注文キャンセル確認

イベント: shopify_order_refunded
タイプ: カスタムイベント
トリガー: ユーザーの注文が返金されたとき
データソース: Braze REST API
ユースケース: (トランザクション) 返金確認

イベント: shopify_account_login
タイプ: カスタムイベント
トリガー: ユーザーがアカウントにログインしたとき
データソース: Braze REST API
ユースケース: ウェルカムシリーズ

サポートされている Shopify カスタム属性

1
2
3
4
5
6
7
8
9
10
11
12
13

{
  "attributes": [
    {
      "shopify_tags": "VIP_customer",
      "shopify_total_spent": "60.00",
      "shopify_order_count": "3",
      "shopify_last_order_id": "1234567",
      "shopify_last_order_name": "test_order",
      "shopify_zipcode": "10001",
      "shopify_province": "null"
    }
  ]
}

Liquid のパーソナライゼーション

Shopify カスタム属性に Liquid パーソナライゼーションを追加するには、[+ パーソナライゼーション] を選択します。次に、パーソナライゼーションタイプとして [カスタム属性] を選択します。

「パーソナライゼーションの追加」セクションで「属性」ドロップダウンが展開されています。

カスタム属性を選択したら、デフォルト値を入力して Liquid スニペットをメッセージにコピーします。

Liquid スニペットをメッセージに貼り付ける。

サポートされている Shopify 標準属性

  • メール
  • 名
  • 姓
  • 電話
  • 市区町村
  • 国

SDK によるデータ収集

Braze SDK が収集するデータの詳細については、SDK データ収集を参照してください。

履歴バックフィル

Shopify ストアのオンボーディング中に、履歴バックフィルを通じて初期データ同期を開始し、顧客とすぐにエンゲージメントを開始できます。このバックフィルの一環として、Braze は Shopify インテグレーション接続前の過去 90 日間のすべての顧客と注文確定イベントの初期データ同期を実行します。Braze が Shopify の顧客をインポートする際、設定で選択した external_id タイプを割り当てます。

同期された注文イベントデータはセグメンテーションに使用できますが、収益データ自体はユーザープロファイルや収益 – ラストタッチアトリビューションダッシュボードには反映されません。

Shopify 履歴バックフィルの設定

  1. Shopify データの追跡ステップで、履歴バックフィルをオンにします。

履歴バックフィルが選択された Shopify インテグレーションの「Shopify データの追跡」ステップ。

  1. インテグレーション設定が完了すると、Braze は初期データ同期を開始します。進捗状況は、インテグレーション設定の [Shopify データ] タブで確認できます。

イベントがアクティブに同期中であることを示すスピナーが表示された Shopify インテグレーション設定ページ。

同期データ

初期データ同期では、Braze は Shopify インテグレーション接続前の過去 90 日間の顧客と注文確定をインポートします。Braze が Shopify の顧客をインポートする際、設定で選択した external_id タイプを割り当てます。
Github   GitHub でこのページを編集
New Stuff!