Skip to content

πŸ“¨ The ultimate agentic social media scheduling tool πŸ€–

feat: facebook

Nevo David7113c6cebbed
diff --git a/apps/backend/src/api/routes/public.controller.ts b/apps/backend/src/api/routes/public.controller.ts
index 235f82a77..c009440e7 100644
--- a/apps/backend/src/api/routes/public.controller.ts
+++ b/apps/backend/src/api/routes/public.controller.ts
@@ -98,15 +98,19 @@ export class PublicController {
body: { fbclid?: string; tt: TrackEnum; additional: Record<string, any> }
) {
const uniqueId = req?.cookies?.track || makeId(10);
- const fbclid = req?.cookies?.fbclid || body.fbclid;
- await this._trackService.track(
- uniqueId,
- ip,
- userAgent,
- body.tt,
- body.additional,
- fbclid
- );
+ const fbc = req?.cookies?._fbc || req?.cookies?.fbclid || body.fbclid;
+ this._trackService
+ .track(
+ uniqueId,
+ ip,
+ userAgent,
+ body.tt,
+ body.additional,
+ fbc,
+ undefined,
+ req?.cookies?._fbp
+ )
+ .catch((err) => {});
if (!req.cookies.track) {
res.cookie('track', uniqueId, {
domain: getCookieUrlFromDomain(process.env.FRONTEND_URL!),
diff --git a/apps/backend/src/api/routes/users.controller.ts b/apps/backend/src/api/routes/users.controller.ts
index eb0af7e1d..1f0a6e39e 100644
--- a/apps/backend/src/api/routes/users.controller.ts
+++ b/apps/backend/src/api/routes/users.controller.ts
@@ -413,16 +413,19 @@ export class UsersController {
body: { tt: TrackEnum; fbclid: string; additional: Record<string, any> }
) {
const uniqueId = req?.cookies?.track || makeId(10);
- const fbclid = req?.cookies?.fbclid || body.fbclid;
- await this._trackService.track(
- uniqueId,
- ip,
- userAgent,
- body.tt,
- body.additional,
- fbclid,
- user
- );
+ const fbc = req?.cookies?._fbc || req?.cookies?.fbclid || body.fbclid;
+ this._trackService
+ .track(
+ uniqueId,
+ ip,
+ userAgent,
+ body.tt,
+ body.additional,
+ fbc,
+ user,
+ req?.cookies?._fbp
+ )
+ .catch((err) => {});
if (!req.cookies.track) {
res.cookie('track', uniqueId, {
domain: getCookieUrlFromDomain(process.env.FRONTEND_URL!),
diff --git a/apps/frontend/src/components/billing/first.billing.component.tsx b/apps/frontend/src/components/billing/first.billing.component.tsx
index 7cb67048c..116ba58f7 100644
--- a/apps/frontend/src/components/billing/first.billing.component.tsx
+++ b/apps/frontend/src/components/billing/first.billing.component.tsx
@@ -60,6 +60,8 @@ export const FirstBillingComponent = () => {
const t = useT();
const [datafast_visitor_id] = useCookie('datafast_visitor_id', '');
const [datafast_session_id] = useCookie('datafast_session_id', '');
+ const [fbc] = useCookie('_fbc', '');
+ const [fbp] = useCookie('_fbp', '');
useEffect(() => {
const stripePromise = loadStripe(stripeClient);
@@ -78,6 +80,8 @@ export const FirstBillingComponent = () => {
? { datafast_visitor_id, datafast_session_id }
: {}),
...(dub ? { dub } : {}),
+ ...(fbc ? { fbc } : {}),
+ ...(fbp ? { fbp } : {}),
}),
})
).json();
diff --git a/apps/frontend/src/components/billing/main.billing.component.tsx b/apps/frontend/src/components/billing/main.billing.component.tsx
index 13ccb2fe3..133a9a37c 100644
--- a/apps/frontend/src/components/billing/main.billing.component.tsx
+++ b/apps/frontend/src/components/billing/main.billing.component.tsx
@@ -31,6 +31,7 @@ import { newDayjs } from '@gitroom/frontend/components/layout/set.timezone';
import { timer } from '@gitroom/helpers/utils/timer';
import { useDubClickId } from '@gitroom/frontend/components/layout/dubAnalytics';
import { LogoutComponent } from '@gitroom/frontend/components/layout/logout.component';
+import useCookie from 'react-use-cookie';
type SubscriptionWithPlatform = Subscription & {
platform?: 'web' | 'mobile';
@@ -466,6 +467,8 @@ export const MainBillingComponent: FC<{
const toast = useToaster();
const user = useUser();
const dub = useDubClickId();
+ const [fbc] = useCookie('_fbc', '');
+ const [fbp] = useCookie('_fbp', '');
const modal = useModals();
const router = useRouter();
const utm = useUtmUrl();
@@ -687,6 +690,8 @@ export const MainBillingComponent: FC<{
utm,
billing,
...(dub ? { dub } : {}),
+ ...(fbc ? { fbc } : {}),
+ ...(fbp ? { fbp } : {}),
}),
})
).json();
@@ -708,6 +713,7 @@ export const MainBillingComponent: FC<{
pricing[billing][
monthlyOrYearly === 'on' ? 'year_price' : 'month_price'
],
+ currency: 'USD',
});
window.location.href = url;
return;
diff --git a/libraries/helpers/src/utils/utm.saver.tsx b/libraries/helpers/src/utils/utm.saver.tsx
index d05fa066b..5b7de9d39 100644
--- a/libraries/helpers/src/utils/utm.saver.tsx
+++ b/libraries/helpers/src/utils/utm.saver.tsx
@@ -3,21 +3,19 @@
import { FC, useCallback, useEffect } from 'react';
import { useSearchParams } from 'next/navigation';
import { useLocalStorage } from '@mantine/hooks';
-import { TrackEnum } from '@gitroom/nestjs-libraries/user/track.enum';
import { useFireEvents } from '@gitroom/helpers/utils/use.fire.events';
-import { useTrack } from '@gitroom/react/helpers/use.track';
const UtmSaver: FC = () => {
const query = useSearchParams();
const [value, setValue] = useLocalStorage({ key: 'utm', defaultValue: '' });
const searchParams = useSearchParams();
const fireEvents = useFireEvents();
- const track = useTrack();
+ // the Facebook pixel StartTrial is sent by the backend once Stripe confirms
+ // the trial, firing it here as well would count it twice
useEffect(() => {
if (searchParams.get('check')) {
fireEvents('purchase');
- track(TrackEnum.StartTrial);
}
}, []);
diff --git a/libraries/nestjs-libraries/src/dtos/billing/billing.subscribe.dto.ts b/libraries/nestjs-libraries/src/dtos/billing/billing.subscribe.dto.ts
index f1247f067..55cf35363 100644
--- a/libraries/nestjs-libraries/src/dtos/billing/billing.subscribe.dto.ts
+++ b/libraries/nestjs-libraries/src/dtos/billing/billing.subscribe.dto.ts
@@ -1,4 +1,5 @@
import { IsIn } from 'class-validator';
+import { Transform } from 'class-transformer';
export class BillingSubscribeDto {
@IsIn(['MONTHLY', 'YEARLY'])
@@ -13,4 +14,17 @@ export class BillingSubscribeDto {
datafast_session_id: string;
datafast_visitor_id: string;
+
+ // Facebook pixel cookies (_fbc / _fbp), saved on the subscription for the
+ // trial and conversion events. A value that doesn't fit Stripe metadata
+ // (500 chars) is dropped instead of failing the checkout.
+ @Transform(({ value }) =>
+ typeof value === 'string' && value.length <= 500 ? value : undefined
+ )
+ fbc: string;
+
+ @Transform(({ value }) =>
+ typeof value === 'string' && value.length <= 500 ? value : undefined
+ )
+ fbp: string;
}
diff --git a/libraries/nestjs-libraries/src/services/stripe.service.ts b/libraries/nestjs-libraries/src/services/stripe.service.ts
index ca23a23fb..96ff13bba 100644
--- a/libraries/nestjs-libraries/src/services/stripe.service.ts
+++ b/libraries/nestjs-libraries/src/services/stripe.service.ts
@@ -182,7 +182,7 @@ export class StripeService extends PaymentProviderAbstract {
return { ok: false };
}
- return this._subscriptionService.createOrUpdateSubscription(
+ const result = await this._subscriptionService.createOrUpdateSubscription(
STRIPE_PROVIDER,
event.data.object.status !== 'active',
uniqueId,
@@ -192,6 +192,22 @@ export class StripeService extends PaymentProviderAbstract {
period,
event.data.object.cancel_at
);
+
+ if (event.data.object.status === 'trialing') {
+ this.trackSubscription(
+ event.data.object.metadata,
+ event.data.object.id,
+ TrackEnum.StartTrial,
+ {
+ value:
+ pricing[billing][
+ period === 'YEARLY' ? 'year_price' : 'month_price'
+ ],
+ }
+ ).catch((err) => {});
+ }
+
+ return result;
}
async updateSubscription(event: Stripe.CustomerSubscriptionUpdatedEvent) {
const { uniqueId, billing, period } = event.data.object.metadata as {
@@ -1084,25 +1100,107 @@ export class StripeService extends PaymentProviderAbstract {
}
async paymentSucceeded(event: Stripe.InvoicePaymentSucceededEvent) {
- // get subscription from payment
- const subscriptionId =
- event.data.object.parent?.subscription_details?.subscription;
- if (!subscriptionId) {
- return { ok: true };
- }
- const subscription = await stripe.subscriptions.retrieve(
- typeof subscriptionId === 'string' ? subscriptionId : subscriptionId.id
- );
+ // only feeds the Facebook pixel, it runs in the background so it can
+ // never fail or slow down the webhook
+ this.trackConversion(event.data.object).catch((err) => {});
+ return { ok: true };
+ }
- const { userId, ud } = subscription.metadata;
- const user = await this._userService.getUserById(userId);
- if (user && user.ip && user.agent) {
- this._trackService.track(ud, user.ip, user.agent, TrackEnum.Purchase, {
- value: event.data.object.amount_paid / 100,
+ // The first charge of a subscription is the conversion: a trial that turned
+ // into a paid plan, or a plan paid upfront. The $0 invoice that starts a
+ // trial and the renewals are not tracked.
+ private async trackConversion(invoice: Stripe.Invoice) {
+ try {
+ // webhook payloads follow the API version of the endpoint: parent is the
+ // 2025-03-31+ shape, subscription the older one
+ const subscriptionId =
+ invoice.parent?.subscription_details?.subscription ||
+ (invoice as any).subscription;
+ if (!subscriptionId || invoice.amount_paid <= 0) {
+ return;
+ }
+
+ // invoices of other services sharing the Stripe account stop here
+ const subscription = await stripe.subscriptions.retrieve(
+ typeof subscriptionId === 'string' ? subscriptionId : subscriptionId.id
+ );
+ if (
+ subscription.metadata?.service !== 'gitroom' ||
+ !subscription.metadata?.userId
+ ) {
+ return;
+ }
+
+ const paidInvoices = await stripe.invoices.list({
+ subscription: subscription.id,
+ status: 'paid',
+ limit: 100,
});
+ const paidBefore = paidInvoices.data.some(
+ (f) =>
+ f.id !== invoice.id &&
+ f.amount_paid > 0 &&
+ (f.created < invoice.created ||
+ (f.created === invoice.created && f.id < invoice.id))
+ );
+ if (paidBefore) {
+ return;
+ }
+
+ await this.trackSubscription(
+ subscription.metadata,
+ invoice.id,
+ TrackEnum.Purchase,
+ {
+ value: invoice.amount_paid / 100,
+ currency: invoice.currency,
+ }
+ );
+ } catch (err) {
+ console.error(
+ 'stripe_pixel_conversion_failed',
+ { stripe_invoice_id: invoice.id },
+ err
+ );
}
+ }
- return { ok: true };
+ // Facebook pixel event for the user who checked out the subscription.
+ // Never throws, tracking must not affect billing.
+ private async trackSubscription(
+ metadata: Stripe.Metadata,
+ eventId: string,
+ tt: TrackEnum,
+ additional: Record<string, any>
+ ) {
+ try {
+ const { userId, fbc, fbp } = metadata || {};
+ if (!userId) {
+ return;
+ }
+
+ const user = await this._userService.getUserById(userId);
+ if (!user) {
+ return;
+ }
+
+ await this._trackService.track(
+ eventId,
+ user.ip,
+ user.agent,
+ tt,
+ additional,
+ fbc,
+ user,
+ fbp
+ );
+ } catch (err) {
+ console.error(
+ 'stripe_pixel_event_failed',
+ { stripe_object_id: eventId, event: TrackEnum[tt] },
+ err
+ );
+ }
}
async getCharges(organizationId: string) {
diff --git a/libraries/nestjs-libraries/src/track/track.service.ts b/libraries/nestjs-libraries/src/track/track.service.ts
index d74c21388..8fdb92599 100644
--- a/libraries/nestjs-libraries/src/track/track.service.ts
+++ b/libraries/nestjs-libraries/src/track/track.service.ts
@@ -1,85 +1,102 @@
import { TrackEnum } from '@gitroom/nestjs-libraries/user/track.enum';
import { User } from '@prisma/client';
import { Injectable } from '@nestjs/common';
-import {
- ServerEvent,
- EventRequest,
- UserData,
- CustomData,
- FacebookAdsApi,
-} from 'facebook-nodejs-business-sdk';
import { createHash } from 'crypto';
+import { META_GRAPH_API_VERSION } from '@gitroom/nestjs-libraries/integrations/social/facebook.provider';
-const access_token = process.env.FACEBOOK_PIXEL_ACCESS_TOKEN!;
-const pixel_id = process.env.NEXT_PUBLIC_FACEBOOK_PIXEL!;
-
-if (access_token && pixel_id) {
- FacebookAdsApi.init(access_token || '');
-}
-
+// The Conversions API is called directly instead of through
+// facebook-nodejs-business-sdk: the SDK registers a process wide
+// uncaughtException handler on first use that re-throws every error of the
+// app (killing the process before Sentry reports it), and its requests have
+// no timeout.
@Injectable()
export class TrackService {
private hashValue(value: string) {
- return createHash('sha256').update(value).digest('hex');
+ return createHash('sha256')
+ .update(value.trim().toLowerCase())
+ .digest('hex');
+ }
+
+ // A _fbc cookie is sent as is, a bare fbclid has to be wrapped as
+ // fb.<subdomainIndex>.<creationTime ms>.<fbclid> (index 1 when built on a server)
+ private toFbc(fbc: string) {
+ return fbc.startsWith('fb.') ? fbc : `fb.1.${Date.now()}.${fbc}`;
}
- track(
+
+ // Never throws and never rejects: a pixel failure (bad token, Meta outage,
+ // timeout) must not break the request or the webhook that fired it, so
+ // callers fire it in the background.
+ async track(
uniqueId: string,
ip: string,
agent: string,
tt: TrackEnum,
additional: Record<string, any>,
- fbclid?: string,
- user?: User
+ fbc?: string,
+ user?: User,
+ fbp?: string
) {
- if (!access_token || !pixel_id) {
+ const accessToken = process.env.FACEBOOK_PIXEL_ACCESS_TOKEN;
+ const pixelId = process.env.NEXT_PUBLIC_FACEBOOK_PIXEL;
+ const userAgent = agent || user?.agent;
+ // website events are rejected without a user agent
+ if (!accessToken || !pixelId || !userAgent) {
return;
}
- // @ts-ignore
- const current_timestamp = Math.floor(new Date() / 1000);
- const userData = new UserData();
- if (ip || user?.ip) {
- userData.setClientIpAddress(ip || user?.ip || '');
- }
+ try {
+ const clientIp = ip || user?.ip;
+ const response = await fetch(
+ `https://graph.facebook.com/${META_GRAPH_API_VERSION}/${pixelId}/events`,
+ {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify({
+ access_token: accessToken,
+ data: [
+ {
+ event_name: TrackEnum[tt],
+ event_time: Math.floor(Date.now() / 1000),
+ event_id: uniqueId || user?.id,
+ event_source_url: process.env.FRONTEND_URL,
+ action_source: 'website',
+ user_data: {
+ client_user_agent: userAgent,
+ ...(clientIp ? { client_ip_address: clientIp } : {}),
+ ...(user?.email?.includes('@')
+ ? { em: [this.hashValue(user.email)] }
+ : {}),
+ ...(fbc ? { fbc: this.toFbc(fbc) } : {}),
+ ...(fbp ? { fbp } : {}),
+ },
+ ...(additional?.value
+ ? {
+ custom_data: {
+ value: additional.value,
+ currency: (additional.currency || 'USD').toUpperCase(),
+ },
+ }
+ : {}),
+ },
+ ],
+ }),
+ signal: AbortSignal.timeout(10000),
+ }
+ );
- if (agent || user?.agent) {
- userData.setClientUserAgent(agent || user?.agent || '');
- }
- if (fbclid) {
- userData.setFbc(fbclid);
- }
+ if (!response.ok) {
+ console.error(
+ `Facebook pixel rejected ${TrackEnum[tt]}:`,
+ await response.text()
+ );
+ return;
+ }
- if (user && user.email) {
- userData.setEmail(this.hashValue(user.email));
+ await response.body?.cancel();
+ } catch (err) {
+ console.error(`Facebook pixel failed to send ${TrackEnum[tt]}:`, err);
}
-
- let customData = null;
- if (additional?.value) {
- customData = new CustomData();
- customData.setValue(additional.value).setCurrency('USD');
- }
-
- const serverEvent = new ServerEvent()
- .setEventName(TrackEnum[tt])
- .setEventTime(current_timestamp)
- .setActionSource('website');
-
- if (user && user.id) {
- serverEvent.setEventId(uniqueId || user.id);
- }
-
- if (userData) {
- serverEvent.setUserData(userData);
- }
- if (customData) {
- serverEvent.setCustomData(customData);
- }
-
- const eventsData = [serverEvent];
- const eventRequest = new EventRequest(access_token, pixel_id).setEvents(
- eventsData
- );
-
- return eventRequest.execute();
}
}