Ranqa

← Integraatiot

Shopify — arvostelukutsut ja widgetit

Upota pisteesi ja lähetä arvostelukutsuja maksettujen tai toimitettujen tilausten jälkeen — noin 15 minuuttia webhook-tokenilla. Yrityssivun vahvistus on ilmainen.

1. Teeman widget

Liitä iframe alatunnisteeseen, tuotesivulle tai ostoskoriin. Hanki slug hallintapaneelista.

Aseta merkki sivuston alatunnisteeseen. Ostajat näkevät elävän RanqaScore-arvon ja hakukoneet saavat luonnollisen linkin takaisin Ranqa-sivullesi.

{% comment %} Ranqa score badge — replace SLUG {% endcomment %}
<iframe
  src="https://ranqa.me/widget/SLUG?type=badge"
  width="280"
  height="90"
  style="border:0;overflow:hidden"
  title="RanqaScore"
  loading="lazy"
></iframe>

2. Tilaus → kutsu

Suuntaa Shopify webhook Ranqaan. Commerce tai Pro — token URL, ei mukautettuja otsikoita.

Tyypillinen asennus: ~15 minuuttia.

Lataa Shopify-paketti (.zip) →

  1. Hallintapaneeli → Shopify / Woo: luo webhook-token.
  2. Shopify → Asetukset → Ilmoitukset → Webhookit (tai Flow).
  3. Tapahtuma: Tilausmaksu / Tilaus täyttäminen. Muoto: JSON.
  4. Liitä token-URL hallintapaneelista toimitus-URL:na.
POST https://ranqa.me/api/v1/commerce/shopify/orders?token=YOUR_WEBHOOK_TOKEN
Content-Type: application/json

(Shopify order JSON — email + line_items used)

# Or: Authorization: Bearer rnq_… (Growth/Pro API key)

Määritä Shopify product_id Ranqa product.externalId:lle, jotta tuotekutsut linkitetään oikein.

Avaa hallintapaneelin asetus →

3. Täysi API

Voit myös kutsua POST /api/v1/invites Bearer API -avaimella.

API-dokumentaatio →

Asennuksen UKK

Tarvitsenko API-avaimen tilaus → kutsu varten?
Commerce ja Pro voivat käyttää webhook-token URL:ia myymälän tilanneventteihin. Growth/Pro API-avaimet ovat POST /api/v1/invites ja mukautetuille stackeille — katso https://ranqa.me/developers
Korvaavatko widgetit Schema.org AggregateRatingin?
Ei. Widgetit upottavat live-pisteet myymälääsi. Hakukoneet indeksoivat AggregateRatingin julkisilla Ranqa-yritys/tuotesivuillasi, kun arvosteluja on olemassa.
Kuinka kauan tyypillinen kaupankäynnin asennus kestää?
Noin 15 minuuttia valmiille moduuleille (token + webhook/plugin + testitilaus). Katalogin kartoitus ja PDP-widgetin sijoittaminen saattavat kestää kauemmin teeman mukaan.