Integration Guide
Future Makers
Career Guide Platform
Prepared for: Flume
Prepared by: My Engine Lab on behalf of Advancing Manufacturing Aotearoa (AMA)
Document date: 2 July 2026
Contents
1 · Platform Overview
The Future Makers Career Guide Platform is an interactive web application that enables New Zealand secondary-school students and young people to explore manufacturing career pathways, employer profiles, entry routes, events, and summer employment opportunities.
| Product name | Future Makers Career Guide Platform |
| Owner | Advancing Manufacturing Aotearoa (AMA) |
| Application type | Single-page web application with client-side navigation |
| Authentication | Public - no login required for student-facing content |
2 · Production URL
| Production URL | https://futuremakers.amanz.nz/ |
| Canonical URL | https://futuremakers.amanz.nz/ |
| Page title | Make Your Mark in Manufacturing | Future Makers |
3 · Embed Snippet
Paste this snippet into the AMA website CMS at the desired location. See Section 4 for height guidance.
Copy this snippet verbatim into the AMA website CMS.
<!-- Future Makers Career Guide Platform - Embed Snippet -->
<!-- Contact: info@amanz.nz for integration support -->
<style>
#future-makers-embed {
width: 100%;
height: 100vh; /* recommended - see Section 4 -->
border: none;
display: block;
}
</style>
<iframe
id="future-makers-embed"
src="https://futuremakers.amanz.nz/"
title="Future Makers - Career Guide Platform"
allow="clipboard-write"
loading="lazy"
></iframe>4 · Integration Notes
4.1 - iframe Implementation
The platform uses a standard <iframe> embed. No additional libraries are required on the parent page.
The iframe-resizer library is not currently implemented in the platform. At this stage, we recommend testing the standard embed before introducing any additional iframe libraries. If automatic height adjustment is needed after testing, this can be scoped as a follow-on development item.
4.2 - Height Strategy
Because the platform manages its own internal scroll, the recommended approach is to set height: 100vh on the iframe so it fills the full browser viewport height. This gives the cleanest user experience across devices.
- Full viewport height (recommended):
height: 100vh- the platform scrolls internally. - Fixed minimum height: A static
min-height(e.g. 900px) is a simpler fallback but may clip content on shorter viewports. - Direct link: Linking to
https://futuremakers.amanz.nz/in a new tab avoids all iframe constraints entirely and is a valid option.
4.3 - What the platform provides
| Navigation | All page transitions occur inside the iframe - the parent page does not need to handle routing |
| Scroll | Managed internally by the platform |
| Responsive design | Fully responsive - optimised for mobile, tablet, and desktop |
| Fonts | Loaded inside the iframe - no font conflicts with the parent page |
| Navigation bar | The platform has its own fixed top navigation |
| AI Chat Widget | Floating chat widget rendered inside the iframe - no parent-page interaction required |
5 · Security Requirements
5.1 - iframe Embedding Permission
Before embedding, AMA must confirm with the platform hosting provider that futuremakers.amanz.nz is permitted to be framed from www.amanz.nz. This is a hosting-level configuration. Flume does not need to take any action - this is an item for AMA to resolve prior to go-live.
www.amanz.nz before the embed is published.5.2 - iframe Attributes
allow="clipboard-write" | Required - enables the PDF download / clipboard copy feature within the platform |
loading="lazy" | Recommended - prevents the iframe from blocking the parent page's initial load |
sandbox | Do not add - would break authentication token storage, navigation, and form submissions |
6 · Browser Compatibility
The platform targets all modern evergreen browsers. Internet Explorer is not supported.
| Chrome / Edge | ✅ Full support (v90+) |
| Firefox | ✅ Full support (v88+) |
| Safari (desktop) | ✅ Full support (v14+) |
| iOS Safari | ✅ Supported - test sticky header and height behaviour in iframe context |
| Android Chrome | ✅ Supported |
| Internet Explorer | ❌ Not supported |
7 · Analytics & Campaign Attribution
7.1 - Two separate reporting layers
Acquisition and engagement are measured by two independent systems. They do not share data automatically and must not be read as a single source.
| AMA GA4 | Acquisition — measures traffic arriving at the AMA website /careerguide page (the parent page). Owned and configured by AMA in its own GA4 property. The Career Guide application does not install, configure or read GA4. |
| Career Guide in-app reporting | Engagement — measures what visitors do inside the Career Guide (clusters explored, stories read, guides downloaded, etc.). Stored in the platform's first-party AnalyticsEvent store and shown on the internal Impact Dashboard. Independent of GA4. |
7.2 - iframe isolation (important)
iframes are isolated browsing contexts. AMA GA4 records the /careerguide pageview when the parent page loads, but it does not automatically capture interactions that happen inside the iframe. Conversely, the Career Guide's in-app tracker reads only the iframe's own URL — it cannot read the parent AMA page URL (cross-origin restriction). The two systems therefore measure different things by design.
/careerguide URL are not visible to the in-app tracker unless the parent page forwards them into the iframe (see 7.3).7.3 - Forwarding campaign UTMs into the Career Guide (required for embedded attribution)
When a visitor lands on the AMA /careerguide page with UTM parameters (for example /careerguide?utm_source=facebook&utm_medium=social&utm_campaign=summer_2026), those parameters live on the parent URL. For the in-app tracker to attribute in-guide activity to that campaign, the parent page must pass the query string into the iframe src. Add this script immediately after the embed snippet:
<script>
// Forward UTM / campaign params from the AMA page URL into the Career Guide iframe
(function () {
var qs = new URLSearchParams(window.location.search).toString();
var iframe = document.getElementById('future-makers-embed');
if (!iframe) return;
iframe.src = qs ? 'https://futuremakers.amanz.nz/?' + qs
: 'https://futuremakers.amanz.nz/';
})();
</script>Once forwarded, the Career Guide captures the UTM parameters on entry, stores the first-touch campaign in the browser (persistent) and the current-session campaign (session), and attaches them to every in-app event recorded during that visit — so a later action such as downloading the guide still carries the campaign that brought the visitor in.
futuremakers.amanz.nz/?utm_source=... are attributed automatically — no forwarding script is needed. Forwarding is only required for the embedded (iframe) path on the AMA website.7.4 - Confirming AMA GA4 is recording /careerguide
Whether AMA GA4 is recording users and sessions arriving at /careerguide can only be confirmed from within AMA's own GA4 property. The Base44 environment does not have access to AMA's GA4 property and cannot independently verify it.
To verify, AMA needs to confirm one of the following:
- The GA4 tag / Measurement ID is present on the
/careerguidepage (check with Google Tag Assistant or GA4 DebugView), and - GA4 is recording page_view events for
/careerguide, and users/sessions are appearing in the GA4 Realtime and standard reports. - Alternatively, share read access to the AMA GA4 property so the recording of
/careerguidetraffic can be independently confirmed.
8 · Dependencies
No additional third-party libraries are required by the integrating website beyond a standard iframe implementation. All platform functionality is self-contained within the embedded application.
9 · QA Checklist
Complete before go-live on the AMA website.
- ○Platform loads correctly in the iframe on Chrome (desktop)
- ○Platform loads correctly in the iframe on Safari (desktop)
- ○Platform loads correctly on iOS Safari
- ○Platform loads correctly on Android Chrome
- ○Internal navigation works (e.g. selecting a career cluster opens the detail view)
- ○Platform is fully responsive at 375px, 768px, and 1280px widths
- ○Career guide PDF download functions correctly
- ○AI Chat widget opens and responds
- ○Stories in Motion videos play correctly
- ○Summer Jobs board loads
- ○Employer directory loads and company logos display
- !AMA to confirm: iframe embedding is permitted from www.amanz.nz (Section 5.1)
- !Test Safari Private Browsing - confirm public content is accessible
- !Verify iframe height approach is visually acceptable across mobile and desktop
- ○Confirm parent page performance is not degraded by the iframe (
loading="lazy"applied)
10 · Deployment Checklist
Steps for Flume to complete on the AMA website.
- ○Confirm production URL with AMA:
https://futuremakers.amanz.nz/ - ○Paste the embed snippet (Section 3) into the CMS page or template
- ○Set iframe height:
height: 100vhrecommended (Section 4.2) - ○Confirm
allow="clipboard-write"attribute is present - ○Confirm
loading="lazy"attribute is present - !AMA to confirm: hosting configuration permits embedding from www.amanz.nz
- ○Test across all target browsers (Section 6)
- ○Complete QA checklist (Section 9)
- ○Obtain sign-off from AMA prior to publishing
11 · Support & Contact
| General enquiries | info@amanz.nz |
| Integration support | info@amanz.nz |
| Platform owner | Advancing Manufacturing Aotearoa (AMA) |
| Prepared by | My Engine Lab on behalf of AMA |
