import { createHash } from "crypto";
import app from "../../linkedin_ads.app.mjs";
export default {
key: "linkedin_ads-send-conversion-event",
name: "Send Conversion Event",
description: "Sends a conversion event to LinkedIn Ads. [See the documentation](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api?view=li-lms-2024-01&tabs=http#streaming-conversion-events)",
version: "0.0.3",
type: "action",
props: {
app,
adAccountId: {
propDefinition: [
app,
"adAccountId",
],
},
conversionId: {
propDefinition: [
app,
"conversionId",
({ adAccountId }) => ({
adAccountId,
}),
],
},
conversionHappenedAt: {
type: "string",
label: "Conversion Happened At",
description: "Epoch timestamp in milliseconds at which the conversion event happened. Note: If your source records conversion timestamp in seconds, please insert 000 at the end to transform it to milliseconds. Eg. `1590739275000`.",
},
email: {
type: "string",
label: "Email",
description: "Email address of the contact associated with the conversion event which needs to be in SHA256 format, a HEX encoded string with a maximum length of 64 characters. Eg. `test@example.com`.",
},
firstName: {
type: "string",
label: "First Name",
description: "The first name of the contact to match the conversion.",
},
lastName: {
type: "string",
label: "Last Name",
description: "The last name of the contact to match the conversion.",
},
conversionValueCurrencyCode: {
type: "string",
label: "Conversion Value Currency Code",
description: "The currency code of the conversion value in ISO format. Eg. `USD`.",
},
conversionValueAmount: {
type: "string",
label: "Conversion Value Amount",
description: "The value of the conversion in decimal string. If you set this field, you must also set in the **Conversion Value Currency Code** field. Eg. `100.05`.",
},
companyName: {
type: "string",
label: "Company Name",
description: "A plain text string representing the company of the contact to match.",
optional: true,
},
title: {
type: "string",
label: "Title",
description: "A plain text string representing the title name of the contact to match. Eg. `Software Engineer`.",
optional: true,
},
countryCode: {
type: "string",
label: "Country Code",
description: "An ISO standardized [two letter country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) representing the country of the contact to match. Eg. `US`.",
optional: true,
},
eventId: {
type: "string",
label: "Event ID",
description: "The unique id generated by advertisers to indicate each event. This field is used for [deduplication](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/deduplication?view=li-lms-2024-01).",
optional: true,
},
},
methods: {
emailToSha256(email) {
return createHash("sha256")
.update(email)
.digest("hex");
},
sendConversionEvent(args = {}) {
return this.app._makeRequest({
debug: true,
method: "POST",
path: "/conversionEvents",
...args,
});
},
},
async run({ $ }) {
const {
app,
emailToSha256,
sendConversionEvent,
conversionId,
conversionHappenedAt,
conversionValueCurrencyCode,
conversionValueAmount,
email,
firstName,
lastName,
companyName,
title,
countryCode,
eventId,
} = this;
await sendConversionEvent({
$,
data: {
conversion: app.getConversionUrn(conversionId),
conversionHappenedAt: Number(conversionHappenedAt),
conversionValue: {
currencyCode: conversionValueCurrencyCode,
amount: conversionValueAmount,
},
user: {
userIds: [
{
idType: "SHA256_EMAIL",
idValue: emailToSha256(email),
},
],
userInfo: {
firstName,
lastName,
companyName,
title,
countryCode,
},
},
eventId,
},
});
$.export("$summary", "Successfully sent conversion event to LinkedIn Ads");
return {
success: true,
};
},
};
Chase Roberts@chsrbrts@benedictevans If you haven’t used @pipedream yet, then you haven’t lived.
✨Ellie Day✨@heyelliedayEvaluation update: @pipedream has quite literally been a dream to work with! I’m excited to leverage this tool for all the various workflows I need to write. I’m currently at 11k invocations a day from the initial workflows I’ve written in the past couple weeks.
Michael Braedley@MBraedleyUpdate: I got it working properly, and it's working so well that I'm dropping IFTTT. @pipedream can do everything that IFTTT basic can, and most (if not all things) IFTTT pro can for free or at a reasonable price if you need it. I am recommending it for basically any power user.
Thomas Cutting@mrthomascuttingWant quick+dirty integrations for a serverless workflow - @pipedream is my new go-to 😃
Matthew Roberts@mattdotrobertsday 013 - finally hit node js. This is the secret sauce of taking #nocode projects that one step further. Pumped about getting deeper into @pipedream now
Kenneth Auchenberg 💭@auchenbergYahoo Pipes is back! Kinda 😍 @pipedream
Raymond Camden 🥑@raymondcamdenAwesome video by the @pipedream folks showing real time twitter sentiment analysis integrated with Google Sheets. This is where Pipedream *really* shines, connecting systems together in easy workflows.
Nacho Caballero@nachocaballeroI couldn't recommend @pipedream more. It's an amazing service to integrate different APIs. Much more powerful than Zapier and more user-friendly than AWS Lambda. I'm very proud to wear this t-shirt #NoCode
Jason Snow@jyksnwDeveloped a working prototype environmental sensor IoT solution with @particle Photon, @pipedream, and @MongoDB with full graphing and alerting in less than a day! All amazing technology, will def. be exploring these more.
Steven Terrana@steven_terrana@burgwyn you've inspired me to finally set up my own blog. I'll make sure my first blog post explains the tech behind the setup. think @obsdmd + @GatsbyJS + @pipedream.
🚄 James Augeri, PhD@DotDotJamesWant to low-code your back end, need more horsepower than @Bubble / @KnackHQ, or just miss Yahoo! Pipes? Check out @PipeDream
Sébastien Chopin@AtinuxGitHub issues should be like @linear_app for maintainers. Looking forward more integrations with GH actions or tools like @pipedream 👀
Raul@raul_predescuIf you're a dev and not using @pipedream, you're missing out. Been using it for months, daily. FREE for devs. Plenty of integrations and good limits. Absolutely love it.
Bruno Skvorc@bitfallsSo @pipedream is pretty amazing. In 3 minutes I just made a flow which adds @rickastley's Never Gonna Give You Up to my @spotify playlist whenever a new pull request arrives in an old repo of mine.
Zach Lanich@ZachLanichUm, wow 🤯 @pipedream
Steven Bell@bellontechI just used @pipedream to build a Shopify App. Wow, they make small backed tasks easy.
Jay Hack 🎩🇺🇸@_jayhack_Very impressed with this bad boi - it reminds me of a @PalantirTech internal tool, but geared towards integrations instead of data analysis and far more customizable. Great expectations here 🚀🤩
Tree Sturgeon 🔥🚴♂️🌳@philsturgeonFor context this is day 2 of a really challenging and stupid migration from Notion to @airtable with disparate/missing data. It's going better than expected and thanks to @pipedream I don't have to bother the iOS dev to add W3W.