Brauche ich einen API-Schlüssel für Bestellung → Einladung?

Commerce und Pro können eine Webhook-Token-URL für Storefront-Bestellereignisse verwenden. Growth/Pro-API-Schlüssel sind für POST /api/v1/invites und benutzerdefinierte Stacks — siehe https://ranqa.me/developers

Ersetzen Widgets Schema.org AggregateRating?

Nein. Widgets betten eine Live-Bewertung in Ihrem Storefront ein. Suchmaschinen durchsuchen AggregateRating auf Ihren öffentlichen Ranqa-Unternehmens-/Produktseiten, wenn Bewertungen vorhanden sind.

Wie lange dauert ein typisches Commerce-Setup?

Etwa 15 Minuten für fertige Module (Token + Webhook/Plugin + Testbestellung). Die Katalogzuordnung und die Platzierung des PDP-Widgets können je nach Ihrem Theme länger dauern.

← Integrationen

Shopify — Bewertungseinladungen & Widgets

Score einbetten und Bewertungseinladungen nach bezahlten oder erfüllten Bestellungen senden — ca. 15 Minuten mit Webhook-Token. Unternehmensseite kostenlos verifizieren.

1. Theme-Widget

Fügen Sie ein iframe im Footer, auf der Produktseite oder im Warenkorb ein. Holen Sie sich Ihren Slug aus dem Dashboard.

Platzieren Sie das Badge im Fußbereich der Website. Käufer sehen einen aktuellen RanqaScore und Suchmaschinen erhalten einen natürlichen Link zurück zu Ihrer Ranqa-Seite.

{% 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. Bestellung → Einladung

Richten Sie einen Shopify-WebHook auf Ranqa aus. Commerce oder Pro – Token-URL, keine benutzerdefinierten Header.

Typisches Setup: ~15 Minuten.

Shopify-Paket (.zip) herunterladen →

Dashboard → Shopify / Woo: Webhook-Token erstellen.
Shopify → Settings → Notifications → Webhooks (oder Flow).
Ereignis: Bestellzahlung / Bestellabwicklung. Format: JSON.
Fügen Sie die Token-URL aus dem Dashboard als Liefer-URL ein.

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)

Ordnen Sie Shopify product_id Ranqa product.externalId zu, damit die Produkt-Einladungen korrekt verlinkt sind.

Dashboard-Setup öffnen →

3. Vollständige API

Sie können auch POST /api/v1/invites mit einem Bearer-API-Schlüssel aufrufen.

API-Dokumentation →

Setup FAQ

Brauche ich einen API-Schlüssel für Bestellung → Einladung?: Commerce und Pro können eine Webhook-Token-URL für Storefront-Bestellereignisse verwenden. Growth/Pro-API-Schlüssel sind für POST /api/v1/invites und benutzerdefinierte Stacks — siehe https://ranqa.me/developers
Ersetzen Widgets Schema.org AggregateRating?: Nein. Widgets betten eine Live-Bewertung in Ihrem Storefront ein. Suchmaschinen durchsuchen AggregateRating auf Ihren öffentlichen Ranqa-Unternehmens-/Produktseiten, wenn Bewertungen vorhanden sind.
Wie lange dauert ein typisches Commerce-Setup?: Etwa 15 Minuten für fertige Module (Token + Webhook/Plugin + Testbestellung). Die Katalogzuordnung und die Platzierung des PDP-Widgets können je nach Ihrem Theme länger dauern.