loyalty_points: Definition

Use loyalty_points attribute lets you specify how many and what type of loyalty points a customer receives when buying your product.

When to use

Optional for products targeting Japan

If you’re targeting Japan and you offer loyalty points for your purchasing your product, submit information about these points using the loyalty_points.

The loyalty_points attribute uses 3 sub-attributes:

  • name (optional)
    The name of the loyalty points program (Up to 12 full-width characters or 24 roman characters, e.g., Program A).
  • points_value (required)
    Number of loyalty points a customer receives when purchasing your product (e.g., 100).
  • ratio (optional)
    The ratio of a point when converted to currency (e.g., 0.5). If you don’t include a value, the default is 1.0.

Format

Follow these formatting guidelines to make sure we understand the data you're submitting. 

Type Unicode characters (Recommended: ASCII only)
Repeated field No
 
File format Example entry
Text feeds

Format the value by submitting the name, points_value, and ratio each separated with a colon ( : ). Don’t use quotation marks. All colons, even for blank values, are required, i.e. two colons are required. You should include attributes in the order of priority.

For example, for Program A with 100 points and equal to 0.5 currency units, submit:

Program A:100:0.5

To default to 1.0 currency unit, still include the colon, but leave the value blank:

Program A:100:

To submit only 100 points, include the colons, and leave the other 2 values blank:

:100:
XML feeds

<g:loyalty_points>

  <g:name>Program A</g:name>

  <g:points_value>100</g:points_value>

  <g:ratio>1.0</g:ratio>

</g:loyalty_points>

Content API v2 (JSON)

"loyalty_points": {

   "name": "Program A",

   "pointsValue": 100,

   "ratio": 1.0

}

Content API v2 (XML)

<loyalty_points>

  <name>Progress A</name>

  <points_value>100</points_value>

  <ratio>1.0</ratio>

</loyalty_points>

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products and get the best performance from your ads.

Minimum requirements

These are the requirements you'll need to meet to show ads for your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page of your Merchant Center account. 

  • There are no minimum requirements for this attribute. Keep in mind that you still need to follow the formatting guidelines or the information you submit can't be used.

Best practices

These are best practices that can help you go beyond the basic requirements to optimize your product data for performance. 

  • Submit loyalty points that have a specific monetary value. Loyalty points are supported only if they have a monetary value. For example, the following types of points aren’t supported: mileage and loyalty points that are only exchangeable with goods. 
  • Submit points that are issued by you. You can also submit cross-industry points as long as you issue the points. For example, the following types of points aren’t supported: points associated with credit cards and electronic money. 

Examples

Text feed

Format the value by separating each sub-attribute (name, points_value, and ratio) with a colon ( : ). 

For example, for Google loyalty program with 100 points where 1 point equals 0.5 currency unit, submit:

Google loyalty program:100:0.5

To default to 1 point equals 1.0 currency unit, still include the colon, but leave the value blank:

Google loyalty program:100:

To submit only 100 points, include the colons, and leave the other 2 values blank:

:100:

Was this article helpful?
How can we improve it?