Préparer votre compte Merchant Center

Vous devez disposer d'un compte Merchant Center en règle et de produits approuvés pour les fiches gratuites dans votre compte. Pour commencer, consultez les articles suivants du centre d'aide :

Une fois que vous avez configuré votre compte Merchant Center avec des produits, vous devez remplir les exigences de cette section avant de créer l'intégration de l'API.

1. Paramètres Merchant Center

Assurez-vous que les paramètres suivants sont configurés dans votre compte Google Merchant Center :

1.1. Conditions de retour

Vous devez définir vos conditions de retour dans Merchant Center, car il s'agit d'une exigence du Merchant of Record qui sera mentionnée sur l'écran de paiement. Les conditions configurées s'appliquent globalement à votre compte. Toutefois, vous pouvez utiliser l'attribut de flux return_policy_label pour limiter une condition de retour donnée à un sous-ensemble de produits.

Si votre compte Merchant Center est un compte avancé, vous devez configurer vos conditions de retour dans chaque sous-compte.

Vous devez inclure les frais de retour, le délai de retour et un lien vers les conditions complètes. Pour en savoir plus sur la configuration des retours, cliquez ici.

1.2. Informations sur le service client

Vous devez configurer les informations sur votre service client dans Merchant Center. Il sera utilisé pour générer le lien "Contacter le marchand" sur la page de confirmation de la commande. En savoir plus sur la configuration des informations sur le service client

2. Données produit

Vous devez mettre à jour votre flux de produits pour indiquer l'éligibilité et fournir des données de conformité. Ces informations sont nécessaires pour activer le paiement via UCP avec Google, car elles permettent aux agents de déterminer l'éligibilité des produits, de calculer le coût total exact et d'afficher les avertissements légaux obligatoires à l'utilisateur.

2.1. Éligibilité au paiement agentif

Cette option permet d'activer l'expérience de paiement sur Google pour un produit.

Ce paramètre est fourni à l'aide d'un attribut de produit native_commerce contenant une seule valeur booléenne. Si elle est définie sur "false" ou manquante, le produit ne pourra pas être ajouté au panier.

2.2. Avertissements sur les produits

Cette valeur est obligatoire pour les articles soumis à des exigences d'avertissement réglementaires (par exemple, Proposition 65 de l'État de Californie). Vous êtes responsable du respect de toutes les lois applicables, y compris celles concernant les avertissements sur les produits. Ces avertissements s'affichent de manière bien visible sur l'écran de paiement lorsque vous les fournissez.

Fournissez le groupe d'attributs consumer_notice avec deux sous-attributs :

  • consumer_notice_type : doit être défini sur legal_disclaimer, safety_warning ou prop_65.
  • consumer_notice_message : chaîne (1 000 caractères maximum). Les balises HTML <b>, <br> et <i> sont acceptées.

2.3. Code produit

Le id de votre flux de produits doit correspondre à l'ID de produit attendu par votre API Checkout. Si elles correspondent, aucune action n'est requise. Sinon, utilisez l'attribut personnalisé merchant_item_id pour les mapper.

2.4. Ajouter les attributs à vos produits

Les exemples suivants présentent différentes options pour fournir le produit à Merchant Center.

2.4.1. Flux

Nous vous recommandons de créer une source de données supplémentaire (instructions ici). Vous pouvez ajouter cette information à votre flux principal, mais soyez prudent, car une mise en forme incorrecte peut avoir un impact sur l'ingestion régulière des produits.

Remarque sur la syntaxe : Assurez-vous que les chaînes complexes (comme le message de la Proposition 65) ne contiennent pas de caractères qui endommagent le format de votre fichier (comme des virgules supplémentaires dans un fichier CSV), sauf s'ils sont correctement échappés.

Format du fichier texte :

ID native_commerce consumer_notice
11111 TRUE prop_65:This product can expose you...
22222 TRUE
33333 FALSE

Format XML :

<item>
  <g:id>11111</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
  <g:consumer_notice>
    <g:consumer_notice_type>prop_65</g:consumer_notice_type>
    <g:consumer_notice_message>
      This product can expose you to chemicals...
    </g:consumer_notice_message>
  </g:consumer_notice>
</item>
<item>
  <g:id>22222</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
</item>
<item>
  <g:id>33333</g:id>
  <g:native_commerce>FALSE</g:native_commerce>
</item>

2.4.2. Content API

Fournissez les attributs en tant qu'attributs personnalisés. Ils doivent être inclus dans une products.insert contenant le produit complet, car products.update ne permet pas de mettre à jour les customAttributes.

Exemple :

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

2.4.2. API Merchant

Fournissez les attributs en tant qu'attributs personnalisés. Vous pouvez les ajouter à vos accounts.productInputs.insert existants ou les mettre à jour directement à l'aide de accounts.productInputs.patch.

Exemple pour insert :

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

Exemple pour update :

Type Nom Valeur
Paramètres de chemin d'accès productInput.name accounts/{account}/productInputs/en~US~11111
Paramètres de requête updateMask customAttributes.native%20commerce,customAttributes.consumer%20notice,customAttributes.product%20fee,customAttributes.merchant%20item%20id
dataSource dataSources/{datasource} 
{
  "offerId": "11111",
  "contentLanguage": "en",
  "feedLabel": "US",
    "customAttributes": [
    {
      "name": "native commerce",
      "groupValues": [
        {
          "name": "checkout eligibility",
          "value": "true"
        }
      ]
    },
    {
      "name": "consumer notice",
      "groupValues": [
        {
          "name": "notice type",
          "value": "prop_65"
        },
        {
          "name": "notice message",
          "value": "This product can expose you to chemicals..."
        }
      ]
    },
    {
      "name": "product fee",
      "groupValues": [
        {
          "name": "product fee type",
          "value": "US_AZ_TIRE_FEE"
        },
        {
          "name": "product fee amount",
          "value": "2.75 USD"
        }
      ]
    },
    {
      "name": "merchant item id",
      "value": "some_checkout_item_id_1"
    }
  ]
}

3. Restrictions concernant les produits

Les catégories de produits suivantes ne peuvent pas être réglées. Assurez-vous que ces éléments ont native_commerce vide ou défini sur false.

Produits financiers et modèles de facturation récurrente

  • Abonnements : produits nécessitant des cycles de facturation récurrents.
  • Paiements échelonnés : transactions nécessitant des plans de paiement ou un financement imposés par le marchand.

Produits personnalisés et options de traitement des commandes

  • Articles personnalisés : articles nécessitant des choix de conception personnalisés (par exemple, gravures, monogrammes).
  • Articles non neufs ou en vente finale : produits reconditionnés, articles d'occasion et articles marqués comme "Vente finale" (non retournables).
  • Articles en précommande : produits dont la date de sortie est future et dont la livraison est différée.
  • Services groupés : articles nécessitant des contrats supplémentaires, tels que des garanties, une installation ou une configuration.
  • Frais de port spéciaux : articles nécessitant des frais de port non standards (par exemple, fret, livraison premium).
  • Cadeaux : transactions nécessitant une logistique de facturation fractionnée ou un prix masqué pour les destinataires.
  • Activation en magasin : produits qui doivent être activés physiquement dans un magasin.

Restrictions liées aux règles et à la sécurité

  • Contenu soumis à des limites d'âge : articles nécessitant une validation de l'identité (par exemple, Alcool, tabac).
  • Contenu interdit : armes, contenu réservé aux adultes, produits de santé/pharmaceutiques, contrefaçons ou toute autre catégorie bloquée par le règlement standard de Google Shopping.

Biens et services numériques

  • Services : cours, cours en ligne et voyages organisés (sauf s'ils sont intégrés à l'aide de rails de voyage spécifiques).
  • Location : location de films, de matériel ou de véhicules.
  • Articles virtuels : monnaie en jeu, articles de MMORPG ou skins
  • Dépendances logicielles : produits qui nécessitent que l'utilisateur installe un logiciel spécifique avant de finaliser l'achat.