Connecting Your Ads Account

Connect Meta Ads Manager or import daily reports to compare campaign spend and destination clicks with the traffic reaching your project.

Connect Meta Ads Manager

  1. Open Integrations → Ads Manager in your workspace dashboard at /namespaces/<workspace>/origins/facebook.
  2. Choose Link or Renew, sign in with Meta and approve access to your ad account.
  3. Use Select ad account to choose the advertiser that owns the project's campaigns. Record the ad IDs for the ads sending traffic to your watch page or to your website with the embedded player.

You can now retrieve ad-level results on the project's Usage tab. The traffic pricing table lists how AppMana treats organic and paid visits for each plan.

Measure traffic to an embedded player

When your ad sends visitors to your own site, capture the landing before your router removes campaign parameters. Load the helper on that landing page. Use the same watch URL for the iframe and the fullscreen link.

<script src="https://appmana.com/embed.js"></script>
<iframe id="game" title="Play the game" allow="autoplay; fullscreen; gamepad" allowfullscreen></iframe>
<a id="fullscreen" href="https://appmana.com/watch/YOUR-WATCH-PATH">Play fullscreen</a>
<script>
  const fullscreen = document.getElementById("fullscreen");
  const watch = window.AppManaEmbed?.watchUrl(fullscreen.href) ?? fullscreen.href;
  document.getElementById("game").src = watch;
  fullscreen.href = watch;
</script>

The helper passes a coarse network signal and a temporary visit reference. Opening the fullscreen link from the same landing page carries the same reference. The watch trace records the parent landing separately from the website hosting the iframe. Browser evidence is provisional until reconciled with the linked advertising account.

Import ad reports into Usage

Open Overview → Usage → Import or sync an ad report. To read your linked Meta account, enter the ad IDs assigned to this project and an inclusive range of up to 31 days. Use the import button for a daily JSON export from Meta, TikTok, or X. Select one row per ad and advertiser-local date and include the advertiser currency and time zone.

{
  "provider": "tiktok",
  "accountId": "123",
  "adIds": ["456"],
  "currency": "USD",
  "timeZone": "America/Los_Angeles",
  "exportedAt": "2026-10-02T12:00:00Z",
  "rows": [{
    "advertiser_id": "123",
    "dimensions": {"ad_id": "456", "stat_time_day": "2026-10-01"},
    "metrics": {"clicks": "120", "spend": "42.18"}
  }]
}

For Meta, set provider to meta and use its daily insights fields for each row.

{"ad_id":"456","account_id":"123","account_currency":"USD","date_start":"2026-10-01","date_stop":"2026-10-01","outbound_clicks":[{"action_type":"outbound_click","value":"120"}],"spend":"42.18"}

For X, set provider to x. Take URL clicks and spend in millionths of the account currency from the promoted post’s daily engagement and billing statistics. X includes earned clicks in this figure.

{"promoted_tweet_id":"456","account_id":"123","day":"2026-10-01","currency":"USD","url_clicks":"120","billed_charge_local_micro":"42180000"}

Reimport corrections with their new export timestamps. Usage labels supplied reports separately and shows the number of reported calendar dates. For an ad spanning several project destinations, establish the project allocation before importing its results.