Introduction
Datasources and destinations
- Find all the data sources available at www.catchr.io/connectors
- Find all the destinations available at www.catchr.io/destinations
Day of the year Day of the year |
| ||||||
Day of the week Day of the week |
| ||||||
Hour of the day Hour of the day. |
| ||||||
Month of the year Month of the year |
| ||||||
Month and day Month and day |
| ||||||
Quarter of the year Quarter of the year |
| ||||||
Normalized Week of the year Week of the year |
| ||||||
Week of the year (start Sunday) Week of the year |
| ||||||
Year Year such as 2017. |
| ||||||
Year month Year and month. |
| ||||||
Normalized Date Year, month, and day. |
| ||||||
Year month day hour Year, month, day, and hour. |
| ||||||
Year Quarter Year and quarter. |
| ||||||
Year week Year and week. |
| ||||||
Account Amount Spent Account Amount Spent of the Ad Account |
| ||||||
Account Balance Account balance of the Ad Account |
| ||||||
Account Currency Currency that is used by your ad account. |
| ||||||
Account Id The ID number of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.
|
| ||||||
Account Name The name of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.
|
| ||||||
Account Spend Cap Account Spend Cap of the Ad Account |
| ||||||
Action Canvas Component Name Nom d’un composant dans une publicité Canvas. |
| ||||||
Action Carousel Card Id ID de la fiche carrousel spécifique avec laquelle les personnes ont interagi lorsqu’elles ont vu votre publicité. |
| ||||||
Action Carousel Card Name Fiche carrousel spécifique avec laquelle les personnes ont interagi lorsqu’elles ont vu votre publicité. Les fiches sont identifiées par leurs titres. |
| ||||||
Action Destination Destination où les personnes se rendent après avoir cliqué sur votre publicité. Il peut s’agir de votre Page Facebook, d’une URL externe pour votre pixel de conversion ou d’une app configurée avec le Kit de développement logiciel (SDK). |
| ||||||
Action Device Appareil sur lequel l’évènement de conversion que vous suivez est survenu. Par exemple, \"Desktop\" si quelqu’un a effectué une conversion sur un ordinateur de bureau. |
| ||||||
Action Reaction Nombre de réactions à vos publicités ou publications boostées. Le bouton de réaction sur une publicité permet aux personnes de partager différentes réactions concernant son contenu : J’aime, J’adore, Haha, Wouah, Triste ou Grrr. |
| ||||||
Action Target Id ID de la destination où les personnes se rendent après avoir cliqué sur votre publicité. Il peut s’agir de votre Page Facebook, d’une URL externe pour votre pixel de conversion ou d’une app configurée avec le kit de développement logiciel (SDK). |
| ||||||
Action Type Type d’actions effectuées sur votre publicité, page, app ou évènement après que votre publicité a été envoyée à une personne, même si cette dernière n’a pas cliqué dessus. Les types d’action incluent les mentions J’aime sur une page, les installations d’application, les conversions et les réponses à un évènement. |
| ||||||
In-App Ad Clicks |
| ||||||
In-App Ad Impressions |
| ||||||
Mobile App Feature Unlocks |
| ||||||
Mobile App Starts |
| ||||||
Mobile App Payment Details |
| ||||||
Mobile App Adds To Cart |
| ||||||
Mobile App Adds to Wishlist |
| ||||||
Mobile App Registrations |
| ||||||
Mobile App Content Views |
| ||||||
Mobile App Checkouts |
| ||||||
Mobile App Achievements |
| ||||||
Mobile App Purchases |
| ||||||
Mobile App Ratings |
| ||||||
Mobile App Searchs |
| ||||||
Mobile App Credit Spends |
| ||||||
Mobile App Tutorial Completions |
| ||||||
Other Mobile App Actions |
| ||||||
App Installs |
| ||||||
App Uses |
| ||||||
Mobile App Canceled Subscriptions |
| ||||||
Offline Canceled Subscriptions |
| ||||||
Canceled Subscriptions |
| ||||||
Website Canceled Subscriptions |
| ||||||
Check-ins |
| ||||||
Call Confirmation Clicks |
| ||||||
20-second Messenger calls The number of times Messenger calls resulted in successful connections lasting at least 20 seconds, attributed to your ad. This metric excludes ads that were delivered from Europe and Japan, and only is available in select countries |
| ||||||
60-second Messenger calls The number of times Messenger calls resulted in successful connections lasting at least 60 seconds, attributed to your ad. This metric excludes ads that were delivered from Europe and Japan, and only is available in select countries |
| ||||||
Messenger calls placed The number of times a Messenger call was made to your business, attributed to your ad. This metric excludes ads that were delivered from Europe and Japan |
| ||||||
Post Comments |
| ||||||
Mobile App Contacts |
| ||||||
Offline Contacts |
| ||||||
Contacts |
| ||||||
Website Contacts |
| ||||||
Credit Spends |
| ||||||
Mobile App Products Customized |
| ||||||
Offline Products Customized |
| ||||||
Products Customized |
| ||||||
Website Products Customized |
| ||||||
Mobile App Donations |
| ||||||
Offline Donations |
| ||||||
On Facebook Donations |
| ||||||
Donations |
| ||||||
Website Donations |
| ||||||
Mobile App Location Searches |
| ||||||
Offline App Location Searches |
| ||||||
Location Searches |
| ||||||
Website Location Searches |
| ||||||
Game Plays |
| ||||||
Landing Page Views |
| ||||||
All offsite leads plus all On-Facebook leads |
| ||||||
On-Facebook leads coming from Messenger and Instant Forms |
| ||||||
Page Likes |
| ||||||
Link Clicks |
| ||||||
Mobile App Installs |
| ||||||
Adds Payment Info |
| ||||||
Adds To Cart |
| ||||||
Adds To Wishlist |
| ||||||
Completed Registration |
| ||||||
Custom pixel events defined by the advertiser |
| ||||||
Initiates Checkout |
| ||||||
Leads |
| ||||||
Purchases |
| ||||||
Searchs |
| ||||||
Views Content |
| ||||||
Omni Achievements Unlocked |
| ||||||
Omni App Activations |
| ||||||
Omni Adds to Cart |
| ||||||
Omni App Installs |
| ||||||
Omni Registrations Completed |
| ||||||
Omni Custom Events |
| ||||||
Omni Checkouts Initiated |
| ||||||
Omni Levels Achieved |
| ||||||
Omni Purchases |
| ||||||
Omni Ratings Submitted |
| ||||||
Omni Searches |
| ||||||
Omni Credit Spends |
| ||||||
Omni Tutorials Completed |
| ||||||
Omni Content Views |
| ||||||
On-Facebook Workflow Completions |
| ||||||
All On-Facebook Leads |
| ||||||
Blocked Messaging Conversations |
| ||||||
Messaging Conversations Started |
| ||||||
New Messaging Conversations |
| ||||||
Post Saves |
| ||||||
On-Facebook Purchases |
| ||||||
Page Engagement |
| ||||||
Page Photo Views |
| ||||||
Post Shares |
| ||||||
Post Engagement |
| ||||||
Post Reactions |
| ||||||
Mobile App Recurring Subscription Payments |
| ||||||
Offline Recurring Subscription Payments |
| ||||||
Recurring Subscription Payments |
| ||||||
Website Recurring Subscription Payments |
| ||||||
Event Responses |
| ||||||
Mobile App Appointments Scheduled |
| ||||||
Offline App Appointments Scheduled |
| ||||||
Appointments Scheduled |
| ||||||
Website Appointments Scheduled |
| ||||||
Mobile App Trials Started |
| ||||||
Offline Trials Started |
| ||||||
Trials Started |
| ||||||
Website Trials Started |
| ||||||
Mobile App Applications Submitted |
| ||||||
Offline Applications Submitted |
| ||||||
On Facebook Applications Submitted |
| ||||||
Applications Submitted |
| ||||||
Website Applications Submitted |
| ||||||
Mobile App Subscriptions |
| ||||||
Offline Subscriptions |
| ||||||
Subscriptions |
| ||||||
Website Subscriptions |
| ||||||
3-Second Video Views |
| ||||||
In-App Ad Clicks Values |
| ||||||
In-App Ad Impressions Values |
| ||||||
Mobile App Feature Unlocks Values |
| ||||||
Mobile App Starts Values |
| ||||||
Mobile App Payment Details Values |
| ||||||
Mobile App Adds To Cart Values |
| ||||||
Mobile App Adds to Wishlist Values |
| ||||||
Mobile App Registrations Values |
| ||||||
Mobile App Content Views Values |
| ||||||
Mobile App Checkouts Values |
| ||||||
Mobile App Achievements Values |
| ||||||
Mobile App Purchases Values |
| ||||||
Mobile App Ratings Values |
| ||||||
Mobile App Searchs Values |
| ||||||
Mobile App Credit Spends Values |
| ||||||
Mobile App Tutorial Completions Values |
| ||||||
Other Mobile App Actions Values |
| ||||||
App Installs Values |
| ||||||
App Uses Values |
| ||||||
Mobile App Canceled Subscriptions Values |
| ||||||
Offline Canceled Subscriptions Values |
| ||||||
Canceled Subscriptions Values |
| ||||||
Website Canceled Subscriptions Values |
| ||||||
Check-ins Values |
| ||||||
Call Confirmation Clicks Values |
| ||||||
Post Comments Values |
| ||||||
Mobile App Contacts Values |
| ||||||
Offline Contacts Values |
| ||||||
Contacts Values |
| ||||||
Website Contacts Values |
| ||||||
Credit Spends Values |
| ||||||
Mobile App Products Customized Values |
| ||||||
Offline Products Customized Values |
| ||||||
Products Customized Values |
| ||||||
Website Products Customized Values |
| ||||||
Mobile App Donations Values |
| ||||||
Offline Donations Values |
| ||||||
On Facebook Donations Values |
| ||||||
Donations Values |
| ||||||
Website Donations Values |
| ||||||
Mobile App Location Searches Values |
| ||||||
Offline App Location Searches Values |
| ||||||
Location Searches Values |
| ||||||
Website Location Searches Values |
| ||||||
Game Plays Values |
| ||||||
Landing Page Views Values |
| ||||||
All offsite leads plus all On-Facebook leads Values |
| ||||||
On-Facebook leads coming from Messenger and Instant Forms Values |
| ||||||
Page Likes Values |
| ||||||
Link Clicks Values |
| ||||||
Mobile App Installs Values |
| ||||||
Adds Payment Info Values |
| ||||||
Adds To Cart Values |
| ||||||
Adds To Wishlist Values |
| ||||||
Completed Registration Values |
| ||||||
Custom pixel events defined by the advertiser Values |
| ||||||
Initiates Checkout Values |
| ||||||
Leads Values |
| ||||||
Purchases Values |
| ||||||
Searchs Values |
| ||||||
Views Content Values |
| ||||||
Omni Achievements Unlocked Values |
| ||||||
Omni App Activations Values |
| ||||||
Omni Adds to Cart Values |
| ||||||
Omni App Installs Values |
| ||||||
Omni Registrations Completed Values |
| ||||||
Omni Custom Events Values |
| ||||||
Omni Checkouts Initiated Values |
| ||||||
Omni Levels Achieved Values |
| ||||||
Omni Purchases Values |
| ||||||
Omni Ratings Submitted Values |
| ||||||
Omni Searches Values |
| ||||||
Omni Credit Spends Values |
| ||||||
Omni Tutorials Completed Values |
| ||||||
Omni Content Views Values |
| ||||||
On-Facebook Workflow Completions Values |
| ||||||
All On-Facebook Leads Values |
| ||||||
Blocked Messaging Conversations Values |
| ||||||
Messaging Conversations Started Values |
| ||||||
New Messaging Conversations Values |
| ||||||
Post Saves Values |
| ||||||
On-Facebook Purchases Values |
| ||||||
Outbound Clicks Values |
| ||||||
Page Engagement Values |
| ||||||
Page Photo Views Values |
| ||||||
Post Shares Values |
| ||||||
Post Engagement Values |
| ||||||
Post Reactions Values |
| ||||||
Mobile App Recurring Subscription Payments Values |
| ||||||
Offline Recurring Subscription Payments Values |
| ||||||
Recurring Subscription Payments Values |
| ||||||
Website Recurring Subscription Payments Values |
| ||||||
Event Responses Values |
| ||||||
Mobile App Appointments Scheduled Values |
| ||||||
Offline App Appointments Scheduled Values |
| ||||||
Appointments Scheduled Values |
| ||||||
Website Appointments Scheduled Values |
| ||||||
Mobile App Trials Started Values |
| ||||||
Offline Trials Started Values |
| ||||||
Trials Started Values |
| ||||||
Website Trials Started Values |
| ||||||
Mobile App Applications Submitted Values |
| ||||||
Offline Applications Submitted Values |
| ||||||
On Facebook Applications Submitted Values |
| ||||||
Applications Submitted Values |
| ||||||
Website Applications Submitted Values |
| ||||||
Mobile App Subscriptions Values |
| ||||||
Offline Subscriptions Values |
| ||||||
Subscriptions Values |
| ||||||
Website Subscriptions Values |
| ||||||
3-Second Video Views Values |
| ||||||
Action Values The total value of all conversions attributed to your ads.
|
| ||||||
Action Video Sound Statut du son (activé/désactivé) lorsque quelqu’un lit votre publicité vidéo. |
| ||||||
Action Video Type Répartition des indicateurs des vidéos. |
| ||||||
Actions The total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions.
|
| ||||||
Ad Labels Ad labels associated with this ad |
| ||||||
Ad Bid Amount Bid amount for this ad which will be used in auction instead of the ad set bid_amount, if specified. |
| ||||||
Ad Configured Status The configured status of the ad. Use status instead of this field. |
| ||||||
Ad Created At Time when the ad was created. |
| ||||||
Ad status (effective status) Ad status (effective status) |
| ||||||
Ad Preview URL A link that enables users to preview ads in different placements |
| ||||||
Ad Status The configured status of the ad. The field returns the same value as configured_status. Use this field, instead of configured_status. |
| ||||||
Ad Updated Time Time when this ad was updated. |
| ||||||
Ad Format Asset ID de la ressource de format publicitaire concernée par une impression, un clic ou une action. |
| ||||||
Ad Id The unique ID of the ad you're viewing in reporting.
|
| ||||||
Ad Name The name of the ad you're viewing in reporting.
|
| ||||||
Ad Set Bid Amount Bid cap or target cost for this ad set. |
| ||||||
Ad Set Bid Strategy Bid strategy for this ad set when you use AUCTION as your buying type. |
| ||||||
Ad Set Billing Event The billing event for this ad set. |
| ||||||
Ad Set Budget Remaining Remaining budget of this Ad Set. |
| ||||||
Ad Set configured status The configured status of the Ad Set |
| ||||||
Ad Set Created Time Time when this Ad Set was created |
| ||||||
Daily budget of the Ad Set The daily budget of the set defined in your account currency. |
| ||||||
Daily minimun budget of the Ad Set Daily minimum spend target of the ad set defined in your account currency. |
| ||||||
Daily Spend Cap of the Ad Set Daily spend cap of the ad set defined in your account currency. |
| ||||||
Destination Type of the Ad Set Destination of ads in this Ad Set. |
| ||||||
DSA beneficiary of the Ad Set The beneficiary of all ads in this ad set. |
| ||||||
DSA Payor of the Ad Set The payor of all ads in this ad set. |
| ||||||
Ad Set End Time Time when this Ad Set end. |
| ||||||
AdSet Learning Stage Info Status AdSet Learning Stage Info Status |
| ||||||
Lifetime budget of the Ad Set The lifetime budget of the set defined in your account currency. |
| ||||||
Lifetime Min Spend Target of the Ad Set Lifetime minimum spend target of the ad set defined in your account currency. |
| ||||||
Lifetime Spend Cap of the Ad Set Lifetime spend cap of the ad set defined in your account currency. |
| ||||||
Ad Set Optimization Goal The optimization goal this ad set is using. |
| ||||||
Ad Set Optimization Sub Event Goal Optimization sub event for a specific optimization goal. |
| ||||||
Recurring Budget Semantics. Recurring Budget Semantics. |
| ||||||
Ad Set Review Feedback Reviews for dynamic creative ad. |
| ||||||
Ad Set Start Time Time when this Ad Set start. |
| ||||||
Ad Set status (effective status) The status of the Ad Set |
| ||||||
AdSet Targeting maximum age Maximum age. If used, must be 65 or lower. |
| ||||||
AdSet Targeting minimum age Minimum age. Defaults to 18. If used, must be 13 or higher. If the app has custom settings for age restrictions, the app's age restrictions will be used for ads with APP_INSTALL goals. For example, if you set age_min to 13 but your app's age minimum is set to 18, 18 will be used in ads targeting. |
| ||||||
AdSet Targeting countries Country targeting |
| ||||||
AdSet Targeting Country Groups Global geographical regions and free trade areas. Provide array of country group codes. |
| ||||||
AdSet Targeting Custom Audience |
| ||||||
AdSet Targeting Custom Audience Names |
| ||||||
AdSet Targeting genders Genders to target. Defaults to all. 1 targets males, 2 targets females. |
| ||||||
AdSet Targeting location type Location type targeting |
| ||||||
Adset Targeting Content |
| ||||||
Adset Targeting |
| ||||||
Ad Set Updated Time Time when this Ad Set was updated. |
| ||||||
Use new app click. If set, allows Mobile App Engagement ads to optimize for LINK_CLICKS. |
| ||||||
Adset Id The unique ID of the ad set you're viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.
|
| ||||||
Adset Name The name of the ad set you're viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.
|
| ||||||
Age Tranche d’âge des personnes que vous avez atteintes. |
| ||||||
App Id ID de l’application associée au compte publicitaire ou à la campagne demandé. Les informations concernant l’application, y compris son ID, sont disponibles dans Espace App.Remarque : cette répartition est disponible uniquement avec le champ total_postbacks. |
| ||||||
Attribution Setting The default attribution window to be used when the attribution result is calculated. Each ad set has its own attribution setting value. The attribution setting for a campaign or an account is calculated based on existing ad sets. Returns mixed, indicating multiple attribution settings, skan, indicating SKAdNetwork attribution of iOS 14 app install campaigns, and na, indicating no ad set in a campaign or account.
The attribution_setting field only returns values when use_unified_attribution_setting is set to true.
|
| ||||||
Average Order Value Average purchase value per purchases. |
| ||||||
Body Asset ID de la ressource de corps concernée par une impression, un clic ou une action. |
| ||||||
Buying Type The method by which you pay for and target ads in your campaigns: through dynamic auction bidding, fixed-price bidding, or reach and frequency buying. This field is currently only visible at the campaign level.
|
| ||||||
Call To Action Asset ID de la ressource de call-to-action concernée par une impression, un clic ou une action. |
| ||||||
Campaign Ad Strategy Group ID Campaign Ad Strategy Group ID. |
| ||||||
Campaign Ad Strategy ID Ad Strategy ID. |
| ||||||
Campaign Bid Strategy Bid strategy for this campaign when you enable campaign budget optimization and when you use AUCTION as your buying type. |
| ||||||
Campaign Remaining budget Remaining budget |
| ||||||
Campaign Buying type Buying type. |
| ||||||
Campaign can create brand lift study If we can create a new automated brand lift study for the ad set. |
| ||||||
Campaign can use spend cap Whether the campaign can set the spend cap. |
| ||||||
Campaign Configured Status If this status is PAUSED, all its active ad sets and ads will be paused and have an effective status CAMPAIGN_PAUSED. Prefer using 'status' instead of this. |
| ||||||
Campaign Created Time Created Time |
| ||||||
Campaign Daily Budget The daily budget of the campaign |
| ||||||
Campaign Effective Status Campaign Effective Status |
| ||||||
Campaign has secondary SKAdNetwork reporting Campaign has secondary SKAdNetwork reporting |
| ||||||
Campaign Is SKAdNetwork attribution When set to true Indicates that the campaign will include SKAdNetwork, iOS 14+. |
| ||||||
Campaign Last budget toggling time Last budget toggling time. |
| ||||||
Campaign Budget Lifetime The lifetime budget of the campaign |
| ||||||
Campaign Objective Campaign's objective. Some objectives are currently in limited beta testing. |
| ||||||
Campaign Primary Attribution Campaign Primary Attribution |
| ||||||
Campaign Smart promotion Type Campaign Smart promotion Type |
| ||||||
Campaign Source ID The source campaign id that this campaign is copied from. |
| ||||||
Campaign Special Ad Category The campaign's Special Ad Category. One of HOUSING, EMPLOYMENT, CREDIT, or NONE. |
| ||||||
Campaign Spend Cap A spend cap for the campaign, such that it will not spend more than this cap. Expressed as integer value of the subunit in your currency. |
| ||||||
Campaign Start date Merging of start_times for the ad sets belonging to this campaign. At the campaign level, start_time is a read only field. You can setup start_time at the ad set level. |
| ||||||
Campaign Status If this status is PAUSED, all its active ad sets and ads will be paused and have an effective status CAMPAIGN_PAUSED. The field returns the same value as 'configured_status', and is the suggested one to use. |
| ||||||
Campaign Stop Date Merging of stop_times for the ad sets belonging to this campaign, if available. At the campaign level, stop_time is a read only field. You can setup stop_time at the ad set level. |
| ||||||
Campaign Topline ID Topline ID. |
| ||||||
Campaign Updated Time Updated Time. If you update spend_cap or daily budget or lifetime budget, this will not automatically update this field. |
| ||||||
Campaign Id The unique ID number of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.
|
| ||||||
Campaign Name The name of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.
|
| ||||||
Canvas Avg View Percent The average percentage of the Instant Experience that people saw. An Instant Experience is a screen that opens after someone interacts with your ad on a mobile device. It may include a series of interactive or multimedia components, including video, images product catalog and more.
|
| ||||||
Canvas Avg View Time The average total time, in seconds, that people spent viewing an Instant Experience. An Instant Experience is a screen that opens after someone interacts with your ad on a mobile device. It may include a series of interactive or multimedia components, including video, images product catalog and more.
|
| ||||||
Add to cart conversion actions (shared item) The total actions of the shared items contained in add to cart events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Offsite conversion actions (shared item) The total actions of the shared items contained in offsite conversions with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Offsite conversion actions (shared item) - Add to cart The total actions of the shared items contained in offsite conversions with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Offsite conversion actions (shared item) - View content The total actions of the shared items contained in offsite conversions with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Omni add to cart conversion actions (shared item) The total actions of the shared items contained in add to cart events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Omni purchase (shared item) The total actions of the shared items contained in purchase events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Omni content view conversion actions (shared item) The total actions of the shared items contained in content views with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Onsite web add to cart conversion actions (shared item) The total actions of the shared items contained in add to cart events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Onsite web/app add to cart conversion actions (shared item) The total actions of the shared items contained in add to cart events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Onsite web/app view content conversion actions (shared item) The total actions of the shared items contained in content views with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Onsite web view content conversion actions (shared item) The total actions of the shared items contained in content views with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Purchase (shared item) The total actions of the shared items contained in purchase events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Content view conversion actions (shared item) The total actions of the shared items contained in content views with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Catalog Segment Value The total value of all conversions from your catalog segment attributed to your ads.
|
| ||||||
Add to cart conversion value (shared item) The total value of the shared items contained in add to cart events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Offsite conversion value (shared item) The total value of the shared items contained in offsite conversions with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Offsite conversion value (shared item) - Add to cart The total value of the shared items contained in offsite conversions with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Offsite conversion value (shared item) - View content The total value of the shared items contained in offsite conversions with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Omni add to cart conversion value (shared item) The total value of the shared items contained in add to cart events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Omni Purchase value (shared item) The total value of the shared items contained in purchase events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Omni content view conversion value (shared item) The total value of the shared items contained in content views with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Onsite web add to cart conversion value (shared item) The total value of the shared items contained in add to cart events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Onsite web/app add to cart conversion value (shared item) The total value of the shared items contained in add to cart events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Onsite web/app view content conversion value (shared item) The total value of the shared items contained in content views with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Onsite web view content conversion value (shared item) The total value of the shared items contained in content views with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Purchase value (shared item) The total value of the shared items contained in purchase events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Content view conversion value (shared item) The total value of the shared items contained in content views with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment |
| ||||||
Clicks The number of clicks on your ads.
|
| ||||||
Conversion Rate Ranking A ranking of your ad's expected conversion rate. Your ad is ranked against ads with your optimization goal that competed for the same audience. Possible values include BELOW_AVERAGE_10, BELOW_AVERAGE_20, BELOW_AVERAGE_35, AVERAGE, ABOVE_AVERAGE, or UNKNOWN if there's not enough information about the ad. This metric is an ad relevance diagnostic and does not apply to campaigns or ad sets, only ads.
|
| ||||||
Converted Product Quantity The number of products purchased which are recorded by your merchant partner's pixel or app SDK for a given product ID and driven by your ads. Has to be used together with converted product ID breakdown.
|
| ||||||
Converted Product Value The value of purchases recorded by your merchant partner's pixel or app SDK for a given product ID and driven by your ads. Has to be used together with converted product ID breakdown.
|
| ||||||
Cost Per Action Type The average cost of a relevant action.
|
| ||||||
Cost Per Conversion The average cost of a conversion across all channels (i.e. website, mobile app, offline, and on-facebook). Conversions include contact, customize_product, donate, find_location, schedule, start_trial, submit_application, subscribe, recurring_subscription_payment, cancel_subscription, ad_click, ad_impression.
|
| ||||||
Cost Per Estimated Ad Recallers The average cost for each estimated ad recall lift. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives. This metric is estimated and in development.
|
| ||||||
CPC (Link) The average cost of each inline link click.
|
| ||||||
Cost Per Inline Post Engagement The average cost of each inline post engagement.
|
| ||||||
Cost per outbound click The average cost for each outbound click.
|
| ||||||
Cost Per Purchases The average cost of each purchases |
| ||||||
Cost Per Thruplay The average cost for each ThruPlay. This metric is in development.
|
| ||||||
Cost Per Unique Action Type The average cost of each unique action. This metric is estimated.
|
| ||||||
Cost per unique click (all) The average cost for each unique click (all). This metric is estimated.
|
| ||||||
Cost per unique link click The average cost of each unique inline link click. This metric is estimated.
|
| ||||||
Cost per unique outbound click The average cost for each unique outbound click. This metric is estimated.
|
| ||||||
Country Code Country ISO CODE. |
| ||||||
Country Country Name |
| ||||||
CPC (All) The average cost for each click (all).
|
| ||||||
CPM The average cost for 1,000 impressions.
|
| ||||||
CPP The average cost to reach 1,000 people. This metric is estimated.
|
| ||||||
Ad Creative Body The body of the ad. Not supported for video post creatives |
| ||||||
Creative Branded Content Sponsor Page Id ID for page representing business which runs Branded Content ads. |
| ||||||
Call to action type Type of call to action button in your ad. This determines the button text and header text for your ad. |
| ||||||
Categorization criteria The Dynamic Category Ad's categorization field, e.g. brand. |
| ||||||
Category Media Source The Dynamic Ad's rendering mode for category ads. |
| ||||||
Destination Set Id The ID of the Product Set for a Destination Catalog that will be used to link with Travel Catalogs. |
| ||||||
Dynamic Ad Voice Used for Store Traffic Objective inside Dynamic Ads. Allows you to control the voice of your ad. If set to DYNAMIC, page name and profile picture in your ad post come from the nearest page location. If set to STORY_OWNER, page name and profile picture in your ad post come from the main page location. |
| ||||||
Effective Authorization Company Specifies whether ad is a political ad or not. See Facebook Advertising Policies. This field cannot be used for Dynamic Ads.This value can be different than the authorization_category value in case our systems have identified the ad as political even though it was not configured to be labeled as such. |
| ||||||
Effective Instagram Media Id Used for Instagram Ads. The ID of an Instagram post to display as an Instagram ad. |
| ||||||
Enable Direct Install Whether Direct Install should be enabled on supported devices. |
| ||||||
Enable Launch Instant App Whether Instant App should be enabled on supported devices. |
| ||||||
Ad Creative ID Unique ID for an ad creative, numeric string. |
| ||||||
Ad Creative Image Hash Image hash for ad creative. If provided, do not add image_url. See image library for more details. |
| ||||||
Ad Creative Image A URL for the image for this creative. We save the image at this URL to the ad account's image library. If provided, do not include image_hash. |
| ||||||
Instagram Actor ID URL for a post on Instagram you want to run as an ad. Also known as Instagram media. |
| ||||||
Instagram Story ID Used for Instagram Stories as Ads. Specifies the Instagram story you want to run as an ad. This field will be deprecated in the future. Use SOURCE_INSTAGRAM_STORY_ID |
| ||||||
Link Destination Display URL Overwrites the display URL for link ads when object_url is set to a click tag. |
| ||||||
Link OG ID The Open Graph (OG) ID for the link in this creative if the landing page has OG tags. |
| ||||||
Link To Post The Facebook URL post. |
| ||||||
Link URL Identify a specific landing tab on your Facebook page by the Page tab's URL. See connection objects for retrieving Page tab URLs. You can add app_data parameters to the URL to pass data to a Page's tab. |
| ||||||
Messenger Sponsored Message Used for Messenger sponsored message. JSON string with message for this ad creative. See Messenger Platform, Send API Reference. |
| ||||||
Creative Name Name of this ad creative as seen in the ad account's library. This field has a limit of 100 characters. |
| ||||||
Object ID ID for Facebook object being promoted with ads or relevant to the ad or ad type. For example a page ID if you are running ads to generate Page Likes. See promoted_object. |
| ||||||
Object Store URL iTunes or Google Play of the destination of an app ad. |
| ||||||
Object Type The type of Facebook object you want to advertise. |
| ||||||
Destination URL URL that opens if someone clicks your link on a link ad. This URL is not connected to a Facebook page. |
| ||||||
Plage Page Set Id The ID of the page set for this creative. |
| ||||||
Playable Asset Id The ID of the playable asset in this creative. |
| ||||||
Product Set ID Used for Dynamic Ad. An ID for a product set, which groups related products or other items being advertised. |
| ||||||
Promoted Post Backdated Time The backdated time for backdate post. For regular post, this field will be set to null. |
| ||||||
Promoted Post Can Reply Privately Whether the page viewer can send a private reply to this post |
| ||||||
Promoted Post Comments Mirroring Domain If comments are being mirrored to an external site, this function returns the domain of that external site. |
| ||||||
Promoted Post Created Time The time the post was published, expressed as UNIX timestamp |
| ||||||
Promoted Post Expanded Height An array of information about the attachment to the post |
| ||||||
Promoted Post Expanded Width An array of information about the attachment to the post |
| ||||||
Promoted Post Full Picture Full size picture from attachment |
| ||||||
Promoted Post Height |
| ||||||
Promoted Post Icon A link to an icon representing the type of this post. |
| ||||||
Promoted Post ID token with structure: Post ID |
| ||||||
Promoted Post Instagram Eligibility Whether the post can be promoted on Instagram. It returns the enum "eligible" if it can be promoted. Otherwise it returns an enum for why it cannot be promoted |
| ||||||
Promoted Post Is App Share Whether or not the post references an app |
| ||||||
Promoted Post Is Eligible For Promotion Whether the post is eligible for promotion. |
| ||||||
Promoted Post Is Expired Whether the post has expiration time that has passed |
| ||||||
Promoted Post Is Hidden Whether a post has been set to hidden |
| ||||||
Promoted Post Is Inline Created Returns True if the post was created inline when creating ads. |
| ||||||
Promoted Post Is Instagram Eligible |
| ||||||
Promoted Post Is Popular Whether the post is currently popular. Based on whether the total actions as a percentage of reach exceeds a certain threshold |
| ||||||
Promoted Post Is Published Indicates whether a scheduled post was published (applies to scheduled Page Post only, for users post and instanlty published posts this value is always true) |
| ||||||
Promoted Post Is Spherical Whether the post is a spherical video post |
| ||||||
Promoted Post Message The message of the promoted post associate with the creative. |
| ||||||
Promoted Post Multi Share End Card Whether display the end card for a multi-link share post |
| ||||||
Promoted Post Multi Share Optimized Whether automatically select the order of the links in multi-link share post when used in an ad |
| ||||||
Promoted Post Permalink URL The permanent static URL to the post on www.facebook.com. Example: https://www.facebook.com/FacebookforDevelopers/posts/10153449196353553 |
| ||||||
Promoted Post Promotion Status Status of the promotion, if the post was promoted |
| ||||||
Promoted Post Scheduled Publish Time UNIX timestamp of the scheduled publish time for the post |
| ||||||
Promoted Post Status Type Description of the type of a status update. |
| ||||||
Promoted Post Story Text of stories not intentionally generated by users, such as those generated when two users become friends. You must have the "Include recent activity stories" migration enabled in your app to retrieve this field |
| ||||||
Promoted Post Subscribed Whether user is subscribed to the post |
| ||||||
Promoted Post Timeline Visibility Timeline visibility information of the post |
| ||||||
Promoted Post Updated Time The time the post was last updated, which occurs when a user comments on the post. |
| ||||||
Promoted Post Width An array of information about the attachment to the post |
| ||||||
Creative Status The status of the creative. WITH_ISSUES and IN_PROCESS are available. |
| ||||||
Template URL Used for Dynamic Ads when you want to use third-party click tracking. See Dynamic Ads, Click Tracking and Templates. |
| ||||||
Thumbnail URL URL for a thumbnail image for this ad creative. |
| ||||||
Title Title for link ad, which does not belong to a page. |
| ||||||
AD UTM Campaign AD UTM Campaign |
| ||||||
Ad UTM Content Ad UTM Content |
| ||||||
AD UTM Medium AD UTM Medium |
| ||||||
AD UTM Source AD UTM Source |
| ||||||
AD UTM Term AD UTM Term |
| ||||||
Video ID Facebook object ID for video in this ad creative. |
| ||||||
CTR (all) The percentage of times people saw your ad and performed a click (all).
|
| ||||||
Custom Conversion name Custom Conversion name. |
| ||||||
Custom Conversion value Custom Conversion value. |
| ||||||
Date Start The start date for your data. This is controlled by the date range you've selected for your reporting view.
|
| ||||||
Date Stop The end date for your data. This is controlled by the date range you've selected for your reporting view.
|
| ||||||
Dda Results Estimated incremental conversions caused by a given ad based on the objective and settings you selected. This is a modeled value.
|
| ||||||
Description Asset ID de la ressource de description concernée par une impression, un clic ou une action. |
| ||||||
Device Platform Type d’appareil (mobile ou ordinateur de bureau) utilisé par les personnes lorsqu’elles ont visualisé ou cliqué sur une publicité, comme indiqué dans le rapport de publicités. |
| ||||||
Dma Les régions DMA (Designated Market Area) sont les 210 zones géographiques des États-Unis dans lesquelles les audiences télévisées locales sont mesurées par The Nielsen Company. |
| ||||||
Engagement Rate Ranking A ranking of your ad's expected engagement rate. Engagement includes all clicks, likes, comments and shares. Your ad is ranked against ads that competed for the same audience. Possible values include BELOW_AVERAGE_10, BELOW_AVERAGE_20, BELOW_AVERAGE_35, AVERAGE, ABOVE_AVERAGE, or UNKNOWN if there's not enough information about the ad. This metric is an ad relevance diagnostic and does not apply to campaigns or ad sets, only ads.
|
| ||||||
Estimated Ad Recall Rate The rate at which an estimated number of additional people, when asked, would remember seeing your ads within 2 days. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives. This metric is estimated and in development.
|
| ||||||
Estimated Ad Recallers An estimate of the number of additional people who may remember seeing your ads, if asked, within 2 days. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives. This metric is estimated and in development.
|
| ||||||
Frequency The average number of times each person saw your ad. This metric is estimated.
|
| ||||||
Frequency Value Nombre de fois qu’une publicité de votre campagne de couverture et répétition a été envoyée à chaque personne. |
| ||||||
Full View Impressions The number of Full Views on your Page's posts as a result of your ad.
|
| ||||||
Full View Reach The number of people who performed a Full View on your Page's post as a result of your ad.
|
| ||||||
Gender Genre des personnes que vous atteintes. Les personnes dont le genre n’est pas répertorié sont indiquées par la mention « Non spécifié ». |
| ||||||
Hourly Stats Aggregated By Advertiser Time Zone Répartition horaire agrégée par heure à laquelle les publicités ont été diffusées dans le fuseau horaire de l’annonceur. Par exemple, si vos publicités sont programmées pour être diffusées de 9 h à 11 h, mais qu’elles couvrent des audiences dans plusieurs fuseaux horaires, elles peuvent être diffusées de 9 h à 13 h dans le fuseau horaire de l’annonceur. Les statistiques seront alors agrégées en 4 groupes : 9 h - 10 h, 10 h - 11 h, 11 h - 12 h et 12 h - 13 h. |
| ||||||
Hourly Stats Aggregated By Audience Time Zone Répartition horaire agrégée par heure à laquelle les publicités ont été diffusées dans le fuseau horaire des audiences. Par exemple, si vos publicités sont programmées pour être diffusées de 9 h à 11 h, mais qu’elles couvrent des audiences dans plusieurs fuseaux horaires, elles peuvent être diffusées de 9 h à 13 h dans le fuseau horaire de l’annonceur. Les statistiques seront alors agrégées en 2 groupes : 9 h - 10 h et 10 h - 11 h. |
| ||||||
Image Asset ID de la ressource d’image concernée par une impression, un clic ou une action. |
| ||||||
Impression Device Appareil sur lequel votre dernière publicité a été envoyée à quelqu’un sur Facebook. Par exemple, \"iPhone" si quelqu’un a visualisé votre publicité sur un iPhone. |
| ||||||
Impressions The number of times your ads were on screen.
|
| ||||||
Inline Link Click Ctr The percentage of time people saw your ads and performed an inline link click.
|
| ||||||
Inline Link Clicks The number of clicks on links to select destinations or experiences, on or off Facebook-owned properties. Inline link clicks use a fixed 1-day-click attribution window.
|
| ||||||
Inline Post Engagement The total number of actions that people take involving your ads. Inline post engagements use a fixed 1-day-click attribution window.
|
| ||||||
Instant Experience Clicks To Open The number of clicks on your ad that open an Instant Experience. This metric is in development.
|
| ||||||
Instant Experience Clicks To Start The number of times an interactive component in an Instant Experience starts. This metric is in development.
|
| ||||||
Instant Experience Outbound Clicks The number of clicks on links in an Instant Experience that take people off Facebook-owned properties. This metric is in development.
|
| ||||||
Link Url Asset ID de la ressource d’URL concernée par une impression, un clic ou une action. |
| ||||||
Mobile App Purchase Roas The total return on ad spend (ROAS) from mobile app purchases. This is based on the value that you assigned when you set up the app event.
|
| ||||||
Objective The objective reflecting the goal you want to achieve with your advertising. It may be different from the selected objective of the campaign in some cases.
|
| ||||||
Optimization Goal The optimization goal you selected for your ad or ad set. Your optimization goal reflects what you want to optimize for the ads.
|
| ||||||
Outbound Clicks The number of clicks on links that take people off Facebook-owned properties.
|
| ||||||
Outbound Clicks Ctr The percentage of times people saw your ad and performed an outbound click.
|
| ||||||
Pixel Action name Pixel Action name. |
| ||||||
Pixel Action value Pixel Action value. |
| ||||||
Pixel ID Pixel ID. |
| ||||||
Place Page Id ID de la page de lieu concernée par une impression ou un clic.Remarque : Les insights au niveau du compte et page_place_id ne sont pas compatibles entre eux. Ils ne peuvent donc pas être interrogés ensemble. |
| ||||||
Placement Placement of your ads in the Meta network. |
| ||||||
Platform Position Emplacement où votre publicité a été affichée sur une plate-forme, par exemple le fil d’actualité Facebook sur ordinateur ou le fil d’actualité Instagram sur mobile. |
| ||||||
Product Id ID et nom du produit concerné par une impression, un clic ou une action. |
| ||||||
Publisher Platform Plate-forme sur laquelle votre publicité a été affichée, par exemple Facebook, Instagram ou Audience Network. |
| ||||||
Purchase Roas The total return on ad spend (ROAS) from purchases. This is based on information received from one or more of your connected Facebook Business Tools and attributed to your ads.
|
| ||||||
Qualifying Question Qualify Answer Rate qualifying_question_qualify_answer_rate |
| ||||||
Quality Ranking A ranking of your ad's perceived quality. Quality is measured using feedback on your ads and the post-click experience. Your ad is ranked against ads that competed for the same audience. Possible values include BELOW_AVERAGE_10, BELOW_AVERAGE_20, BELOW_AVERAGE_35, AVERAGE, ABOVE_AVERAGE, or UNKNOWN if there's not enough information about the ad. This metric is an ad relevance diagnostic (https://www.facebook.com/help/403110480493160) and does not apply to campaigns or ad sets, only ads.
|
| ||||||
Reach The number of people who saw your ads at least once. Reach is different from impressions, which may include multiple views of your ads by the same people. This metric is estimated.
|
| ||||||
Region Region. |
| ||||||
Skan Conversion Id ID de conversion (aussi appelé ID de priorité) attribué à l’évènement et/ou au groupe d’évènements configuré dans le schéma de configuration SKAdNetwork de l’application. La configuration des évènements d’application est indiquée et peut être modifiée dans le Gestionnaire d’évènements de Facebook. Pour en savoir plus sur la configuration des évènements d’application pour le SKAdNetwork d’Apple, cliquez ici.Remarque : cette répartition est disponible uniquement avec le champ total_postbacks. |
| ||||||
Social Spend The total amount you've spent so far for your ads showed with social information. (ex: Jane Doe likes this).
|
| ||||||
Spend The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated.
|
| ||||||
USD Spend The converted spend to USD from the fixer API |
| ||||||
Date Split the information by day |
| ||||||
Month Split the information by month. |
| ||||||
Title Asset ID de la ressource de titre concernée par une impression, un clic ou une action. |
| ||||||
Total Postbacks The total number of postbacks received from Apple’s SKAdNetwork API. Postbacks from SKAdNetwork provide visibility into the number of app installs and post-install events that occurred. This metric is reported by a third-party API.
Note: total_postbacks should not be queried with other field values. Request this metric separately from others.
|
| ||||||
Unique Inline Link Clicks CTR Unique Inline Link Clicks CTR |
| ||||||
Unique Link Clicks Unique Inline Link Clicks |
| ||||||
Unique Outbound Clicks Unique Outbound Clicks |
| ||||||
Unique outbound CTR Unique Outbound Clicks CTR |
| ||||||
Audience type The audience type for Advantage+ Shopping Campaigns. Values may be 'prospecting', 'existing', 'unknown' or 'uncategorized'. This breakdown only works with Advantage+ Shopping Campaigns |
| ||||||
Video 30 Sec Watched Actions The number of times your video played for at least 30 seconds, or for nearly its total length if it's shorter than 30 seconds. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video.
|
| ||||||
Video Asset ID de la ressource vidéo concernée par une impression, un clic ou une action. |
| ||||||
Video Avg Time Watched Actions The average time a video was played, including any time spent replaying the video for a single impression.
|
| ||||||
Video Continuous 2 Sec Watched Actions Video Continuous 2 Sec Watched Actions |
| ||||||
Video P100 Watched Actions The number of times your video was played at 100% of its length, including plays that skipped to this point.
|
| ||||||
Video P25 Watched Actions The number of times your video was played at 25% of its length, including plays that skipped to this point.
|
| ||||||
Video P50 Watched Actions The number of times your video was played at 50% of its length, including plays that skipped to this point.
|
| ||||||
Video P75 Watched Actions The number of times your video was played at 75% of its length, including plays that skipped to this point.
|
| ||||||
Video P95 Watched Actions The number of times your video was played at 95% of its length, including plays that skipped to this point.
|
| ||||||
Video Play Actions The number of times your video starts to play. This is counted for each impression of a video, and excludes replays. This metric is in development.
|
| ||||||
Video Play Curve Actions A video-play based curve graph that illustrates the percentage of video plays that reached a given second. Entries 0 to 14 represent seconds 0 thru 14. Entries 15 to 17 represent second ranges [15 to 20), [20 to 25), and [25 to 30). Entries 18 to 20 represent second ranges [30 to 40), [40 to 50), and [50 to 60). Entry 21 represents plays over 60 seconds.
|
| ||||||
Video Thruplay The number of times your video was played to completion, or for at least 15 seconds. |
| ||||||
Website Ctr The percentage of times people saw your ad and performed a link click.
|
| ||||||
Website Purchase Roas The total return on ad spend (ROAS) from website purchases. This is based on the value of all conversions recorded by the Facebook pixel on your website and attributed to your ads.
|
| ||||||
Week of the year Week of the year |
|
.svg){kind=logo}