Apps

Create an app

Send either store_url, or name, bundle_id and platform. With store_url, Tenjin reads the app's name, bundle id and platform from the App Store or Google Play. Of the other attributes it keeps only the attribution windows; set the rest with PATCH /v2/apps/{id} after the app is created.

post/v2/apps

Request

Base URL
https://api.tenjin.com
Auth
HTTP bearer

Request body

store_urlstring

App Store or Google Play URL of the app, instead of name, bundle_id and platform. Tenjin reads the app from the store; a platform sent with it must match the store

Platform of the app

namestring

Name of the app

bundle_idstring

Bundle id of the app in its store

public_keystring

Google Play public key, used to validate in-app purchases

ios_shared_secretstring

App Store shared secret, used to track subscription revenue

amazon_shared_secretstring

Amazon Appstore shared key, used to validate in-app purchases

match_stringsstring

Comma-separated strings that match campaigns to the app

protocolstring

URL scheme of the app, used for Meta deep links

facebook_referrer_decryption_keystring

Meta install referrer decryption key, 64 characters, used to decrypt Meta attribution data of an Android app

destination_urlstring

Download URL of an android_other app

deterministic_click_attribution_windowstring nullable

Duration literal: 0, whole hours 1h to 24h, or whole days 1d to 30d. A whole number of days is returned in days, so 24h comes back as 1d. Null resets it to the default

deterministic_impression_attribution_windowstring nullable

Duration literal: 0, whole hours 1h to 24h, or whole days 1d to 30d. A whole number of days is returned in days, so 24h comes back as 1d. Null resets it to the default

probabilistic_click_attribution_windowstring nullable

Duration literal: 0, whole hours 1h to 24h, or whole days 1d to 3d. A whole number of days is returned in days, so 24h comes back as 1d. Null resets it to the default

probabilistic_impression_attribution_windowstring nullable

Duration literal: 0, whole hours 1h to 24h, or whole days 1d to 3d. A whole number of days is returned in days, so 24h comes back as 1d. Null resets it to the default

Example request

{
  "store_url": "https://play.google.com/store/apps/details?id=com.example.game",
  "deterministic_click_attribution_window": "1d",
  "deterministic_impression_attribution_window": "1d",
  "probabilistic_click_attribution_window": "1d",
  "probabilistic_impression_attribution_window": "1d"
}

Response

The created app

metaobject required

Always empty

Example response

{
  "data": {
    "attributes": {
      "name": "My Game",
      "bundle_id": "com.example.mygame",
      "platform": "ios",
      "store_id": "655745678",
      "rating": "4.5",
      "developer_name": "Example Games",
      "match_strings": [
        "mygame"
      ],
      "protocol": "mygame",
      "sending_events": true,
      "deterministic_click_attribution_window": "1d",
      "deterministic_impression_attribution_window": "1d",
      "probabilistic_click_attribution_window": "1d",
      "probabilistic_impression_attribution_window": "1d"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.