ByteChef LogoByteChef
Components

Amplitude

Build better products by turning your user data into meaningful insights, using Amplitude's digital analytics platform and experimentation tools.

Categories: Analytics

Type: amplitude/v1


Connections

Version: 1

custom

Properties

NameLabelTypeDescriptionRequired
api_keyAPI KeySTRINGThe API key for the Amplitude projecttrue
regionRegionSTRING
Options api2, api.eu
Environment region you wish to access the API in.true

Actions

Create Attribution Event

Name: createAttributionEvent

Creates attribution event using Attribution API.

Properties

NameLabelTypeDescriptionRequired
event_typeEvent TypeSTRINGThe event info. Prefix with brackets [YOUR COMPANY].true
platformPlatformSTRING
Options ios, android
Platform which the event will occur on.true
identifierIdentifierOBJECT
Properties {STRING(key), STRING(value)}
Identifier of the platform.true
user_propertiesUser PropertiesARRAY
Items [{STRING(key), STRING(value)}($property)]
A dictionary of attribution properties prefixed with brackets [YOUR COMPANY].false

Example JSON Structure

{
  "label" : "Create Attribution Event",
  "name" : "createAttributionEvent",
  "parameters" : {
    "event_type" : "",
    "platform" : "",
    "identifier" : {
      "key" : "",
      "value" : ""
    },
    "user_properties" : [ {
      "key" : "",
      "value" : ""
    } ]
  },
  "type" : "amplitude/v1/createAttributionEvent"
}

Output

Type: STRING

Create or Update User

Name: createOrUpdateUser

Creates or updates user without sending an event.

Properties

NameLabelTypeDescriptionRequired
idIDSTRING
Options user_id, device_id
Choose to create or update a user or a device.true
device_idDevice IDSTRINGA device specific identifier, such as the Identifier for Vendor (IDFV) on iOS.true
user_idUser IDSTRINGUnique user ID specified by you. If you send a request with a user ID that's not in the Amplitude system, new user will be created (e.g. email address).true
user_propertiesUser PropertiesARRAY
Items [{STRING(key), STRING(value)}($property)]
A dictionary of attribution properties prefixed with brackets [YOUR COMPANY].false
platformPlatformSTRINGThe platform that's sending the data.false
os_nameOperating System NameSTRINGThe mobile operating system or browser the user is on.false
device_brandDevice BrandSTRINGThe device brand the user is on.false
carrierCarrierSTRINGThe carrier of the device the user is on.false
countryCountrySTRINGThe country the user is in.false
cityCitySTRINGThe city the user is in.false
dmaDesignated Market AreaSTRINGThe Designated Market Area of the user.false
languageLanguageSTRINGThe language the user has set.false

Example JSON Structure

{
  "label" : "Create or Update User",
  "name" : "createOrUpdateUser",
  "parameters" : {
    "id" : "",
    "device_id" : "",
    "user_id" : "",
    "user_properties" : [ {
      "key" : "",
      "value" : ""
    } ],
    "platform" : "",
    "os_name" : "",
    "device_brand" : "",
    "carrier" : "",
    "country" : "",
    "city" : "",
    "dma" : "",
    "language" : ""
  },
  "type" : "amplitude/v1/createOrUpdateUser"
}

Output

Type: STRING


Additional instructions