branchio-sdk

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #llm #go #android #machine-learning #linux #docker #awesome #vue #awesome-list #security

(★ 8)

Un-official Node SDK for branch.io

branchio-sdk 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

This is an unofficial sdk for [branch.io](https://branch.io). See API reference for what you can do with branch [here](https://branchmetrics.github.io/docs/pages/apps/api/)

**Features**

- Initialize SDK using either `appId` or `branchKey`

## Installation

```sh
> npm install branchio-sdk
```

## Usage

```javascript
const branchio = require('branchio-sdk')

const client = branchio({ 
  appId: <APP_ID>,
  key: <BRANCH_IO_KEY>  // initialize branchio with either appId or branch key and branch secret but not both
  secret: <BRANCH_IO_SECRET>
})

const { url } = await client.link({ 
  alias: '',
  stage: 'new user',
  channel: 'facebook',
  feature: 'dashboard',
  campaign: 'content 123',
  tags: [ 'tag1', 'tag2', 'tag3' ],
  data: {
    'custom_bool': true,
    '$og_title': 'Title',
    '$og_description': 'Description',
    '$og_image_url': 'https://lorempixel.com/400/400'
  }
})
//=> https://example.app.link/0AjuiLcpqF
```

## Methods

### link()

This method is use for creating a deep link. See corresponding docs [here](https://branchmetrics.github.io/docs/pages/apps/api/#link-create)

```javascript
const { url } = await client.link({ 
  alias: '',
  stage: 'new user',
  channel: 'facebook',
  feature: 'dashboard',
  campaign: 'content 123',
  tags: [ 'tag1', 'tag2', 'tag3' ],
  data: {
    'custom_bool': true,
    '$og_title': 'Title',
    '$og_description': 'Description',
    '$og_image_url': 'https://lorempixel.com/400/400'
  }
})
//=> https://example.app.link/0AjuiLcpqF
```

### bulkLinks()

This method allows you to create multiple deep links at a go. See [docs](https://branchmetrics.github.io/docs/pages/apps/api/#link-create-bulk)

```javascript
const links = await client.bulkLinks([
  {
    stage: 'new user',
    channel: 'facebook',
    feature: 'dashboard',
    campaign: 'content 123',
    tags: [ 'tag1', 'tag2', 'tag3' ],
    data: {
      'custom_bool': true,
      '$og_title': 'Title',
      '$og_description': 'Description',
      '$og_image_url': 'https://lorempixel.com/400/400'
    }
  },
  {
    stage: 'new user',
    channel: 'facebook',
    feature: 'dashboard',
    campaign: 'content 123',
    tags: [ 'tag1', 'tag2', 'tag3' ],
    data: {
      'custom_bool': true,
      '$og_title': 'Title',
      '$og_description': 'Description',
      '$og_image_url': 'https://lorempixel.com/400/400'
    }
  }
])
// => [{ url: 'https://example.app.link/xUrsD0P' }, { url: 'https:/example.app.link/erTweDt' }]
```

### readLink()

This method is for reading details of a deep link. See corresponding docs [here](https://branchmetrics.github.io/docs/pages/apps/api/#link-read)

```javascript
const linkData = await client.readLink('https://example.app.link/0AjuiLcpqF')
//=> link data
```

### updateLink()

This method is for updating details of a deep link

```javascript
const client = branch({ key: '<BRANCH_IO_KEY', secret: '<BRANCH_IO_SECRET' })

const updateData = await client.updateLink({ 
  deepLink: 'https://example.app.link/ggxaqsx1dR',
  data: {
    channel: 'twitter',
    data: {
      name: 'John',
      user_id: 2481084010
    }
  }
 })

//=> link data
```

## TODO:

- [x] Add method to read link
- [x] Add method to update link
- [ ] Add method to update link tips
- [ ] Add method to create events
- [ ] Add method to create commerce events
- [ ] Add method to read user
- [ ] Add method to create referral link
- [ ] Add method to create referral reward

...

## Maintainers

[Samuel Amoah](https://github.com/snamoah)

branchio-sdk

branchio-sdk 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

branchio-sdk

branchio-sdk 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README