Custom Event Log Headers

Recording custom data in ad-serving reports can provide you with valuable insights into your ad campaigns beyond the standard metrics. You can track specific actions or events such as purchases, sign-ups, or clicks on a particular product. This allows you to better analyze your ad performance in relation to your business goals and make data-driven decisions to optimize your campaigns.

Custom data can also be used to segment audiences and create more targeted campaigns, leading to higher engagement and conversions. Overall, recording custom data in ad-serving reports can provide a deeper understanding of ad performance and help maximize your ROI.

This feature is available only on Enterprise plans with the Event Logs Add-On.
Custom Event Log Heads must be created by your AdButler account manager. Please contact your account manager for assistance.

To capture custom event log data, you must pass in the key-value pair information into the ad request.

Examples:

For these examples, our custom event log header is fish. We want to record the type of fish that was triggered during an ad impression, with the value of fish being "salmon".

Passing a custom event in a JSON Ad API request

Add _eld[Header]=Value to request

https://servedbyadbutler.com/adserve/;ID=184386;size=300x250;setID=580612;type=json;_eld[fish]=salmon

Passing a custom event in an Async JavaScript zone tag

Add eventLogData: { "Header":"Value",}to opt

<!-- Default Zone [async] -->
<script type="text/javascript">if (!window.AdButler){(function(){var s = document.createElement("script"); s.async = true; s.type = "text/javascript";s.src = 'https://servedbyadbutler.com/app.js';var n = document.getElementsByTagName("script")[0]; n.parentNode.insertBefore(s, n);}());}</script>
<script type="text/javascript">
var AdButler = AdButler || {}; AdButler.ads = AdButler.ads || [];
var abkw = window.abkw || '';
var plc580612 = window.plc580612 || 0;
document.write('<'+'div id="placement_580612_'+plc580612+'"></'+'div>');
AdButler.ads.push({handler: function(opt){ AdButler.register(184386, 580612, [300,250], 'placement_580612_'+opt.place, opt); }, opt: { place: plc580612++, eventLogData: { "fish":"salmon",} , keywords: abkw, domain: 'servedbyadbutler.com', click:'CLICK_MACRO_PLACEHOLDER' }});
</script>

Passing a custom event in an Email zone tag

Add &_eld[Header]=Value after EUID

<!-- 300x250 [email] -->
<a href="https://servedbyadbutler.com/go2/;ID=184386;size=300x250;setID=580613;uid=[Email Unique ID MACROS];click=CLICK_MACRO_PLACEHOLDER&_eld[fish]=salmon" target="_blank"><img src="https://servedbyadbutler.com/e061c2b60/img-api/O0lEPTE4NDI4OTtzaXplPTcyOHg5MDtzZXRJRD03MDI3NTM7dHlwZT1pbWc%3D/?uid=[Email Unique ID MACROS]&_eld[fish]=salmon" width="300" height="250"></a>

Can't find what you're looking for?

Send us an email

hello@adbutler.com

Visit the blog

For more ad serving tips, industry news and AdButler insights.