Project metrics API

Tracking project parameters

With key:value strings in the URL (Preferred version)

Example

https://ctxtfl.com/scripts/js/m.js?id=AbCdEfGhIj1234567890&cb=%n&adv=%eadv!&sid=%esid!&pid=%epid!

Mandatory parameters

ALWAYS include the "id" key-value pair. It is the identification of the current project or campaign within Contxtful infrastructure. This string is composed of 20 alpha-numeric values and is provided by Contxtful on demand when the project or campaign is launched.

Highly recommended parameters

We strongly recommend that you add as many key:values as possible to be able to correlate the contextual data to all your preferred KPIs.

Important note

If you choose to download the data in batch daily, remember to use a key:value to connect each impression to a relevant UUID to be able to couple context with other metrics in the DMP


All optional key-value pairs.

Order is not critical

FonctionkeyGoogle expand macro equivalentNote
Ad id
adid%eaid!The expand macro is different from the key
Advertiser idadv%eadv!
Campaign idbuy%ebuy!
Creative idcid%ecid!
External campaign idexcid%eexcid!
External placement id
expid
%eexpid!
Internal key-value pair idkid%ekid!
Placement idpid%epid!
Rendering idrv%erv!
Environmental characterenv%eenv!
Port communication protocolssl%ers!The expand macro is different from the key. Has no impact on the URL provided in impression events
Site ad placement idsid%esid!
Rendering idrid%erid!
Click idiid%eiid!
Sitesite%s
Cache bustercb%n


Other method. (Deprecated version)

 Click here to expand...

This option only works if the values are hard coded or passed as an expansion macro

<script async src="//ctxtfl.com/scripts/js/m.js?id=[Project_ID]" userID="predefinedValue" userField1="stringValue1" userField2="stringValue2"></script>

We support up to 5 userFields this way