Tổng quan về chương trình khách hàng thân thiết

Giới thiệu các lợi ích của cửa hàng trên Google bằng chương trình khách hàng thân thiết. Bạn có thể gửi nhiều lợi ích (chẳng hạn như vận chuyển miễn phí, đổi điểm và áp dụng giá dành riêng cho thành viên). Các lợi ích của chương trình khách hàng thân thiết có thể xuất hiện trong trang thông tin miễn phí, quảng cáo Mua sắm và quảng cáo kho hàng tại địa phương trên các nền tảng của Google, bao gồm cả Google Tìm kiếm, thẻ Mua sắm và Google Wallet.

Với Merchant API, người bán và nhà cung cấp chương trình khách hàng thân thiết bên thứ ba thay mặt cho người bán có thể định cấu hình và duy trì chương trình khách hàng thân thiết theo phương thức lập trình bằng LoyaltyProgramService. Dịch vụ này cho phép bạn tạo, truy xuất, liệt kê, cập nhật và xoá chương trình khách hàng thân thiết.

Để biết thêm thông tin về các yêu cầu đối với doanh nghiệp và nguyên tắc chính sách, hãy xem bài viết Giới thiệu về chương trình khách hàng thân thiết của người bán trong Trung tâm trợ giúp của Merchant Center.

Khái niệm chính

Hãy lưu ý các khái niệm và giới hạn sau đây khi làm việc với chương trình khách hàng thân thiết:

  • Giá trị nhận dạng cấp tài khoản: Merchant API xác định chương trình khách hàng thân thiết theo mã tài khoản Merchant Center sở hữu.
  • Giới hạn một chương trình: Merchant API chỉ hỗ trợ một chương trình khách hàng thân thiết cho mỗi tài khoản nhà bán hàng.
  • Quyền sở hữu tài khoản trực tiếp: Bạn phải định cấu hình chương trình khách hàng thân thiết trực tiếp trên tài khoản người bán mục tiêu (accounts/{ACCOUNT_ID}). Dịch vụ này không hỗ trợ quản lý chương trình khách hàng thân thiết ở cấp tài khoản nâng cao cho các tài khoản phụ. Nhà cung cấp chương trình khách hàng thân thiết bên thứ ba có quyền truy cập được uỷ quyền vào tài khoản của người bán có thể thay mặt người bán quản lý chương trình.
  • Xem xét nội dung biên tập: Sau khi bạn tạo hoặc cập nhật một chương trình khách hàng thân thiết, chương trình đó sẽ được xem xét. Trường review_result.review_status cho biết chương trình là UNDER_REVIEW, APPROVED hay REJECTED.
  • Khu vực được hỗ trợ: Chương trình khách hàng thân thiết của người bán được cung cấp ở các quốc gia được hỗ trợ, bao gồm Úc, Brazil, Canada, Pháp, Đức, Ấn Độ, Italy, Mexico, Hà Lan, Hàn Quốc, Tây Ban Nha, Vương quốc Anh và Hoa Kỳ.
  • Yêu cầu về cấp: Các cấp có thể không mất phí tham gia, yêu cầu phí thành viên, yêu cầu ngưỡng chi tiêu hoặc yêu cầu thẻ tín dụng mang thương hiệu của người bán. Chúng tôi không hỗ trợ các cấp dựa trên nghề nghiệp (chẳng hạn như cấp sinh viên hoặc quân nhân).
  • Đặc quyền và lợi ích: Các chương trình hỗ trợ dịch vụ vận chuyển miễn phí, điểm có thể sử dụng và giá thành viên. Trong quảng cáo, giá thành viên phải có mức chiết khấu ít nhất là 5% hoặc 5 đơn vị tiền tệ so với giá thường hoặc giá ưu đãi.

Điều kiện tiên quyết

Trước khi quản lý chương trình khách hàng thân thiết bằng Merchant API, hãy đảm bảo bạn đáp ứng các yêu cầu sau:

  • Bạn phải có một tài khoản Merchant Center đang hoạt động (hoặc quyền truy cập được uỷ quyền vào tài khoản của người bán nếu bạn là nhà cung cấp chương trình khách hàng thân thiết bên thứ ba).
  • Bật tiện ích bổ sung chương trình Khách hàng thân thiết cho tài khoản của bạn. Bạn có thể bật tiện ích bổ sung bằng một trong các cách sau:

Dưới đây là yêu cầu mẫu để bật tiện ích bổ sung Chương trình khách hàng thân thiết bằng cách sử dụng API phụ Programs:

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable

cURL

curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

Phương thức

Quản lý chương trình khách hàng thân thiết bằng các phương thức sau:

Tạo chương trình khách hàng thân thiết

Để tạo một chương trình khách hàng thân thiết mới cho một tài khoản, hãy sử dụng phương thức loyaltyPrograms.create. Hãy chỉ định các thông tin chi tiết như nội dung mô tả chương trình, URL đăng ký và các cấp của chương trình cùng với những lợi ích và yêu cầu riêng.

program_label bắt buộc đặt giá trị nhận dạng riêng biệt cho chương trình khách hàng thân thiết. Ví dụ: việc cung cấp nhãn my-rewards sẽ dẫn đến tài nguyên name của accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards.

Sau đây là một yêu cầu mẫu:

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms

{
  "programLabel": "my-rewards",
  "loyaltyProgram": {
    "programName": "my rewards",
    "tiers": [
      {
        "tierName": "gold",
        "tierLabel": "gold",
        "tierBenefits": [
          {
            "otherBenefit": "free gift on your birthday"
          },
          {
            "structuredBenefit": {
              "pointsEarningBenefit": {
                "minimumMoneySpent": {
                  "currencyCode": "USD",
                  "units": "25"
                },
                "pointsEarningBenefitAnnotation": {
                  "pointsEarned": 1.0,
                  "amountSpent": {
                    "currencyCode": "USD",
                    "units": "1"
                  }
                }
              }
            }
          }
        ],
        "requirements": {
          "freeToJoin": true
        }
      }
    ],
    "programDescriptions": [
      "earn rewards buying products you love"
    ],
    "signupUrl": "https://www.example.com/my_rewards_signup",
    "regionCodes": [
      "US"
    ]
  }
}

Thay thế {ACCOUNT_ID} bằng giá trị nhận dạng riêng biệt của tài khoản Merchant Center.

Sau đây là phản hồi mẫu của một yêu cầu thành công:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "earn rewards buying products you love"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

Truy xuất chương trình khách hàng thân thiết

Để truy xuất thông tin chi tiết của một chương trình khách hàng thân thiết cụ thể do bạn sở hữu, hãy sử dụng phương thức loyaltyPrograms.get.

Sau đây là một yêu cầu mẫu:

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

Thay thế {ACCOUNT_ID} bằng mã tài khoản của bạn và {PROGRAM_LABEL} bằng nhãn riêng biệt của chương trình khách hàng thân thiết (ví dụ: my-rewards).

Sau đây là phản hồi mẫu của một yêu cầu thành công:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "earn rewards buying products you love"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

Liệt kê các chương trình khách hàng thân thiết

Để liệt kê tất cả chương trình khách hàng thân thiết do bạn sở hữu và liên kết với tài khoản của bạn, hãy sử dụng phương thức loyaltyPrograms.list.

Sau đây là một yêu cầu mẫu:

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms

Sau đây là phản hồi mẫu của một yêu cầu thành công:

{
  "loyaltyPrograms": [
    {
      "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
      "programName": "my rewards",
      "tiers": [
        {
          "tierName": "gold",
          "tierLabel": "gold",
          "tierBenefits": [
            {
              "otherBenefit": "free gift on your birthday"
            },
            {
              "structuredBenefit": {
                "pointsEarningBenefit": {
                  "minimumMoneySpent": {
                    "currencyCode": "USD",
                    "units": "25"
                  },
                  "pointsEarningBenefitAnnotation": {
                    "pointsEarned": 1.0,
                    "amountSpent": {
                      "currencyCode": "USD",
                      "units": "1"
                    }
                  }
                }
              }
            }
          ],
          "requirements": {
            "freeToJoin": true
          },
          "signupUrl": "https://www.example.com/my-rewards/gold"
        }
      ],
      "programDescriptions": [
        "earn rewards buying products you love"
      ],
      "signupUrl": "https://www.example.com/my_rewards_signup",
      "reviewResult": {
        "reviewStatus": "UNDER_REVIEW"
      },
      "regionCodes": [
        "US"
      ]
    }
  ]
}

Cập nhật chương trình khách hàng thân thiết

Để cập nhật một chương trình khách hàng thân thiết hiện có, hãy sử dụng phương thức loyaltyPrograms.update. Thực hiện cập nhật một phần bằng update_mask hoặc thực hiện thay thế toàn bộ bằng cách bỏ qua mặt nạ.

Cập nhật một phần bằng mặt nạ cập nhật

update_mask cho phép bạn chỉ định chính xác các trường cần cập nhật. Chỉ những trường có trong mặt nạ mới được sửa đổi, còn những trường không có trong mặt nạ thì không thay đổi. Mọi trường bị bỏ qua trong mặt nạ cập nhật đều bị bỏ qua, ngay cả khi được cung cấp trong nội dung yêu cầu.

Yêu cầu mẫu sau đây chỉ cập nhật programDescriptions và advancedSettings:

HTTP

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}?update_mask=program_descriptions,advanced_settings

{
  "programDescriptions": [
    "a new description of the program"
  ],
  "advancedSettings": {
    "hideDisplayFromNonMembers": true
  },
  "signupUrl": "https://www.example.com"
}

Trong ví dụ này, dịch vụ bỏ qua signupUrl vì không có trong update_mask. Trường programDescriptions thay thế hoàn toàn mọi nội dung mô tả đã định cấu hình trước đó.

Sau đây là phản hồi mẫu cho một yêu cầu thành công:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "a new description of the program"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ],
  "advancedSettings": {
    "hideDisplayFromNonMembers": true
  }
}

Thay thế hoàn toàn mà không có mặt nạ cập nhật

Khi bạn bỏ qua tham số update_mask, yêu cầu sẽ thay thế hoàn toàn cấu hình chương trình khách hàng thân thiết.

Sau đây là một yêu cầu mẫu:

HTTP

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

{
  "programName": "Updated Program",
  "signupUrl": "https://example.com/updated",
  "programDescriptions": [
    "Updated description"
  ],
  "regionCodes": [
    "US"
  ],
  "tiers": [
    {
      "tierName": "Gold Tier",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "Free shipping"
        }
      ],
      "requirements": {
        "freeToJoin": true
      }
    }
  ]
}

Sau đây là phản hồi mẫu cho một yêu cầu thành công:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "Updated Program",
  "tiers": [
    {
      "tierName": "Gold Tier",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "Free shipping"
        }
      ],
      "requirements": {
        "freeToJoin": true
      }
    }
  ],
  "programDescriptions": [
    "Updated description"
  ],
  "signupUrl": "https://example.com/updated",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

Xoá chương trình khách hàng thân thiết

Để xoá một chương trình khách hàng thân thiết khỏi tài khoản của bạn, hãy sử dụng phương thức loyaltyPrograms.delete.

Sau đây là một yêu cầu mẫu:

HTTP

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

Nếu thành công, nội dung phản hồi sẽ trống.

Các bước tiếp theo

Trước
Overview
Tiếp
Manage customer loyalty data