Egenverk Conversion Relay · Dokumentation

Referens

v1.7.0WP 6.5+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.

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.

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.

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:

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.