General
Clinch macros expand to values that either originate from internal ad-serving data or are passed from the DSP or publisher.
Macros can be used in landing page URLs, UTM parameters, or external tracking event calls.
Common use cases for Clinch macros include:
- Landing Page URL Enrichment ("UTM") - Dynamically insert the Clinch creative ID into the campaign landing page URL.
- External Impression Tracking Enrichment - Dynamically insert the Clinch creative ID served into an external impression tracker (like CM360).
Internal Ad Serving Macros
These macros expand to ad-serving data originating from Flight Control, such as creative names or product IDs chosen from a product feed.
Note: This list may change. Be sure to access Flight Control for the latest macros, or contact your Clinch account representative.
General
{{size}}— Ad Size{{cache_buster}}— Cache Buster{{clinch_imp_id}}— Clinch Impression ID
Campaign, Placement, and Creative Data
{{campaign_name}}— Clinch Campaign Name{{campaign_id}}— Clinch Campaign ID{{campaign_tag_1}}— Clinch Campaign Tag 1{{campaign_tag_2}}— Clinch Campaign Tag 2{{campaign_tag_3}}— Clinch Campaign Tag 3{{placement_name}}— Placement Name{{placement_id}}— Placement ID{{placement_desc}}— Placement Description{{placement_custom1}}— Placement Custom Label 1{{placement_custom2}}— Placement Custom Label 2{{placement_custom3}}— Placement Custom Label 3{{placement_external_ad_id}}— Placement External Ad ID{{placement_external_campaign_id}}— Placement External Campaign ID{{placement_external_creative_id}}— Placement External Creative ID{{placement_external_placement_id}}— Placement External Placement ID{{creative_style_name}}— Creative Name{{creative_style_id}}— Creative ID{{creative_tag_1}}— Creative Tag 1{{creative_tag_2}}— Creative Tag 2{{creative_tag_3}}— Creative Tag 3
Content Attributes from Content Feed
{{content_id}}— Content ID{{content_tag_1}}— Content Tag 1{{content_tag_2}}— Content Tag 2{{content_tag_3}}— Content Tag 3
Location Attributes from Location Feed
{{business_id}}— Business / Location ID{{business_name}}— Business / Location Name{{business_group_id}}— Business/Location Group ID{{business_city}}— Business/Location City
Product Attributes from Product Feed
{{product_feed_name}}— Product Feed Name
User Data
{{device}}— Device Type{{user_city}}— User City (from IP data){{user_country}}— User Country (from IP data){{user_state}}— User State/Region (from IP data){{user_ip}}— IP Address{{user_agent}}— User Agent
Additional Macros for Click Trackers
{{click_type}}— Click Type{{clicked_product_id}}— Clicked Product ID (for Click trackers){{clicked_product_category}}— Clicked Product Category (for Click trackers){{clicked_product_custom1}}— Clicked Product Custom 1 (for Click trackers){{clicked_product_custom2}}— Clicked Product Custom 2 (for Click trackers){{clicked_product_custom3}}— Clicked Product Custom 3 (for Click trackers)
Additional Macros for Engage Trackers
{{engage_type}}— Engage Type (for Engage Trackers)
DSP Macros
You can use macros in the table to pass values from the DSP or publisher:
{{dsp}}— DSP Name{{dsp_impression_id}}— DSP Impression ID{{dsp_user_unique_id}}— DSP Unique User ID{{dsp_exchange_id}}— DSP Exchange ID{{dsp_account_id}}— DSP Ad Account ID{{dsp_insertion_order_id}}— DSP Insertion Order ID{{dsp_campaign_id}}— DSP Campaign ID (This corresponds to the Line Item ID in DV360.){{dsp_ad_group_id}}— DSP Ad Group ID{{dsp_creative_id}}— DSP Creative ID{{dsp_publisher_id}}— DSP Publisher ID{{dsp_placement_id}}— DSP Placement ID{{dsp_segment_id}}— DSP Segment ID{{dsp_contextual_category}}— DSP Contextual Category{{dsp_strategy_id}}— DSP Strategy ID{{dsp_device_id}}— DSP Device ID{{dsp_bundle_id}}— DSP App Bundle ID – refers to the unique identifier of a mobile app, used when buying and targeting mobile app inventory through a DSP{{dsp_app_name}}— DSP App Name – refers to the App Name that users see in the app store or on their phones{{site_url}}— Site URL where the ad is served{{site_id}}— Site ID where the ad is served{{domain}}— Site domain where the ad is served{{dsp_latitude}}— DSP Latitude{{dsp_longitude}}— DSP Longitude{{dsp_tracker_token}}— DSP Token ID (ie DC/DBM Token) – refers to a unique alphanumeric string used to authorize and map inventory, data, or reporting integrations between systems{{dsp_custom0}}— DSP Custom 0, 1, 2, 3, 4