<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Asset",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:Asset"
  },
  "title" : "Asset"
}
-->

# Asset

Unified asset entity containing product-agnostic asset metadata and references.

```
object Asset
```

## Discussion

An `Asset` is the unified media entity used across ad placements in the Apple Ads Platform API. Different providers supply assets: App Store Connect images for Apple Ads campaigns, and Maps media for Apple Maps. The `assetType` field determines which sub-object is present in `assetDetails`.

Query endpoint requests support fields marked **Filterable** in the properties as filter criteria. See [Calling the Apple Ads Platform API](/documentation/Apple-Ads-Platform-API/calling-apple-ads-platform-api) for details on constructing queries.

### Example

```json
{
  "id": "770e8400-e29b-41d4-a716-446655440002",
  "name": "awayfinder_hero.png",
  "assetType": "IMAGE",
  "providerAssetId": "abc123-provider-id",
  "promotedObjectId": "987654321",
  "promotedObjectType": "BUSINESS_BRAND",
  "providerAssetMetadata": {
    "appPreviewDevice": "iphone_6_7",
    "assetGenId": "123456789;en-US;iphone_6_7;1;abc123def"
  },
  "assetDetails": {
    "width": 1920,
    "height": 1080,
    "format": "PNG",
    "sizeBytes": 2097152,
    "orientation": "LANDSCAPE",
    "providerAssetUrl": "https://is5-ssl.mzstatic.com/image/thumb/Purple123/v4/9b/7a/a4/awayfinder_hero.png/2048x2732.png",
    "providerToken": "Purple123/v4/9b/7a/a4/awayfinder_hero.png",
    "checkSum": "a3c2e1d4b5f6",
    "sortPosition": 1,
    "adAccountId": "123456789"
  },
  "parentAssetId": null,
  "variantIds": [],
  "creationTime": "2026-03-01T12:00:00.000",
  "modificationTime": "2026-03-01T12:00:00.000",
  "deleted": false,
  "eligibility": {
    "status": "ELIGIBLE",
    "blockedGroups": [],
    "allowedGroups": []
  }
}
```

## Topics

### Dictionaries

[`object Asset.ProviderAssetMetadata`](/documentation/Apple-Ads-Platform-API/Asset/ProviderAssetMetadata-data.dictionary)

Provider-specific metadata attached to an asset, with keys that vary by provider.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)