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

For integration support, contact info@amanz.nz. Do not redistribute without AMA approval.

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 nameFuture Makers Career Guide Platform
OwnerAdvancing Manufacturing Aotearoa (AMA)
Application typeSingle-page web application with client-side navigation
AuthenticationPublic - no login required for student-facing content

2 · Production URL

Production URLhttps://futuremakers.amanz.nz/
Canonical URLhttps://futuremakers.amanz.nz/
Page titleMake Your Mark in Manufacturing | Future Makers
The production URL above is the authoritative reference for all integration work. Please use this URL verbatim in the embed snippet.

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.

  1. Full viewport height (recommended): height: 100vh - the platform scrolls internally.
  2. Fixed minimum height: A static min-height (e.g. 900px) is a simpler fallback but may clip content on shorter viewports.
  3. 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

NavigationAll page transitions occur inside the iframe - the parent page does not need to handle routing
ScrollManaged internally by the platform
Responsive designFully responsive - optimised for mobile, tablet, and desktop
FontsLoaded inside the iframe - no font conflicts with the parent page
Navigation barThe platform has its own fixed top navigation
AI Chat WidgetFloating 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.

⚠ Note: Action required (AMA): Confirm that the platform's hosting configuration permits iframe embedding from 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
sandboxDo 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
⚠ Note: Safari Private Browsing: Safari's Intelligent Tracking Prevention may restrict certain platform features when accessed via an iframe in Private Browsing mode. All public student-facing content remains fully accessible.

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 GA4Acquisition — 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 reportingEngagement — 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.

⚠ Note: Do not assume the embedded app can read the parent-page URL. UTM parameters on the AMA /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.

Direct visits to 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 /careerguide page (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 /careerguide traffic 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: 100vh recommended (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 enquiriesinfo@amanz.nz
Integration supportinfo@amanz.nz
Platform ownerAdvancing Manufacturing Aotearoa (AMA)
Prepared byMy Engine Lab on behalf of AMA
Future Makers Career Guide Platform · Integration Guide · 2 July 2026Contact: info@amanz.nz