---
title: "Referens — Egenverk Conversion Relay"
description: "Konstanter, filter, platser i WooCommerce, Content Security Policy och cacheregler för Conversion Relay."
canonical: https://egenverk.se/plugins/conversion-relay/docs/referens
lang: sv
updated: 2026-10-14
alternate: https://egenverk.se/en/plugins/conversion-relay/docs/reference.md
---
# Referens

Egenverk Conversion Relay · v1.7.0 · WordPress 6.5+, WooCommerce 8.2+, PHP 7.4+ · Uppdaterad 2026-10-14

## Konstanter och miljövariabler

| Namn | Vad |
| --- | --- |
| `EGENVERK_CONVERSION_RELAY_API_KEY` | API-nyckeln till Conversions API. Som konstant i `wp-config.php` eller som miljövariabel. Går före den sparade nyckeln och visas aldrig i admin. |
| `CONVERT_RELAY_API_KEY` | Det tidigare namnet, läses fortfarande. Byt till det nya namnet. |

Ordningen är konstant, sedan miljövariabel med samma namn och sist den sparade nyckeln. Ett uttryckligen tomt värde på servern går före den sparade nyckeln.

```php
define( 'EGENVERK_CONVERSION_RELAY_API_KEY', 'din-nyckel' );
```

## Filter

Filter som fortfarande är registrerade under de gamla namnen `convert_relay_*` körs, men med en varning om att de är föråldrade. Byt till namnen nedan.

### egenverk_conversion_relay_capture_order

Avgör om en betald order ska räknas som köp. Argument:

- `$capture` (bool): `true`, eller `false` om ordern är en förnyelse av en prenumeration.
- `$order` (`WC_Order`): ordern.

Returnera `false` för att utesluta ordern, till exempel kopior som skapats av tillägg som duplicerar eller delar order.

```php
add_filter(
	'egenverk_conversion_relay_capture_order',
	function ( $capture, $order ) {
		if ( $order->get_meta( '_min_kopia_av_order' ) ) {
			return false;
		}
		return $capture;
	},
	10,
	2
);
```

Metafältet i exemplet är bara ett exempel. Använd det som ditt eget tillägg sätter på kopiorna.

### egenverk_conversion_relay_allowed_origins

De ursprung som får skicka webbläsarens förfrågningar till tillägget, till exempel ett nekat samtycke. Argument:

- `$origins` (array): ursprung som `https://example.com`, det vill säga schema, värd och eventuell port utan avslutande snedstreck. Från start butikens startadress och WordPress-adress.

Returnera hela listan. Ett ursprung måste matcha förfrågans `Origin` exakt. Ett avvisat ursprung loggas som varning högst en gång i timmen.

```php
add_filter(
	'egenverk_conversion_relay_allowed_origins',
	function ( $origins ) {
		$origins[] = 'https://shop.example.com';
		return $origins;
	}
);
```

## Platser i WooCommerce

| Vad | Var |
| --- | --- |
| Inställningar, validering och leveranser | WooCommerce → Inställningar → Conversion Relay, flikarna **Inställningar**, **Validering & logg** och **Leveransstatus** |
| Logg | WooCommerce → Status → Loggar, källa `egenverk-conversion-relay` |
| Kön | WooCommerce → Status → Schemalagda åtgärder, grupp `egenverk-conversion-relay` |

På Tillägg-sidan finns också länken **Inställningar** till tillägget.

## Händelser

| Händelse | Varifrån | När |
| --- | --- | --- |
| `page_viewed` | Webbläsaren | Sidvisning |
| `contents_viewed` | Webbläsaren | Produktvisning |
| `items_added` | Webbläsaren | Lagt i varukorgen |
| `checkout_started` | Webbläsaren | Påbörjad kassa, med de första 50 raderna i varukorgen |
| `order_created` | Servern | Bekräftat köp |

Köpets summa är orderns totalbelopp efter rabatter, med moms, frakt och avgifter. Butiker med valutor utanför ISO 4217 eller med antal i decimaler stöds inte.

## Content Security Policy

Har webbplatsen en Content Security Policy, lägg till OpenAI:s adresser i den befintliga:

```text
script-src  https://bzrcdn.openai.com
connect-src https://bzrcdn.openai.com https://bzr.openai.com
img-src     https://bzr.openai.com
```

Behåll din nuvarande nonce- eller hashpolicy. `unsafe-inline` behövs inte.

## Sidcache och CDN

Servern läser samtycke och annonsklick från kakorna i de förfrågningar WooCommerce ändå gör. Sidcachen och ett CDN får därför inte leverera cachad HTML till förfrågningar med de här kakorna, och måste skicka kakorna vidare till PHP:

- `wp_woocommerce_session_*`
- `woocommerce_items_in_cart`
- `wordpress_logged_in_*`

Sidorna är i övrigt likadana för alla gäster och kan cachas. Töm sidcachen efter att du ändrat inställningar eller uppdaterat tillägget.

## Resurser

- [Produktsida](https://egenverk.se/plugins/conversion-relay)
- [Ändringslogg](https://egenverk.se/plugins/conversion-relay/changelog)
- [Docs](https://egenverk.se/plugins/conversion-relay/docs)
- Föregående: [Felsökning](https://egenverk.se/plugins/conversion-relay/docs/felsokning)