Contents

AppDetails

Application details and metadata.

Declaration

object AppDetails

Properties

NameTypeDescription
idstring

App identifier (Adam ID). Read-only.

appNamestring

Application display name.

artistNamestring

Developer or company name.

primaryLanguagestring

Primary language of the app (BCP-47 code, for example, "en-US").

primaryGenrestring

The primary App Store genre category (for example, ">Mobile Software Applications>Music").

secondaryGenrestring

The secondary App Store genre category, if assigned.

deviceClasses[string]

Device families supported by the app. Possible values: IPHONE, IPAD.

iconPictureUrluri

URL of the app’s icon image.

isPreorderboolean

Whether the app is currently available as a pre-order.

availableStorefronts[string]

List of ISO 3166-1 alpha-2 country codes where the app is available.

Discussion

The AppDetails object represents the App Store metadata for an app retrieved via Get App Details by Adam ID. The id field is the Adam ID, which is the same value used as promotedObjectId when targeting this app.

Use deviceClasses to verify that your campaign’s device-class targeting is compatible with the app before launching. Targeting an App Store country or region not in availableStorefronts will result in no impressions for that market.

Example

{
  "id": "324684580",
  "appName": "AwayFinder - Travel Planner",
  "artistName": "AwayFinder Inc.",
  "primaryLanguage": "en-US",
  "primaryGenre": ">Mobile Software Applications>Travel",
  "secondaryGenre": ">Mobile Software Applications>Lifestyle",
  "deviceClasses": [
    "IPHONE",
    "IPAD"
  ],
  "iconPictureUrl": "https://is5-ssl.mzstatic.com/image/thumb/Purple126/v4/aa/bb/cc/AppIcon-1024x1024.png",
  "isPreorder": false,
  "availableStorefronts": [
    "US",
    "GB",
    "DE",
    "JP",
    "AU"
  ]
}

See Also