API ReferenceCommunity DiscussionAnnouncementsSubscribe
API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsSubscribeLog In
API Reference

custom_data

Item

Within a given item (ad), you can optionally use the custom_data property to store additional information about the creative.

2 fields are supported:

"custom_data": {
       "creative_name": null,
       "custom_id": null
 }
FieldTypeDescription
creative_nameString

Max size: 255 chars		Sample use case:
Store a human-friendly name that precisely identifies the same creative across different Taboola campaigns - e.g. a headline and target audience.
custom_idString

Max size: 30 chars		Sample use case:
Store a machine-friendly ID that precisely identifies the same creative across different Taboola campaigns - e.g. an ID from Google Campaign Manager.

🚧

Custom data fields are optional.

Reports

Custom data fields are (also) exposed via the following reports:

  1. Top Campaign Content report
  2. Real-time ads report

🚧

  1. Reports return the actual custom data fields (not the custom_data parent object).
  2. Field naming conventions may vary for different reports.