Bulk UTM Campaign Builder & QR 🚀

Mass generate trackable UTM links, Short URLs, and QR codes in seconds.

This Apify Actor creates a unified, professional HTML report containing all your campaign links, organized by channel and target page. It supports batch processing (multiple pages at once) and integrates with popular URL shorteners.

✨ Key Features

• Bulk Processing: Paste a list of URLs (or Import CSV via Apify Input) and generate UTM tags for all of them in a single run.
• Link Shortening: Automatically shorten links using TinyURL (V2), Bitly, Rebrandly, or is.gd (Free/No Account).
• QR Code Generation: Integrated directly into the report table. Every link gets its own downloadable QR code.
• Smart Health Check: Verifies your Base URL is live before generating links to prevent broken campaigns.
• Custom Branding: Customize the report with your own Logo and Brand Color.
• Health Status Flags: Visual indicators (✅/❌) next to each target URL showing its validation status.
• One-Click Copy: The output HTML report has "Copy" buttons for every link (Short & Full).

🛠 Supported Channels

The Actor comes pre-loaded with defaults for popular channels, ensuring consistent tagging:

Channel Key	Default Source	Default Medium
facebook	facebook	social
instagram	instagram	bio_link
linkedin	linkedin	social
twitter	twitter	social
email	newsletter	email
google-ads	google	cpc
qr-print	print	qr_code
...and many more

You can also add Custom Channels (e.g., discord, slack) via the input configuration.

⚙️ Configuration

1. Campaign Details

• Target URLs: List of pages (URLs) you want to tag. You can add one or many.
• Campaign Name (utmCampaign): Name of the campaign (e.g., summer_sale_2024).
• Term (utmTerm): Optional keyword (e.g., running_shoes).
• Content (utmContent): Optional variant (e.g., logolink or textlink).

2. Channels

• Select the channels you want from the list.
• Add custom ones in the text field if needed.

3. URL Shortener

• Choose is.gd (Default, Free), TinyURL, Bitly, or Rebrandly.
• Stats Links: The report includes a "Stats" link to view click analytics (supported for is.gd, TinyURL, Bitly).
• Note: TinyURL (V2), Bitly, and Rebrandly require an API Key.
• is.gd is completely free and requires no account/key.

4. Branding

• Brand Color: Hex code for the report header (default: Apify Green #4CAF50).
• Brand Logo: URL to your logo image.

📋 All Input Parameters

Field	Type	Description	Default
utmCampaign	String	Required. Name of the campaign (e.g., Summer Sale).	-
utmTerm	String	Optional keyword (utm_term).	-
utmContent	String	Optional content identifier (utm_content).	-
targetUrls	Array	Required. List of Base URLs. Supports Bulk CSV Import/Paste.	[]
channels	Array	List of standard channels to include.	[facebook...]
customChannels	String	Comma-separated list of extra channels (e.g., discord).	""
checkUrlHealth	Boolean	Verify baseUrl is live before processing.	true
failOnHealthCheckError	Boolean	Exit with error if health check fails.	false
shortenerProvider	Enum	isgd (Free), tinyurl, bitly, rebrandly, or none.	isgd
shortenerApiKey	String	API Key for TinyURL, Bitly, or Rebrandly.	-
includeQrCode	Boolean	Major Feature! Generate a QR column for every link.	false
qrForeground	String	Color of the QR code dots (Hex).	#000000
qrBackground	String	Background color of the QR Code (Hex).	#ffffff
brandColor	String	Hex color for the report header.	#4CAF50
brandLogo	String	URL to a custom logo image.	Apify Symbol
customParameters	Object	JSON object of extra params (e.g. {"ref": "user1"}).	{}

💻 Input Sample

{
    "channels": [
        "linkedin",
        "pinterest",
        "instagram"
    ],
    "checkUrlHealth": true,
    "failOnHealthCheckError": false,
    "includeQrCode": true,
    "targetUrls": [
        "https://apify.com/challenge",
        "https://docs.apify.com/"
    ],
    "utmCampaign": "summer sale 2025"
}

📄 Output

The Actor saves a single, standalone HTML file to the Key-Value Store: OUTPUT.html

📊 View Example Dashboard

• Open it in your browser.
• It contains separate tables for each Target URL.
• Use the Copy buttons to grab links instantly.
• Share the HTML file with your marketing team—it's completely self-contained!

---

Created with ❤️ by Azzouzana