AccountContactButtonType
Provides detailed engagement metrics for the contact buttons (DIRECTION, CALL, EMAIL) displayed on an Instagram business profile during a specific time range. It tracks the total interactions for each type of contact button tapped, allowing for in-depth analysis using the 'contact_button_type' dimension. The permissions needed for access are Instagram_basic and Instagram_manage_insights.
Select
The connector will use the Instagram APIs to process filters that refer to a date range or InstagramBusinessAccountId and will process other filters client-side within itself.
- Metric supports the '=' operator.
The default query returns results for the 'profile_links_taps' metric.
SELECT * FROM AccountContactButtonType SELECT * FROM AccountContactButtonType WHERE FromDateTime='2023-07-02T00:00:00Z' AND ToDateTime='2023-07-24T00:00:00Z'
Columns
| Name | Type | Description |
| InstagramBusinessAccountId | String | A unique identifier associated with the Instagram Business Account from which the insights data is retrieved. This ID is required to accurately query engagement metrics specific to a business profile. |
| Metric | String | Specifies the type of engagement metric to retrieve for contact buttons. The default metric is profile_links_taps, which reflects total interactions with all contact methods on the profile.
The allowed values are profile_links_taps. |
| DIRECTION | Int | The number of times users tapped the Direction button on the Instagram business profile, typically used to get directions to a physical business location. |
| CALL | Int | The number of times users tapped the Call button on the Instagram profile, indicating intent to place a phone call to the business. |
| Int | The number of times users tapped the Email button, showing user interest in initiating contact with the business via email directly through the profile. | |
| BOOKNOW | Int | The number of times users engaged with the Book Now button, commonly linked to booking or reservation services integrated with the Instagram business profile. |
| TEXT | Int | The number of times users tapped the Text button on the business profile, which allows users to send a text message to the business directly. |
| INSTANTEXPERIENCE | Int | The number of taps on Instant Experience components refers to full-screen, mobile-optimized experiences launched from contact actions within Instagram, which include media, interactive elements, and links. |
| UNDEFINED | Int | The number of taps on contact components that could not be categorized into any predefined button types, which can include unsupported, experimental, or custom implementations. |
| StartDate | Datetime | The starting date of when the metric is calculated for a row. |
| EndDate | Datetime | The ending date of when the metric is calculated for a row. |
Pseudo-Columns
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
| Name | Type | Description |
| FromDateTime | Datetime | Represents the start of the time window for the insights data, indicating the earliest timestamp for which interaction data is included. |
| ToDateTime | Datetime | Represents the end of the time window for the insights data, marking the most recent timestamp for collected interaction metrics. |