Egenverk Conversion Relay · Dokumentation

Inställningar och leveranser

v1.7.0WP 6.5+PHP 7.4+Uppdaterad 2026-10-14

Allt finns under WooCommerce → Inställningar → Conversion Relay, i tre flikar: Inställningar, Validering & logg och Leveransstatus. Sidan kräver behörighet att hantera WooCommerce. Märket i sidhuvudet visar vilket läge som gäller, Validering eller Produktion.

Inställningar

Fliken har en egen knapp, Spara inställningar, längst ned. Ett ogiltigt Pixel-ID eller en ogiltig API-nyckel stoppar inte resten: det fältet behåller sitt gamla värde, övriga fält sparas och ett meddelande säger vad som inte sparades.

Mätning

Inställning	Från start	Vad den gör
Aktivera mätning (huvudreglage)	Av	Slår på hela tillägget. När den är av laddas inget skript i butiken och inga nya köp fångas eller skickas.
Läge	Validering	I Validering skickas köpen till API:et som kontrollerar dem utan att registrera dem, och webbläsarpixeln är av. I Produktion registreras de i Ads Manager.
Aktivera webbläsarpixel	Av	Laddar OpenAI:s pixel. Används bara i Produktion.
Aktivera Conversions API	Av	Skickar köpen från servern.

Mätningen är bara igång när huvudreglaget är på, ett Pixel-ID är sparat och en samtyckesintegration är vald. Köp kräver dessutom Aktivera Conversions API. Köpet skickas aldrig från webbläsaren, bara från servern.

Köp som redan ligger i kön väntar medan huvudreglaget eller Conversions API är av, och skickas när du slår på igen om de fortfarande är yngre än sju dagar. Ändrar du Läge eller Pixel-ID efter att köp köats pausas de köpen. De skickas aldrig med de nya inställningarna.

Anslutning och samtycke

Pixel-ID hämtar du i Ads Manager. Det får bara innehålla bokstäver, siffror, bindestreck och understreck, högst 128 tecken.
API-nyckel hämtar du också i Ads Manager. En sparad nyckel visas maskerad. Lämna fältet tomt för att behålla den. Knappen Visa API-nyckel visar den bara för administratörer, och en nyckel från wp-config.php eller en miljövariabel visas aldrig. Nyckeln får inte innehålla mellanslag eller styrtecken. Den sparas krypterad med AES-256-GCM, och saknar servern kryptering sparas den inte alls: ange den då på servern.
Samtyckesintegration är Inte konfigurerad från start. Välj Cookiebot eller WP Consent API. Så länge tillägget WP Consent API är inaktivt heter valet WP Consent API (tillägget är inte aktivt) och går inte att välja, om det inte redan är det sparade valet.

Med Cookiebot krävs att besökaren svarat och godkänt marknadsföring. Med WP Consent API används kategorin marknadsföring, och bannern måste ange samtyckestyp (opt-in eller opt-out). Har ingen banner gjort det räknas samtycket som okänt. Okänt eller nekat samtycke stoppar mätningen. Återkallar besökaren samtycket stängs pixeln av direkt och köp från den sessionen som ännu inte skickats stoppas.

Är huvudreglaget på men ingen samtyckesintegration vald, visar Tillägg-sidan och tilläggets egen flik notisen Conversion Relay mäter inte. Välj en samtyckesintegration under WooCommerce → Inställningar → Conversion Relay.

Valfria matchningssignaler

Tre reglage, alla av från start. De hjälper Ads Manager att para ihop ett köp med ett annonsklick när klickets identifierare inte följt med hela vägen, och skickas bara med marknadsföringssamtycke.

Inkludera SHA-256-hashad e-post för servermatchning: faktureringsadressens e-post, trimmad, i gemener och hashad. E-post i klartext skickas aldrig.
Inkludera IP-adress och webbläsarsträng för servermatchning.
Inkludera land, ort, region och postnummer från faktureringsadressen för servermatchning.

IP-adress, webbläsarsträng och plats skickas i klartext, så som API:et beskriver dem. Beskriv dem i din integritetspolicy innan du slår på dem. Ett värde som inte har rätt format utelämnas. Signalerna läses från ordern när köpet köas och sparas krypterade med händelsen.

Pixelns egen automatiska matchning (advanced matching) styrs i Ads Manager, inte här.

Webbläsarhändelser

Fyra reglage, alla på från start. De gäller bara när webbläsarpixeln är på.

Reglage	Händelse
Sidvisningar	`page_viewed`
Produktvisningar	`contents_viewed`
Lägg i varukorg	`items_added`
Påbörjad kassa	`checkout_started`

Loggning

Loggnivå är Fel + varningar från start. De andra valen är Endast fel (alltid aktiverat), Info + varningar + fel och Debug + alla andra nivåer. Info lägger till händelser och köpens statusändringar, debug även samtyckessteg och API-anrop. Loggen hamnar i WooCommerce-loggen, se Felsökning.

Avancerade inställningar

Radera sparad API-nyckel (serverkonfiguration har fortfarande företräde) tar bort den sparade nyckeln när du sparar. En nyckel på servern påverkas inte.
Radera tilläggets tabeller och inställningar vid avinstallation är av från start. Se Data och integritet.

Konfigurationsstatus

Rutan bredvid formuläret visar läget för Mätning, Pixel-ID, API-nyckel, Samtyckesintegration, Action Scheduler och Databaslås. Den bygger på de sparade inställningarna och verifierar inte anslutningen. Databaslås måste vara Tillgänglig för att köp ska kunna köas.

Sidcache

Sidorna bär med sig de inställningar de skapades med. Töm sidcachen efter att du ändrat något, annars fortsätter cachade sidor med de gamla.

Validering & logg

Testa anslutningen: Validera syntetisk API-händelse skickar ett påhittat testköp i valideringsläge, helt utan kunddata. Knappen går inte att trycka på förrän Pixel-ID och API-nyckel finns. Testet fungerar även när mätningen är av och ändrar aldrig någon orders leveransstatus.
Resultatet är Validering bekräftad, API:et svarade · valideringen är obekräftad eller Valideringen kunde inte slutföras. Obekräftat betyder att API:et svarade utan ett kvitto som kunde verifieras. Inget av dem bevisar att köp kopplas till annonser.
Före produktionsstart påminner om att lägga en testorder med varje betalmetod innan du byter till Produktion.
Händelselogg har knappen Öppna loggen, som öppnar WooCommerce-loggen med källan egenverk-conversion-relay.
Valideringslogg visar de senaste 100 testerna med tid (UTC), status och felkod, utan nycklar och utan innehåll.

Misslyckades det senaste försöket att spara ett köp i kön visas en varning här. Den försvinner när nästa köp köas.

Leveransstatus

Fliken visar antalet köp per status och de senaste 50 köpen med Order, Läge, Status, Försök och Felkod. Kön finns också under WooCommerce → Status → Schemalagda åtgärder, grupp egenverk-conversion-relay.

Status

Status	Betyder
Väntande	Köat, inte skickat än.
Skickas	Ett försök pågår.
Försöker igen	Ett försök misslyckades tillfälligt och ett nytt är schemalagt.
`validated`	API:et bekräftade köpet i valideringsläget. Statusen visas oöversatt.
Godkänd	API:et bekräftade köpet i produktion.
Obekräftad	API:et svarade utan ett kvitto som kunde verifieras. Försöks inte om automatiskt.
Misslyckad	Felsvar som inte går att försöka om, åtta försök förbrukade, sjudagarsgränsen nådd eller nyckeln saknas.
Pausad	Läge eller Pixel-ID ändrades efter att köpet köades.
Stoppad	Samtycket gäller inte längre, ordern är inte betald längre (till exempel annullerad) eller har återbetalats helt eller delvis.
Utgången	Köpet hann inte skickas inom sju dagar.

När ett köp räknas

När betalningen bekräftas eller ordern når Behandlas eller Slutförd, det som kommer först. Postförskott, banköverföring och order som markerats betalda för hand räknas alltså också.
En order som bara skapats, som står som pausad (on hold) eller där betalningen inte bekräftats räknas inte. Förnyelser av prenumerationer räknas inte.
Ordern måste ha lagts med marknadsföringssamtycke, och betalningen får inte ske i en förfrågan där samtycket nekats. Samtycke som ges först efter betalningen räknas inte.
Varje order skickas en gång, även om betalningen rapporteras två gånger.

Leverans och omförsök

Köpen skickas i bakgrunden med Action Scheduler, så kassan väntar aldrig. Nätverksfel, timeout, för många anrop och serverfel hos mottagaren försöks igen med ökande väntetid. Andra felsvar ger Misslyckad direkt. Ett köp får högst åtta försök och skickas aldrig när det är äldre än sju dagar.

Försök igen finns för Misslyckad, Obekräftad och Pausad. Det fungerar så länge köpet har försök kvar och är yngre än sju dagar. Ett nytt försök ändrar aldrig läge, Pixel-ID, innehåll, ID, ursprunglig tid eller samtyckeskrav. Ett pausat köp pausas igen om inställningen fortfarande skiljer sig, så återställ den först.

Återbetalningar efter att köpet skickats rapporteras inte. Händelser som redan skickats kan inte tas tillbaka.

Avaktivera och aktivera igen

Avaktiverar du tillägget tas dess schemalagda jobb bort. Aktiverar du det igen återupptas köp som fortfarande är giltiga, med samma samtycke, läge och åldersgräns som när de köades.