Dynamic Product Ads: Conversion Page Implementation

Instructions 

Place both the LiveConnect Tag and the Conversion page script in the header section of your post-conversion page.

Use the LiveConnect Tag provided by your account team, as it will contain a unique App_ID variable (e.g. a-0045). The LiveConnect Tag below (above the conversion script) is an example.

The below Conversion page script includes placeholders (denoted in green) that represent where your specific website dynamic values should be placed. Please use the below Conversion page script for implementation. In the case where a user has purchased multiple products, multiple item arrays can be captured. 

<script type="text/javascript" src="//b-code.liadm.com/a- xxxx.min.js" async="true"></script>

<script>
window.liQ = window.liQ || [];
window.liQ.push(
{ event: "conversion",
transactionId: "
[TRANSACTION_ID]",
name: "[NAME]",
amount: [AMOUNT],
  currency: "[CURRENCY]",
email: "[USER_EMAIL]",
items: [ 
{id: "[PRODUCT_ID]",
price: [ITEM_PRICE],
quantity: [QUANTITY],
currency: "[CURRENCY_TYPE]"}
]
});
</script>

 

Parameter: Value

Requested Value Output

Value Format

Status

Notes

event: "conversion"

"conversion"

"conversion"

Required

Pre-hardcoded, please implement exactly as shown. 

transactionId:

"[TRANSACTION_ID]"

Transaction ID

String

 Recommended

 

name: "[NAME]"

Gives the kind of conversion a name

String

Optional

 

Needs to have a consistent case (upper or lower case). 

amount: [AMOUNT]

Total transaction amount

Number with Decimals

Recommended

Enables campaign ROAS reporting

currency: "[CURRENCY]"

Currency Type

Transaction currency, 3 letter string

Recommended

 

email: "[USER_EMAIL]

Email address of logged in or known site visitor

String

Required (if not passing MD5 Hash)

 

 

emailHash: "[USER_MD5HASH]"

 

MD5 Hash

 String

 

Required (if not passing email)

Hashing Protocol: lower case email address

Example

email: nickfury@theavengers.com

MD5: f5d74b7a968427433fc5957bf3d06486

id: "[PRODUCT_ID]"

Product ID

String

Required

Product ID should match Product IDs delivered in the product feed. 

Needs to have a consistent case (upper or lower case). 

price: [ITEM_PRICE]

Product price

Number with Decimals

Optional

 

quantity: [QUANTITY]

Quantity of product

Integer

Optional

 

currency:

"[CURRENCY_TYPE]"

Currency Type

Transaction currency, 3 letter string

Optional

 e.g. "USD"

 

Example Output:

<script>

   window.liQ = window.liQ || [];

   window.liQ.push(

      { event: "conversion",

          transactionId: "foduze9rew9r0",

          name: "purchase",

          amount: 568.97,

          currency: "USD",

          email: "hulk@liveintent.com",

          items: [ 

             {id: "as126dffe54f",

             price: 165.48,

             quantity: 2,

             currency: "USD"},

             {id: "kx189koms92f",

             price: 238.01,

             quantity: 1,

             currency: "USD"}

                    ]

      });

</script>

 
 
 
 
 
Have more questions? Submit a request