Root: added email attribute

2009-07-30T16:43:21Z

added email attribute

Root: created...

2009-07-28T17:01:18Z

created...

New page

== Description ==
Returns a single pixel img tag that sends data to Trigger Email Marketing via their API specification. The tag will automatically pull and use the clientid and client key as specified in [[Settings]] under the eCommerce tab. The tag will also automatically pull the email address using the [[Functions:orderGetEmail|orderGetEmail]] function for the passed order data array.

== Syntax ==
$tag = eV::TEMChannelTag($channel_id[,$dataArr][,$environment=test])

== Paramaters ==
*$channel_id CHAR REQUIRED
:: specifies the channel id, as assigned by Trigger Email Marketing.
*$dataArr ARRAY OPTIONAL
:: keyed array of customer facts, conversion facts, abandoned cart or cart item data. See the TEM API data specification for available fields.
*$environment CHAR OPTIONAL
:: dropbox location as assigned by Trigger Email Marketing. Defaults to 'test'.

== Return Values ==
Returns a string containing the complete image tag - ready to be echo'd to the screen. Example value:
<pre>
<img src=”https://secure.triggeremails.com/public/api/test/tem_eboapi.php?c=123456&ck=567890&e=test@test.com&ch=1234” height=”0” width=”0” border=”0”>
</pre>

== Examples ==
;Newsletter Registration Example
<source lang="php">

// set the channel id
// this is provided by TEM
$channel_id = "12345";

// we also want to pass the first name
// this is an optional customer fact
$orderArr = eV::orderGetCompleteArray();
$firstName = eV::orderGetFirstName($orderArr);
$dataArr = array('f_first_name' => $firstName);

// place this within the body tag of the 'thank you' page following email registration.
echo eV::TEMChannelTag($channel_id,$dataArr);

</source>
;Conversion tag following completed order
<source lang="php">

// set the channel id
// this is provided by TEM
$channel_id = "23456";

// we will need the order array to get necessary data to generate tag
$orderArr = eV::orderGetCompleteArray();
// convert order data into data array that function is expecting
$dataArr = eV::TEMDataArr_conversion($orderArr);

// get tag
$tag = eV::TEMChannelTag($channel_id,$dataArr);
// output tag
echo $tag;

</source>

== See Also ==
:*[[Functions:TEMDataArr_conversion|TEMDataArr_conversion]]
:*[[Functions:orderGetCompleteArray|orderGetCompleteArray]]
:*[[Functions:orderGetFirstName|orderGetFirstName]]

@@ Line 3: / Line 3: @@
 == Syntax ==
-$tag = eV::TEMChannelTag($channel_id[,$dataArr][,$environment=test])
+$tag = eV::TEMChannelTag($channel_id,$email,[,$dataArr][,$environment=test])
 == Paramaters ==
 *$channel_id CHAR REQUIRED
 :: specifies the channel id, as assigned by Trigger Email Marketing.
 *$dataArr ARRAY OPTIONAL
 :: keyed array of customer facts, conversion facts, abandoned cart or cart item data. See the TEM API data specification for available fields.
@@ Line 26: / Line 28: @@
 // this is provided by TEM
 $channel_id = "12345";
 // we also want to pass the first name
 // this is an optional customer fact
 $firstName = eV::orderGetFirstName($orderArr);
 $dataArr = array('f_first_name' => $firstName);
 // place this within the body tag of the 'thank you' page following email registration.
-echo eV::TEMChannelTag($channel_id,$dataArr);
+echo eV::TEMChannelTag($channel_id,$email,$dataArr);
 </source>
@@ Line 46: / Line 53: @@
 // we will need the order array to get necessary data to generate tag
 $orderArr = eV::orderGetCompleteArray();
 // convert order data into data array that function is expecting
 $dataArr = eV::TEMDataArr_conversion($orderArr);
 // get tag
-$tag = eV::TEMChannelTag($channel_id,$dataArr);
+$tag = eV::TEMChannelTag($channel_id,$email,$dataArr);
 // output tag
 echo $tag;
@@ Line 60: / Line 71: @@
 :*[[Functions:orderGetCompleteArray|orderGetCompleteArray]]
 :*[[Functions:orderGetFirstName|orderGetFirstName]]

Functions:TEMChannelTag - Revision history

Root: added email attribute

Root: created...