Announcement: `INSTALL_OPEN` app card CTAs

[AdsAPI]

As we continue to migrate all cards to use card_uri, we’re working to refactor for simplicity and consistency. Through this process, we recently removed the API-only INSTALL_OPEN CTA enum (see this thread). We’ve deployed a temporary fix to continue to allow the use of this value.

After careful consideration, we’ve made the decision to remove INSTALL_OPEN from the Ads API as early as 2018-01-04. We’re doing this for two reasons:

1. To be at parity with the ads.twitter.com.
2. Because this no longer works as it once did due to OS security changes on mobile devices.

We’ve deployed a temporary fix to translate create and update requests using INSTALL_OPEN to INSTALL in the interim. See the example below. Other app_cta values are not affected.

• Image app download
• Video app download

Twitter Ads API Team

---

Both data and request objects show "app_cta": "INSTALL" even though app_cta=INSTALL_OPEN in the request.

$ twurl -X POST -H ads-api.twitter.com "/2/accounts/18ce54d4x5t/cards/video_app_download?app_country_code=US&name=Twitter&video_id=13_887777498917777408&googleplay_app_id=com.twitter.android&app_cta=INSTALL_OPEN"
{
  "data": {
    "name": "Twitter",
    "googleplay_app_id": "com.twitter.android",
    "video_url": "https://video.twimg.com/amplify_video/vmap/887777498917777408.vmap",
    "video_owner_id": "756201191646691328",
    "video_content_id": "13_887777498917777408",
    "preview_url": "https://cards.twitter.com/cards/18ce54d4x5t/4zali",
    "id": "4zali",
    "account_id": "18ce54d4x5t",
    "app_country_code": "US",
    "video_hls_url": "https://video.twimg.com/amplify_video/887777498917777408/pl/-lXeP5lxiU7wnVHL.m3u8",
    "created_at": "2017-11-02T18:40:52Z",
    "card_uri": null,
    "updated_at": "2017-11-02T18:40:52Z",
    "video_poster_url": "https://pbs.twimg.com/amplify_video_thumb/887777498917777408/img/cwavyNV2brPoEOlK.jpg",
    "app_cta": "INSTALL",
    "deleted": false,
    "card_type": "VIDEO_APP_DOWNLOAD"
  },
  "request": {
    "params": {
      "video_poster_height": "9",
      "name": "Twitter",
      "googleplay_app_id": "com.twitter.android",
      "video_id": "13_887777498917777408",
      "video_height": "9",
      "video_url": "https://video.twimg.com/amplify_video/vmap/887777498917777408.vmap",
      "content_duration_seconds": "14",
      "video_owner_id": "756201191646691328",
      "video_content_id": "13_887777498917777408",
      "account_id": "18ce54d4x5t",
      "app_country_code": "US",
      "video_width": "16",
      "video_hls_url": "https://video.twimg.com/amplify_video/887777498917777408/pl/-lXeP5lxiU7wnVHL.m3u8",
      "video_poster_url": "https://pbs.twimg.com/amplify_video_thumb/887777498917777408/img/cwavyNV2brPoEOlK.jpg",
      "video_poster_width": "16",
      "app_cta": "INSTALL",
      "card_type": "VIDEO_APP_DOWNLOAD"
    }
  }
}

[AdsAPI]

[AdsAPI]

[AdsAPI]

The new date for this is 2018-01-09.

After the change is deployed, users will see the following error message when attempting to create an app card with the INSTALL_OPEN CTA:

$ twurl -X POST -H ads-api.twitter.com "/2/accounts/18ce54d4x5t/cards/video_app_download?app_country_code=US&name=expect_error&video_id=13_887777498917777408&googleplay_app_id=com.twitter.android&app_cta=INSTALL_OPEN"
{
  "errors": [
    {
      "code": "INVALID_PARAMETER",
      "message": "Expected CONNECT, SHOP, BOOK, PLAY, INSTALL, OPEN, ORDER, got \"INSTALL_OPEN\" for app_cta",
      "parameter": "app_cta"
    }
  ],
  "request": {
    "params": {
      "name": "test-INSTALL_OPEN",
      "googleplay_app_id": "com.twitter.android",
      "video_id": "13_887777498917777408",
      "account_id": "18ce54d4x5t",
      "app_country_code": "US"
    }
  }
}

[AdsAPI]

This change was deployed yesterday, 2018-01-09.