Integrating PayPal Commerce Tracking - Revision history

Admin at 16:37, 17 May 2018

2018-05-17T16:37:25Z

Admin at 18:31, 31 July 2012

2012-07-31T18:31:10Z

Admin at 17:12, 23 July 2012

2012-07-23T17:12:04Z

Admin at 17:04, 23 July 2012

2012-07-23T17:04:18Z

Admin at 19:19, 20 July 2012

2012-07-20T19:19:07Z

Admin at 19:10, 20 July 2012

2012-07-20T19:10:21Z

Admin at 21:17, 29 June 2012

2012-06-29T21:17:02Z

Admin at 21:16, 29 June 2012

2012-06-29T21:16:43Z

Admin at 17:29, 20 June 2012

2012-06-20T17:29:50Z

Admin: first

2012-06-20T17:26:24Z

first

New page

[[PayPal]] integration with [[Commerce Tracking]] is somewhat complex due to the fact that:

* PayPal transactions occur solely on their domain https://www.paypal.com/
* PayPal does not allow any third-party software, scripts, or image pixels to be installed as part of their commerce accounts, and ...
* PayPal only allows "behind-the-scenes" notification of transaction success using their [[API]] called [https://www.paypal.com/ipn PayPal IPN]

That said, [[ConversionRuler]] has a solution which works with [[PayPal]].

= Setting up your PayPal form =

First, you need to send PayPal enough information so that ConversionRuler can uniquely identify the transaction and original landing data. To do this, you solely need to pass the ConversionRuler [[Cookie]] which is stored in the JavaScript global variable [[crcookie]].

To do so, in your PayPal form, do the following:

<nowiki><script type="text/javascript">
var craction = 3;
</script>
<form method="post" action="https://www.paypal.com/cgi-bin/webscr" name="paypal">
... add the following between the form tags ...
<script type="text/javascript">
document.write('<input type="hidden" name="custom" value="siteid=' + siteid + '&amp;crcookie=' + crcookie + '&amp;craction=' + craction+'" />');
</script>
</form></nowiki>

Please note the above code uses single quotes and double-quotes - ''they are not the same'', so please cut and paste carefully.

This passes the ConversionRuler cookie, site, and action code to PayPal for final processing when the transaction is complete.

= Connecting from PayPal IPN =

Once the visitor goes to PayPal, the only method of communication is via [https://www.paypal.com/ipn PayPal IPN]. You can use ConversionRuler's fault-tolerant servers for this notification, but most likely, your server will have its own IPN software which you'll need to hook into.

If you want to use ConversionRuler's IPN gateway, the URL is as follows:

https://www.conversionruler.com/bin/paypal

Alternatively, you can parse the custom variable yourself in your own IPN gateway and pass it to conversionruler. It can be passed directly to ConversionRuler's tracking script:

<nowiki><?php
/* This is your custom IPN processing file */
... regular IPN tracking ...
$custom = isset($_REQUEST['custom']) ? $_REQUEST['custom'] : null;
if ($custom) {
$custom .= "&cramount0=" . urlencode($_REQUEST['mc_gross']);
$custom .= "&crtext0=" . urlencode($_REQUEST['txn_id']);
file_get_contents("https://www.conversionruler.com/bin/tracker.php?" + $custom);
}</nowiki>

The above code notifies our server, passes the total amount and the transaction ID, and records the action as originally specified. Note that your PHP configuration on your server must support ''[http://us3.php.net/manual/en/filesystem.configuration.php#ini.allow-url-fopen allow_url_fopen]'' which is generally available on most PHP servers.

If your IPN gateway is written in another language such as [[ASP]], [[Perl]], or [[Java]] then you can use a similar method to pass the parameters onto our servers.

For more information about PayPal and integration with [https://www.paypal.com/ipn PayPal IPN], contact [[MarketRuler Support]].

← Older revision		Revision as of 16:37, 17 May 2018
Line 68:		Line 68:
	[[Category:ConversionRuler Cart Installation]]		[[Category:ConversionRuler Cart Installation]]
	[[Category:ConversionRuler Tracking]]		[[Category:ConversionRuler Tracking]]
		+	[[Category:Needs Review]]

← Older revision		Revision as of 17:12, 23 July 2012
Line 64:		Line 64:
	* [[Configure your PayPal IPN script to notify ConversionRuler]]		* [[Configure your PayPal IPN script to notify ConversionRuler]]
	* [[Configure PayPal to use ConversionRuler's IPN Gateway]]		* [[Configure PayPal to use ConversionRuler's IPN Gateway]]
		+
		+	[[Category:ConversionRuler]]
		+	[[Category:ConversionRuler Cart Installation]]
		+	[[Category:ConversionRuler Tracking]]

@@ Line 39: / Line 39: @@
 Once the visitor goes to PayPal, the only method of communication is via [https://www.paypal.com/ipn PayPal IPN]. You can use ConversionRuler's fault-tolerant servers for this notification, but most likely, your server will have its own IPN software which you'll need to hook into.
-If you want to use ConversionRuler's IPN gateway, the URL is as follows:
+If you want to use [[Configure PayPal to use ConversionRuler's IPN Gateway|ConversionRuler's IPN gateway]], the URL is as follows:
   https://www.conversionruler.com/bin/paypal/
-Alternatively, you can parse the custom variable yourself in your own IPN gateway and pass it to conversionruler. It can be passed directly to ConversionRuler's tracking script:
+Alternatively, you can parse the custom variable yourself in your own IPN gateway and pass it to ConversionRuler. It can be passed directly to ConversionRuler's tracking script:
   <nowiki><?php
@@ Line 57: / Line 57: @@
 The above code notifies our server, passes the total amount and the transaction ID, and records the action as originally specified. Note that your PHP configuration on your server must support ''[http://us3.php.net/manual/en/filesystem.configuration.php#ini.allow-url-fopen allow_url_fopen]'' which is generally available on most PHP servers.
-If your IPN gateway is written in another language such as [[ASP]], [[Perl]], or [[Java]] then you can use a similar method to pass the parameters onto our servers.
+If your IPN gateway is written in another language such as [[ASP]], [[Perl]], or [[Java]] then you can use a similar method to pass the parameters to our servers.
 For more information about PayPal and integration with [https://www.paypal.com/ipn PayPal IPN], contact [[MarketRuler Support]].
 == See also ==
+* [[Configure your PayPal IPN script to notify ConversionRuler]]
 * [[Configure PayPal to use ConversionRuler's IPN Gateway]]

← Older revision		Revision as of 19:19, 20 July 2012
Line 63:		Line 63:
	== See also ==		== See also ==

−	* [[~~Configuring~~ PayPal up to use ConversionRuler's IPN Gateway]]	+	* [[Configure PayPal to use ConversionRuler's IPN Gateway]]

@@ Line 29: / Line 29: @@
 The variables being passed to us are:
-- '''crcookie''' - This is set in our tracking snippet in the global scope. Please be sure to include our tracking snippet '''before this code on the page''' (meaning before the form). If this code runs inside of a closure, use '''window.crcookie''' instead.
+* '''crcookie''' - This is set in our tracking snippet in the global scope. Please be sure to include our tracking snippet '''before this code on the page''' (meaning before the form). If this code runs inside of a closure, use '''window.crcookie''' instead.
-- '''siteid''' - This is set in our tracking snippet as well, in the global scope.
+* '''siteid''' - This is set in our tracking snippet as well, in the global scope.
-- '''craction''' - The action number to record. This is configured in '''[[Manage Actions]]''' and corresponds to a commerce transaction.
+* '''craction''' - The action number to record. This is configured in '''[[Manage Actions]]''' and corresponds to a commerce transaction.
 = Connecting from PayPal IPN =

@@ Line 52: / Line 52: @@
      $custom .= "&cramount0=" . urlencode($_REQUEST['mc_gross']);
      $custom .= "&crtext0=" . urlencode($_REQUEST['txn_id']);
-     file_get_contents("https://www.conversionruler.com/bin/tracker.php?" + $custom);
+     file_get_contents("https://www.conversionruler.com/bin/tracker.php?" . $custom);
 }</nowiki>

@@ Line 6: / Line 6: @@
 That said, [[ConversionRuler]] has a solution which works with [[PayPal]].
 = Setting up your PayPal form =
@@ Line 58: / Line 60: @@
 For more information about PayPal and integration with [https://www.paypal.com/ipn PayPal IPN], contact [[MarketRuler Support]].

← Older revision		Revision as of 21:16, 29 June 2012
Line 26:		Line 26:

	This passes the ConversionRuler cookie, site, and action code to PayPal for final processing when the transaction is complete.		This passes the ConversionRuler cookie, site, and action code to PayPal for final processing when the transaction is complete.
		+
		+	The variables being passed to us are:
		+
		+	- '''crcookie''' - This is set in our tracking snippet in the global scope. Please be sure to include our tracking snippet '''before this code on the page''' (meaning before the form). If this code runs inside of a closure, use '''window.crcookie''' instead.
		+	- '''siteid''' - This is set in our tracking snippet as well, in the global scope.
		+	- '''craction''' - The action number to record. This is configured in '''[[Manage Actions]]''' and corresponds to a commerce transaction.

	= Connecting from PayPal IPN =		= Connecting from PayPal IPN =