Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Last Updated:

Lastupdatedate

Livesearch
placeholderSearch the Vibes Developer Wiki
typepage



Overview

An Acquisition Campaign defines a keyword or keywords, and/or API methods that you can use to opt into a Mobile Database list.

The Acquisition APIs are used to add or search for Participants and Get Acquisitions Campaigns.

The Callbacks are triggered when a Participant is added, or their status has changed.


Panel
borderColor#2B9CD7

Topics in this Section

Page Tree
root@self
startDepth2




Acquisition (Campaign) Entity Example

Code Block
{
   "acquisition_id":"Kwnl5OL3",
   "description":"Great Acquisition Campaign",
   "campaign_type":{
      "code":"ACQUISITION"
   },
   "status":"active",
   "start_date":"2016-04-05T14:30Z",
   "end_date":"2017-04-05T14:30Z",
   "acquisition_campaign":{
      "keywords":[
         "STORE",
         "STOR",
         "STORES"
      ]
   },
   "sourcecode": "65301",
   "url":"/companies/:company_idkey/campaigns/acquisition/Kwnl5OL3",
   "created_date":"2017-04-05T14:30Z",
   "updated_date":"2017-04-08T14:30Z"
}

Elements

84 (past)

9 (scheduled)

20
Data Element

Type

Max Char Length

Description

acquisition_id

String

Vibes alpha-numeric unique identifier for each Acquisition Campaign.

description

String

255

The name of the Acquisition Campaign (identifier description).

campaign_typeString11This is stored as a code value - for example: ACQUISITION.

status

String

The status of the Campaign. Examples (always lowercase):

  • scheduled
  • active
  • deleted
  • past
start_dateTimestamp20

The date the Campaign is starting. It should be in the ISO 8601 format - for example: 2016-04-05T14:30Z.

end_date

Timestamp

The date the Campaign is ending. It should be in the ISO 8601 format - for example: 2017-04-05T14:30Z.

acquisition_campaign

keywords

Collection

25

The Keywords (one or more) that you can send in the SMS to activate the Campaign.

Examples: "COUPON", "FASHION", "LOYALTY", "JOINUP".

sourcecodeStringThe shortcode the Acquisition Campaign is on.
urlString50Unique resource URL for the Acquisition Campaign.
created_dateTimestamp20The date this Acquisition Campaign was created. It should be in the ISO 8601 format - for example: 2016-04-05T14:30Z.
updated_dateTimestamp20The date this Acquisition Campaign was last updated. It should be in the ISO 8601 format - for example: 2017-04-05T14:30Z.