Przygotowywanie konta Merchant Center

Musisz mieć konto Merchant Center w dobrej kondycji i zatwierdzone produkty do wyświetlania bezpłatnych informacji na koncie. Aby rozpocząć, zapoznaj się z tymi artykułami w Centrum pomocy:

Po skonfigurowaniu konta Merchant Center z produktami musisz spełnić wymagania opisane w tej sekcji, zanim zaczniesz tworzyć integrację API.

1. Ustawienia Merchant Center

Upewnij się, że na koncie Google Merchant Center masz skonfigurowane te ustawienia:

1.1. Zasady zwrotów

Musisz zdefiniować zasady zwrotów w Merchant Center, ponieważ jest to wymagane w przypadku sprzedawcy, który jest stroną transakcji, i będzie się do nich odwoływać na ekranie płatności. Skonfigurowane zasady obowiązują globalnie na Twoim koncie, ale możesz użyć atrybutu pliku danych return_policy_label, aby ograniczyć dane zasady zwrotów do podzbioru produktów.

Jeśli Twoje konto Merchant Center jest kontem zaawansowanym, zasady zwrotów muszą być skonfigurowane na każdym subkoncie.

Musisz podać koszt zwrotu, szybkość zwrotu (okres) i link do pełnych zasad. Więcej informacji o konfigurowaniu zwrotów znajdziesz tutaj.

1.2. Informacje o obsłudze klienta

Musisz skonfigurować informacje o obsłudze klienta w Merchant Center. Będzie on używany do generowania linku „Skontaktuj się ze sprzedawcą” na stronie potwierdzenia zamówienia. Więcej informacji o konfigurowaniu informacji o obsłudze klienta znajdziesz tutaj.

2. Dane produktu

Musisz zaktualizować plik danych o produktach, aby wskazać kwalifikowalność i podać dane dotyczące zgodności. Te informacje są wymagane, aby umożliwić płatność za pomocą UCP w Google, ponieważ pozwalają agentom określić, czy produkt kwalifikuje się do zakupu, obliczyć dokładne łączne koszty i wyświetlić użytkownikowi wymagane ostrzeżenia prawne.

2.1. Wymagania dotyczące płatności agentowych

Spowoduje to włączenie produktu w procesie płatności w Google.

Jest on podawany za pomocą atrybutu produktu native_commerce zawierającego pojedynczą wartość logiczną. Jeśli ma wartość Fałsz lub nie jest podany, produkt nie będzie kwalifikować się do płatności.

2.2. Ostrzeżenia dotyczące produktów

Jest to obowiązkowe w przypadku produktów, które podlegają wymaganiom dotyczącym ostrzeżeń regulacyjnych (np. California Proposition 65). Odpowiadasz za przestrzeganie wszystkich obowiązujących przepisów, w tym wymagań dotyczących ostrzeżeń o produktach. Te ostrzeżenia są wyraźnie widoczne na ekranie płatności, gdy je podasz.

Podaj grupę atrybutów consumer_notice z 2 atrybutami podrzędnymi:

consumer_notice_type: musi być jedną z tych wartości: legal_disclaimer, safety_warning lub prop_65.
consumer_notice_message: ciąg (maks. 1000 znaków). Akceptowane są tagi HTML <b>, <br> i <i>.

2.3. Identyfikator produktu

Wartość id w pliku danych o produktach musi być zgodna z identyfikatorem produktu oczekiwanym przez interfejs Checkout API. Jeśli się zgadzają, nie musisz nic robić. W przeciwnym razie użyj atrybutu niestandardowego merchant_item_id, aby je zmapować.

2.4. Dodawanie atrybutów do produktów

Poniższe przykłady przedstawiają różne opcje dostarczania produktu do Merchant Center.

2.4.1. Pliki danych

Zalecamy utworzenie dodatkowego źródła danych (instrukcje znajdziesz tutaj). Możesz dodać ten atrybut do głównego pliku danych, ale zachowaj ostrożność, ponieważ nieprawidłowe formatowanie może wpłynąć na regularne przesyłanie produktów.

Uwaga dotycząca składni: upewnij się, że złożone ciągi znaków (np. komunikat wymagany przez Prop 65) nie zawierają znaków, które powodują błędy w formacie pliku (np. dodatkowych przecinków w pliku CSV), chyba że są odpowiednio oznaczone.

Format pliku tekstowego:

Identyfikator	native_commerce	consumer_notice
11111	PRAWDA	`prop_65:This product can expose you...`
22222	PRAWDA
33333	FAŁSZ

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.

Podaj atrybuty jako atrybuty niestandardowe. Muszą być one uwzględnione w wywołaniu products.insert zawierającym pełny produkt, ponieważ wywołanie products.update nie obsługuje aktualizowania atrybutów niestandardowych.

Przykład:

"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. Merchant API

Podaj atrybuty jako atrybuty niestandardowe. Możesz je dodać do istniejących accounts.productInputs.insert lub zaktualizować bezpośrednio za pomocą accounts.productInputs.patch.

Przykład dla funkcji 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"
  }
]

Przykład aktualizacji:

Typ	Nazwa	Wartość
Parametry ścieżki	`productInput.name`	`accounts/{account}/productInputs/en~US~11111`
Parametry zapytania	`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. Ograniczenia dotyczące produktów

Poniższe kategorie produktów nie kwalifikują się do płatności. Sprawdź, czy te elementy mają wartość native_commerce lub false.

Produkty finansowe i modele płatności cyklicznych

Subskrypcje: produkty wymagające cyklicznych płatności.
Raty: transakcje wymagające planów płatności lub finansowania narzuconych przez sprzedawcę.

Towary niestandardowe i opcje realizacji

Produkty spersonalizowane: produkty wymagające dostosowania projektu (np. grawerowanie, monogramy).
Produkty niebędące nowymi lub objęte wyprzedażą: odnowione produkty, produkty używane i produkty oznaczone jako „Wyprzedaż” (bez możliwości zwrotu).
Produkty zamówione w przedsprzedaży: produkty z przyszłymi datami premiery i odroczoną realizacją zamówienia.
Usługi dodatkowe: produkty wymagające dodatkowych umów, np. gwarancji, instalacji lub konfiguracji.
Dostawa specjalna: produkty wymagające niestandardowych opłat za dostawę (np. fracht, dostawa premium).
Prezenty: transakcje wymagające logistyki związanej z podzieloną fakturą lub ukrytych cen dla odbiorców.
Aktywacja w sklepie: produkty, które muszą zostać fizycznie aktywowane w sklepie.

Ograniczenia wynikające z zasad i bezpieczeństwa

Produkty z ograniczeniem wiekowym: produkty wymagające weryfikacji tożsamości (np. alkoholu i tytoniu).
Niedozwolone treści: broń, treści dla dorosłych, produkty lecznicze i farmaceutyczne, podróbki lub inne kategorie zablokowane przez standardowe zasady Zakupów Google.

Produkty i usługi cyfrowe

Usługi: lekcje, zajęcia online i pakiety podróżne (chyba że są zintegrowane za pomocą specjalnych szyn płatniczych dla branży turystycznej).
Wypożyczalnie: wypożyczalnie filmów, sprzętu lub leasing.
wirtualne produkty: waluta w grze, produkty w grach MMORPG lub skórki;
Zależności oprogramowania: produkty, które wymagają od użytkownika zainstalowania określonego oprogramowania przed dokonaniem zakupu.