@owox/connectors 0.12.0-next-20251104091845 → 0.12.0-next-20251104125401

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/index.cjs +2404 -139
  2. package/dist/index.js +2404 -139
  3. package/package.json +1 -1
package/dist/index.cjs CHANGED
@@ -16433,75 +16433,2266 @@ const FacebookMarketing = (function() {
16433
16433
  "description": "Time when the ad was created.",
16434
16434
  "type": "datetime"
16435
16435
  },
16436
- "creative": {
16437
- "description": "This field is required for create. The ID or creative spec of the ad creative to be used by this ad. You can read more about creatives here. You may supply the ID within an object as follows:",
16438
- "type": "AdCreative"
16436
+ "creative_id": {
16437
+ "description": "Unique ID for the ad creative",
16438
+ "type": "string",
16439
+ "apiName": "creative.id"
16440
+ },
16441
+ "creative_effective_object_story_id": {
16442
+ "description": "The ID of a page post to use in an ad, regardless of whether its an organic or unpublished page post",
16443
+ "type": "string",
16444
+ "apiName": "creative.effective_object_story_id"
16445
+ },
16446
+ "creative_name": {
16447
+ "description": "Name of the ad creative as seen in the ad accounts library",
16448
+ "type": "string",
16449
+ "apiName": "creative.name"
16450
+ },
16451
+ "creative_object_story_spec": {
16452
+ "description": "Object story spec containing page_id and other details",
16453
+ "type": "string",
16454
+ "apiName": "creative.object_story_spec"
16455
+ },
16456
+ "creative_url_tags": {
16457
+ "description": "A set of query string parameters which will replace or be appended to urls clicked from page post ads",
16458
+ "type": "string",
16459
+ "apiName": "creative.url_tags"
16460
+ },
16461
+ "creative_asset_groups_spec": {
16462
+ "description": "This field is used to create ads using the Flexible ad format. You can read more about that here",
16463
+ "type": "AdCreativeAssetGroupsSpec"
16464
+ },
16465
+ "effective_status": {
16466
+ "description": "The effective status of the ad. The status could be effective either because of its own status, or the status of its parent units. WITH_ISSUES is available for version 3.2 or higher. IN_PROCESS is available for version 4.0 or higher",
16467
+ "type": "enum {ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES}"
16468
+ },
16469
+ "issues_info": {
16470
+ "description": "Issues for this ad that prevented it from delivering",
16471
+ "type": "list<AdgroupIssuesInfo>"
16472
+ },
16473
+ "last_updated_by_app_id": {
16474
+ "description": "Indicates the app used for the most recent update of the ad.",
16475
+ "type": "id"
16476
+ },
16477
+ "name": {
16478
+ "description": "Name of the ad.",
16479
+ "type": "string"
16480
+ },
16481
+ "preview_shareable_link": {
16482
+ "description": "A link that enables users to preview ads in different placements",
16483
+ "type": "string"
16484
+ },
16485
+ "recommendations": {
16486
+ "description": "If there are recommendations for this ad, this field includes them. Otherwise, it is not included in the response. Field not included in redownload mode.",
16487
+ "type": "list<AdRecommendation>"
16488
+ },
16489
+ "source_ad": {
16490
+ "description": "The source ad that this ad is copied from",
16491
+ "type": "Ad"
16492
+ },
16493
+ "source_ad_id": {
16494
+ "description": "The source ad id that this ad is copied from",
16495
+ "type": "numeric string"
16496
+ },
16497
+ "status": {
16498
+ "description": "The configured status of the ad. The field returns the same value as configured_status. Use this field, instead of configured_status.",
16499
+ "type": "enum {ACTIVE, PAUSED, DELETED, ARCHIVED}"
16500
+ },
16501
+ "tracking_specs": {
16502
+ "description": "With tracking specs, you log actions taken by people on your ad. This field takes arguments identical to action spec. See Tracking and Conversion Specs.",
16503
+ "type": "list<ConversionActionQuery>"
16504
+ },
16505
+ "updated_time": {
16506
+ "description": "Time when this ad was updated.",
16507
+ "type": "datetime"
16508
+ }
16509
+ };
16510
+ var adAccountUserFields = {
16511
+ "id": {
16512
+ "description": "ID of the App Scoped User",
16513
+ "type": "numeric string"
16514
+ },
16515
+ "name": {
16516
+ "description": "User public full name",
16517
+ "type": "string"
16518
+ }
16519
+ // Commented because this field is lead to mistake despite to presence in schema.
16520
+ // 'tasks': {
16521
+ // 'description': 'Tasks of App Scoped User',
16522
+ // 'type': 'list<string>'
16523
+ // }
16524
+ };
16525
+ var adAccountInsightsFields = {
16526
+ "account_currency": {
16527
+ "description": "Currency that is used by your ad account.",
16528
+ "type": "string"
16529
+ },
16530
+ "account_id": {
16531
+ "description": "The ID number of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.",
16532
+ "type": "numeric string",
16533
+ "GoogleSheetsFormat": "@"
16534
+ },
16535
+ "account_name": {
16536
+ "description": "The name of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.",
16537
+ "type": "string"
16538
+ },
16539
+ "action_values": {
16540
+ "description": "The total value of all conversions attributed to your ads.",
16541
+ "type": "list<AdsActionStats>"
16542
+ },
16543
+ "actions": {
16544
+ "description": "The total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions.",
16545
+ "type": "list<AdsActionStats>"
16546
+ },
16547
+ "ad_click_actions": {
16548
+ "description": "ad_click_actions",
16549
+ "type": "list<AdsActionStats>"
16550
+ },
16551
+ "ad_id": {
16552
+ "description": "The unique ID of the ad you're viewing in reporting.",
16553
+ "type": "numeric string",
16554
+ "GoogleSheetsFormat": "@"
16555
+ },
16556
+ "ad_impression_actions": {
16557
+ "description": "ad_impression_actions",
16558
+ "type": "list<AdsActionStats>"
16559
+ },
16560
+ "ad_name": {
16561
+ "description": "The name of the ad you're viewing in reporting.",
16562
+ "type": "string"
16563
+ },
16564
+ "adset_id": {
16565
+ "description": "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.",
16566
+ "type": "numeric string",
16567
+ "GoogleSheetsFormat": "@"
16568
+ },
16569
+ "adset_name": {
16570
+ "description": "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.",
16571
+ "type": "string"
16572
+ },
16573
+ "attribution_setting": {
16574
+ "description": "The default attribution window to be used when attribution result is calculated. Each ad set has its own attribution setting value. The attribution setting for campaign or account is calculated based on existing ad sets.",
16575
+ "type": "string"
16576
+ },
16577
+ "auction_bid": {
16578
+ "description": "auction_bid",
16579
+ "type": "numeric string",
16580
+ "GoogleBigQueryType": "numeric"
16581
+ },
16582
+ "auction_competitiveness": {
16583
+ "description": "auction_competitiveness",
16584
+ "type": "numeric string",
16585
+ "GoogleBigQueryType": "numeric"
16586
+ },
16587
+ "auction_max_competitor_bid": {
16588
+ "description": "auction_max_competitor_bid",
16589
+ "type": "numeric string",
16590
+ "GoogleBigQueryType": "numeric"
16591
+ },
16592
+ "buying_type": {
16593
+ "description": "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.",
16594
+ "type": "string"
16595
+ },
16596
+ "campaign_id": {
16597
+ "description": "The unique ID number of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.",
16598
+ "type": "numeric string",
16599
+ "GoogleSheetsFormat": "@"
16600
+ },
16601
+ "campaign_name": {
16602
+ "description": "The name of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.",
16603
+ "type": "string"
16604
+ },
16605
+ "canvas_avg_view_percent": {
16606
+ "description": "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.",
16607
+ "type": "numeric string",
16608
+ "GoogleBigQueryType": "numeric"
16609
+ },
16610
+ "canvas_avg_view_time": {
16611
+ "description": "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.",
16612
+ "type": "numeric string",
16613
+ "GoogleBigQueryType": "numeric"
16614
+ },
16615
+ "catalog_segment_actions": {
16616
+ "description": "The number of actions performed attributed to your ads promoting your catalog segment, broken down by action type.",
16617
+ "type": "list<AdsActionStats>"
16618
+ },
16619
+ "catalog_segment_value": {
16620
+ "description": "The total value of all conversions from your catalog segment attributed to your ads.",
16621
+ "type": "list<AdsActionStats>"
16622
+ },
16623
+ "catalog_segment_value_mobile_purchase_roas": {
16624
+ "description": "The total return on ad spend (ROAS) from mobile app purchases for your catalog segment.",
16625
+ "type": "list<AdsActionStats>"
16626
+ },
16627
+ "catalog_segment_value_omni_purchase_roas": {
16628
+ "description": "The total return on ad spend (ROAS) from all purchases for your catalog segment.",
16629
+ "type": "list<AdsActionStats>"
16630
+ },
16631
+ "catalog_segment_value_website_purchase_roas": {
16632
+ "description": "The total return on ad spend (ROAS) from website purchases for your catalog segment.",
16633
+ "type": "list<AdsActionStats>"
16634
+ },
16635
+ "clicks": {
16636
+ "description": "The number of clicks on your ads.",
16637
+ "type": "numeric string",
16638
+ "GoogleBigQueryType": "numeric"
16639
+ },
16640
+ "conversion_values": {
16641
+ "description": "conversion_values",
16642
+ "type": "list<AdsActionStats>"
16643
+ },
16644
+ "conversions": {
16645
+ "description": "conversions",
16646
+ "type": "list<AdsActionStats>"
16647
+ },
16648
+ "converted_product_quantity": {
16649
+ "description": "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.",
16650
+ "type": "list<AdsActionStats>"
16651
+ },
16652
+ "converted_product_value": {
16653
+ "description": "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.",
16654
+ "type": "list<AdsActionStats>"
16655
+ },
16656
+ "cost_per_15_sec_video_view": {
16657
+ "description": "cost_per_15_sec_video_view",
16658
+ "type": "list<AdsActionStats>"
16659
+ },
16660
+ "cost_per_2_sec_continuous_video_view": {
16661
+ "description": "cost_per_2_sec_continuous_video_view",
16662
+ "type": "list<AdsActionStats>"
16663
+ },
16664
+ "cost_per_action_type": {
16665
+ "description": "The average cost of a relevant action.",
16666
+ "type": "list<AdsActionStats>"
16667
+ },
16668
+ "cost_per_ad_click": {
16669
+ "description": "cost_per_ad_click",
16670
+ "type": "list<AdsActionStats>"
16671
+ },
16672
+ "cost_per_conversion": {
16673
+ "description": "cost_per_conversion",
16674
+ "type": "list<AdsActionStats>"
16675
+ },
16676
+ "cost_per_dda_countby_convs": {
16677
+ "description": "cost_per_dda_countby_convs",
16678
+ "type": "numeric string",
16679
+ "GoogleBigQueryType": "numeric"
16680
+ },
16681
+ "cost_per_inline_link_click": {
16682
+ "description": "The average cost of each inline link click.",
16683
+ "type": "numeric string",
16684
+ "GoogleBigQueryType": "numeric"
16685
+ },
16686
+ "cost_per_inline_post_engagement": {
16687
+ "description": "The average cost of each inline post engagement.",
16688
+ "type": "numeric string",
16689
+ "GoogleBigQueryType": "numeric"
16690
+ },
16691
+ "cost_per_one_thousand_ad_impression": {
16692
+ "description": "cost_per_one_thousand_ad_impression",
16693
+ "type": "list<AdsActionStats>"
16694
+ },
16695
+ "cost_per_outbound_click": {
16696
+ "description": "The average cost for each outbound click.",
16697
+ "type": "list<AdsActionStats>"
16698
+ },
16699
+ "cost_per_thruplay": {
16700
+ "description": "The average cost for each ThruPlay. This metric is in development.",
16701
+ "type": "list<AdsActionStats>"
16702
+ },
16703
+ "cost_per_unique_action_type": {
16704
+ "description": "The average cost of each unique action. This metric is estimated.",
16705
+ "type": "list<AdsActionStats>"
16706
+ },
16707
+ "cost_per_unique_click": {
16708
+ "description": "The average cost for each unique click (all). This metric is estimated.",
16709
+ "type": "numeric string",
16710
+ "GoogleBigQueryType": "numeric"
16711
+ },
16712
+ "cost_per_unique_conversion": {
16713
+ "description": "cost_per_unique_conversion",
16714
+ "type": "list<AdsActionStats>"
16715
+ },
16716
+ "cost_per_unique_inline_link_click": {
16717
+ "description": "The average cost of each unique inline link click. This metric is estimated.",
16718
+ "type": "numeric string",
16719
+ "GoogleBigQueryType": "numeric"
16720
+ },
16721
+ "cost_per_unique_outbound_click": {
16722
+ "description": "The average cost for each unique outbound click. This metric is estimated.",
16723
+ "type": "list<AdsActionStats>"
16724
+ },
16725
+ "cpc": {
16726
+ "description": "The average cost for each click (all).",
16727
+ "type": "numeric string",
16728
+ "GoogleBigQueryType": "numeric"
16729
+ },
16730
+ "cpm": {
16731
+ "description": "The average cost for 1,000 impressions.",
16732
+ "type": "numeric string",
16733
+ "GoogleBigQueryType": "numeric"
16734
+ },
16735
+ "cpp": {
16736
+ "description": "The average cost to reach 1,000 people. This metric is estimated.",
16737
+ "type": "numeric string",
16738
+ "GoogleBigQueryType": "numeric"
16739
+ },
16740
+ "created_time": {
16741
+ "description": "created_time",
16742
+ "type": "string"
16743
+ },
16744
+ "ctr": {
16745
+ "description": "The percentage of times people saw your ad and performed a click (all).",
16746
+ "type": "numeric string",
16747
+ "GoogleBigQueryType": "numeric"
16748
+ },
16749
+ "date_start": {
16750
+ "description": "The start date for your data. This is controlled by the date range you've selected for your reporting view.",
16751
+ "type": "string",
16752
+ "GoogleBigQueryType": "date",
16753
+ "GoogleBigQueryPartitioned": true
16754
+ },
16755
+ "date_stop": {
16756
+ "description": "The end date for your data. This is controlled by the date range you've selected for your reporting view.",
16757
+ "type": "string",
16758
+ "GoogleBigQueryType": "date"
16759
+ },
16760
+ "dda_countby_convs": {
16761
+ "description": "dda_countby_convs",
16762
+ "type": "numeric string",
16763
+ "GoogleBigQueryType": "numeric"
16764
+ },
16765
+ "dda_results": {
16766
+ "description": "dda_results",
16767
+ "type": "list<AdsInsightsDdaResult>"
16768
+ },
16769
+ "frequency": {
16770
+ "description": "The average number of times each person saw your ad. This metric is estimated.",
16771
+ "type": "numeric string",
16772
+ "GoogleBigQueryType": "numeric"
16773
+ },
16774
+ "full_view_impressions": {
16775
+ "description": "The number of Full Views on your Page's posts as a result of your ad.",
16776
+ "type": "numeric string",
16777
+ "GoogleBigQueryType": "numeric"
16778
+ },
16779
+ "full_view_reach": {
16780
+ "description": "The number of people who performed a Full View on your Page's post as a result of your ad.",
16781
+ "type": "numeric string",
16782
+ "GoogleBigQueryType": "numeric"
16783
+ },
16784
+ "impressions": {
16785
+ "description": "The number of times your ads were on screen.",
16786
+ "type": "numeric string",
16787
+ "GoogleBigQueryType": "numeric"
16788
+ },
16789
+ "inline_link_click_ctr": {
16790
+ "description": "The percentage of time people saw your ads and performed an inline link click.",
16791
+ "type": "numeric string",
16792
+ "GoogleBigQueryType": "numeric"
16793
+ },
16794
+ "inline_link_clicks": {
16795
+ "description": "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.",
16796
+ "type": "numeric string",
16797
+ "GoogleBigQueryType": "numeric"
16798
+ },
16799
+ "inline_post_engagement": {
16800
+ "description": "The total number of actions that people take involving your ads. Inline post engagements use a fixed 1-day-click attribution window.",
16801
+ "type": "numeric string",
16802
+ "GoogleBigQueryType": "numeric"
16803
+ },
16804
+ "instagram_upcoming_event_reminders_set": {
16805
+ "description": "instagram_upcoming_event_reminders_set",
16806
+ "type": "numeric string",
16807
+ "GoogleBigQueryType": "numeric"
16808
+ },
16809
+ "instant_experience_clicks_to_open": {
16810
+ "description": "instant_experience_clicks_to_open",
16811
+ "type": "numeric string",
16812
+ "GoogleBigQueryType": "numeric"
16813
+ },
16814
+ "instant_experience_clicks_to_start": {
16815
+ "description": "instant_experience_clicks_to_start",
16816
+ "type": "numeric string",
16817
+ "GoogleBigQueryType": "numeric"
16818
+ },
16819
+ "instant_experience_outbound_clicks": {
16820
+ "description": "instant_experience_outbound_clicks",
16821
+ "type": "list<AdsActionStats>"
16822
+ },
16823
+ "interactive_component_tap": {
16824
+ "description": "interactive_component_tap",
16825
+ "type": "list<AdsActionStats>"
16826
+ },
16827
+ "marketing_messages_delivery_rate": {
16828
+ "description": "The number of messages delivered divided by the number of messages sent. Some messages may not be delivered, such as when a customer's device is out of service. This metric doesn't include messages sent to Europe and Japan.",
16829
+ "type": "numeric string",
16830
+ "GoogleBigQueryType": "numeric"
16831
+ },
16832
+ "mobile_app_purchase_roas": {
16833
+ "description": "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.",
16834
+ "type": "list<AdsActionStats>"
16835
+ },
16836
+ "objective": {
16837
+ "description": "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.",
16838
+ "type": "string"
16839
+ },
16840
+ "optimization_goal": {
16841
+ "description": "The optimization goal you selected for your ad or ad set. Your optimization goal reflects what you want to optimize for the ads.",
16842
+ "type": "string"
16843
+ },
16844
+ "outbound_clicks": {
16845
+ "description": "The number of clicks on links that take people off Facebook-owned properties.",
16846
+ "type": "list<AdsActionStats>"
16847
+ },
16848
+ "outbound_clicks_ctr": {
16849
+ "description": "The percentage of times people saw your ad and performed an outbound click.",
16850
+ "type": "list<AdsActionStats>"
16851
+ },
16852
+ "purchase_roas": {
16853
+ "description": "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.",
16854
+ "type": "list<AdsActionStats>"
16855
+ },
16856
+ "qualifying_question_qualify_answer_rate": {
16857
+ "description": "qualifying_question_qualify_answer_rate",
16858
+ "type": "numeric string",
16859
+ "GoogleBigQueryType": "numeric"
16860
+ },
16861
+ "reach": {
16862
+ "description": "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.",
16863
+ "type": "numeric string",
16864
+ "GoogleBigQueryType": "numeric"
16865
+ },
16866
+ "shops_assisted_purchases": {
16867
+ "description": "shops_assisted_purchases",
16868
+ "type": "string"
16869
+ },
16870
+ "social_spend": {
16871
+ "description": "The total amount you've spent so far for your ads showed with social information. (ex: Jane Doe likes this).",
16872
+ "type": "numeric string",
16873
+ "GoogleBigQueryType": "numeric"
16874
+ },
16875
+ "spend": {
16876
+ "description": "The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated.",
16877
+ "type": "numeric string",
16878
+ "GoogleSheetsFormat": "$#,##0.00",
16879
+ "GoogleBigQueryType": "numeric"
16880
+ },
16881
+ "updated_time": {
16882
+ "description": "updated_time",
16883
+ "type": "string"
16884
+ },
16885
+ "video_30_sec_watched_actions": {
16886
+ "description": "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.",
16887
+ "type": "list<AdsActionStats>"
16888
+ },
16889
+ "video_avg_time_watched_actions": {
16890
+ "description": "The average time a video was played, including any time spent replaying the video for a single impression.",
16891
+ "type": "list<AdsActionStats>"
16892
+ },
16893
+ "video_continuous_2_sec_watched_actions": {
16894
+ "description": "video_continuous_2_sec_watched_actions",
16895
+ "type": "list<AdsActionStats>"
16896
+ },
16897
+ "video_p100_watched_actions": {
16898
+ "description": "The number of times your video was played at 100% of its length, including plays that skipped to this point.",
16899
+ "type": "list<AdsActionStats>"
16900
+ },
16901
+ "video_p25_watched_actions": {
16902
+ "description": "The number of times your video was played at 25% of its length, including plays that skipped to this point.",
16903
+ "type": "list<AdsActionStats>"
16904
+ },
16905
+ "video_p50_watched_actions": {
16906
+ "description": "The number of times your video was played at 50% of its length, including plays that skipped to this point.",
16907
+ "type": "list<AdsActionStats>"
16908
+ },
16909
+ "video_p75_watched_actions": {
16910
+ "description": "The number of times your video was played at 75% of its length, including plays that skipped to this point.",
16911
+ "type": "list<AdsActionStats>"
16912
+ },
16913
+ "video_p95_watched_actions": {
16914
+ "description": "The number of times your video was played at 95% of its length, including plays that skipped to this point.",
16915
+ "type": "list<AdsActionStats>"
16916
+ },
16917
+ "video_play_actions": {
16918
+ "description": "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.",
16919
+ "type": "list<AdsActionStats>"
16920
+ },
16921
+ "video_play_curve_actions": {
16922
+ "description": "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.",
16923
+ "type": "list<AdsHistogramStats>"
16924
+ },
16925
+ "video_play_retention_0_to_15s_actions": {
16926
+ "description": "video_play_retention_0_to_15s_actions",
16927
+ "type": "list<AdsHistogramStats>"
16928
+ },
16929
+ "video_play_retention_20_to_60s_actions": {
16930
+ "description": "video_play_retention_20_to_60s_actions",
16931
+ "type": "list<AdsHistogramStats>"
16932
+ },
16933
+ "video_play_retention_graph_actions": {
16934
+ "description": "video_play_retention_graph_actions",
16935
+ "type": "list<AdsHistogramStats>"
16936
+ },
16937
+ "video_time_watched_actions": {
16938
+ "description": "video_time_watched_actions",
16939
+ "type": "list<AdsActionStats>"
16940
+ },
16941
+ "website_ctr": {
16942
+ "description": "The percentage of times people saw your ad and performed a link click.",
16943
+ "type": "list<AdsActionStats>"
16944
+ },
16945
+ "website_purchase_roas": {
16946
+ "description": "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.",
16947
+ "type": "list<AdsActionStats>"
16948
+ },
16949
+ "wish_bid": {
16950
+ "description": "wish_bid",
16951
+ "type": "numeric string",
16952
+ "GoogleBigQueryType": "numeric"
16953
+ }
16954
+ };
16955
+ var adAccountInsightsFieldsByRegion = {
16956
+ "account_currency": {
16957
+ "description": "Currency that is used by your ad account.",
16958
+ "type": "string"
16959
+ },
16960
+ "account_id": {
16961
+ "description": "The ID number of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.",
16962
+ "type": "numeric string",
16963
+ "GoogleSheetsFormat": "@"
16964
+ },
16965
+ "account_name": {
16966
+ "description": "The name of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.",
16967
+ "type": "string"
16968
+ },
16969
+ "action_values": {
16970
+ "description": "The total value of all conversions attributed to your ads.",
16971
+ "type": "list<AdsActionStats>"
16972
+ },
16973
+ "actions": {
16974
+ "description": "The total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions.",
16975
+ "type": "list<AdsActionStats>"
16976
+ },
16977
+ "ad_click_actions": {
16978
+ "description": "ad_click_actions",
16979
+ "type": "list<AdsActionStats>"
16980
+ },
16981
+ "ad_id": {
16982
+ "description": "The unique ID of the ad you're viewing in reporting.",
16983
+ "type": "numeric string",
16984
+ "GoogleSheetsFormat": "@"
16985
+ },
16986
+ "ad_impression_actions": {
16987
+ "description": "ad_impression_actions",
16988
+ "type": "list<AdsActionStats>"
16989
+ },
16990
+ "ad_name": {
16991
+ "description": "The name of the ad you're viewing in reporting.",
16992
+ "type": "string"
16993
+ },
16994
+ "adset_id": {
16995
+ "description": "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.",
16996
+ "type": "numeric string",
16997
+ "GoogleSheetsFormat": "@"
16998
+ },
16999
+ "adset_name": {
17000
+ "description": "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.",
17001
+ "type": "string"
17002
+ },
17003
+ "attribution_setting": {
17004
+ "description": "The default attribution window to be used when attribution result is calculated. Each ad set has its own attribution setting value. The attribution setting for campaign or account is calculated based on existing ad sets.",
17005
+ "type": "string"
17006
+ },
17007
+ "auction_bid": {
17008
+ "description": "auction_bid",
17009
+ "type": "numeric string",
17010
+ "GoogleBigQueryType": "numeric"
17011
+ },
17012
+ "auction_competitiveness": {
17013
+ "description": "auction_competitiveness",
17014
+ "type": "numeric string",
17015
+ "GoogleBigQueryType": "numeric"
17016
+ },
17017
+ "auction_max_competitor_bid": {
17018
+ "description": "auction_max_competitor_bid",
17019
+ "type": "numeric string",
17020
+ "GoogleBigQueryType": "numeric"
17021
+ },
17022
+ "buying_type": {
17023
+ "description": "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.",
17024
+ "type": "string"
17025
+ },
17026
+ "campaign_id": {
17027
+ "description": "The unique ID number of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.",
17028
+ "type": "numeric string",
17029
+ "GoogleSheetsFormat": "@"
17030
+ },
17031
+ "campaign_name": {
17032
+ "description": "The name of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.",
17033
+ "type": "string"
17034
+ },
17035
+ "canvas_avg_view_percent": {
17036
+ "description": "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.",
17037
+ "type": "numeric string",
17038
+ "GoogleBigQueryType": "numeric"
17039
+ },
17040
+ "canvas_avg_view_time": {
17041
+ "description": "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.",
17042
+ "type": "numeric string",
17043
+ "GoogleBigQueryType": "numeric"
17044
+ },
17045
+ "catalog_segment_actions": {
17046
+ "description": "The number of actions performed attributed to your ads promoting your catalog segment, broken down by action type.",
17047
+ "type": "list<AdsActionStats>"
17048
+ },
17049
+ "catalog_segment_value": {
17050
+ "description": "The total value of all conversions from your catalog segment attributed to your ads.",
17051
+ "type": "list<AdsActionStats>"
17052
+ },
17053
+ "catalog_segment_value_mobile_purchase_roas": {
17054
+ "description": "The total return on ad spend (ROAS) from mobile app purchases for your catalog segment.",
17055
+ "type": "list<AdsActionStats>"
17056
+ },
17057
+ "catalog_segment_value_omni_purchase_roas": {
17058
+ "description": "The total return on ad spend (ROAS) from all purchases for your catalog segment.",
17059
+ "type": "list<AdsActionStats>"
17060
+ },
17061
+ "catalog_segment_value_website_purchase_roas": {
17062
+ "description": "The total return on ad spend (ROAS) from website purchases for your catalog segment.",
17063
+ "type": "list<AdsActionStats>"
17064
+ },
17065
+ "clicks": {
17066
+ "description": "The number of clicks on your ads.",
17067
+ "type": "numeric string",
17068
+ "GoogleBigQueryType": "numeric"
17069
+ },
17070
+ "conversion_values": {
17071
+ "description": "conversion_values",
17072
+ "type": "list<AdsActionStats>"
17073
+ },
17074
+ "conversions": {
17075
+ "description": "conversions",
17076
+ "type": "list<AdsActionStats>"
17077
+ },
17078
+ "converted_product_quantity": {
17079
+ "description": "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.",
17080
+ "type": "list<AdsActionStats>"
17081
+ },
17082
+ "converted_product_value": {
17083
+ "description": "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.",
17084
+ "type": "list<AdsActionStats>"
17085
+ },
17086
+ "cost_per_15_sec_video_view": {
17087
+ "description": "cost_per_15_sec_video_view",
17088
+ "type": "list<AdsActionStats>"
17089
+ },
17090
+ "cost_per_2_sec_continuous_video_view": {
17091
+ "description": "cost_per_2_sec_continuous_video_view",
17092
+ "type": "list<AdsActionStats>"
17093
+ },
17094
+ "cost_per_action_type": {
17095
+ "description": "The average cost of a relevant action.",
17096
+ "type": "list<AdsActionStats>"
17097
+ },
17098
+ "cost_per_ad_click": {
17099
+ "description": "cost_per_ad_click",
17100
+ "type": "list<AdsActionStats>"
17101
+ },
17102
+ "cost_per_conversion": {
17103
+ "description": "cost_per_conversion",
17104
+ "type": "list<AdsActionStats>"
17105
+ },
17106
+ "cost_per_dda_countby_convs": {
17107
+ "description": "cost_per_dda_countby_convs",
17108
+ "type": "numeric string",
17109
+ "GoogleBigQueryType": "numeric"
17110
+ },
17111
+ "cost_per_inline_link_click": {
17112
+ "description": "The average cost of each inline link click.",
17113
+ "type": "numeric string",
17114
+ "GoogleBigQueryType": "numeric"
17115
+ },
17116
+ "cost_per_inline_post_engagement": {
17117
+ "description": "The average cost of each inline post engagement.",
17118
+ "type": "numeric string",
17119
+ "GoogleBigQueryType": "numeric"
17120
+ },
17121
+ "cost_per_one_thousand_ad_impression": {
17122
+ "description": "cost_per_one_thousand_ad_impression",
17123
+ "type": "list<AdsActionStats>"
17124
+ },
17125
+ "cost_per_outbound_click": {
17126
+ "description": "The average cost for each outbound click.",
17127
+ "type": "list<AdsActionStats>"
17128
+ },
17129
+ "cost_per_thruplay": {
17130
+ "description": "The average cost for each ThruPlay. This metric is in development.",
17131
+ "type": "list<AdsActionStats>"
17132
+ },
17133
+ "cost_per_unique_action_type": {
17134
+ "description": "The average cost of each unique action. This metric is estimated.",
17135
+ "type": "list<AdsActionStats>"
17136
+ },
17137
+ "cost_per_unique_click": {
17138
+ "description": "The average cost for each unique click (all). This metric is estimated.",
17139
+ "type": "numeric string",
17140
+ "GoogleBigQueryType": "numeric"
17141
+ },
17142
+ "cost_per_unique_conversion": {
17143
+ "description": "cost_per_unique_conversion",
17144
+ "type": "list<AdsActionStats>"
17145
+ },
17146
+ "cost_per_unique_inline_link_click": {
17147
+ "description": "The average cost of each unique inline link click. This metric is estimated.",
17148
+ "type": "numeric string",
17149
+ "GoogleBigQueryType": "numeric"
17150
+ },
17151
+ "cost_per_unique_outbound_click": {
17152
+ "description": "The average cost for each unique outbound click. This metric is estimated.",
17153
+ "type": "list<AdsActionStats>"
17154
+ },
17155
+ "cpc": {
17156
+ "description": "The average cost for each click (all).",
17157
+ "type": "numeric string",
17158
+ "GoogleBigQueryType": "numeric"
17159
+ },
17160
+ "cpm": {
17161
+ "description": "The average cost for 1,000 impressions.",
17162
+ "type": "numeric string",
17163
+ "GoogleBigQueryType": "numeric"
17164
+ },
17165
+ "cpp": {
17166
+ "description": "The average cost to reach 1,000 people. This metric is estimated.",
17167
+ "type": "numeric string",
17168
+ "GoogleBigQueryType": "numeric"
17169
+ },
17170
+ "created_time": {
17171
+ "description": "created_time",
17172
+ "type": "string"
17173
+ },
17174
+ "ctr": {
17175
+ "description": "The percentage of times people saw your ad and performed a click (all).",
17176
+ "type": "numeric string",
17177
+ "GoogleBigQueryType": "numeric"
17178
+ },
17179
+ "date_start": {
17180
+ "description": "The start date for your data. This is controlled by the date range you've selected for your reporting view.",
17181
+ "type": "string",
17182
+ "GoogleBigQueryType": "date",
17183
+ "GoogleBigQueryPartitioned": true
17184
+ },
17185
+ "date_stop": {
17186
+ "description": "The end date for your data. This is controlled by the date range you've selected for your reporting view.",
17187
+ "type": "string",
17188
+ "GoogleBigQueryType": "date"
17189
+ },
17190
+ "dda_countby_convs": {
17191
+ "description": "dda_countby_convs",
17192
+ "type": "numeric string",
17193
+ "GoogleBigQueryType": "numeric"
17194
+ },
17195
+ "dda_results": {
17196
+ "description": "dda_results",
17197
+ "type": "list<AdsInsightsDdaResult>"
17198
+ },
17199
+ "frequency": {
17200
+ "description": "The average number of times each person saw your ad. This metric is estimated.",
17201
+ "type": "numeric string",
17202
+ "GoogleBigQueryType": "numeric"
17203
+ },
17204
+ "full_view_impressions": {
17205
+ "description": "The number of Full Views on your Page's posts as a result of your ad.",
17206
+ "type": "numeric string",
17207
+ "GoogleBigQueryType": "numeric"
17208
+ },
17209
+ "full_view_reach": {
17210
+ "description": "The number of people who performed a Full View on your Page's post as a result of your ad.",
17211
+ "type": "numeric string",
17212
+ "GoogleBigQueryType": "numeric"
17213
+ },
17214
+ "impressions": {
17215
+ "description": "The number of times your ads were on screen.",
17216
+ "type": "numeric string",
17217
+ "GoogleBigQueryType": "numeric"
17218
+ },
17219
+ "inline_link_click_ctr": {
17220
+ "description": "The percentage of time people saw your ads and performed an inline link click.",
17221
+ "type": "numeric string",
17222
+ "GoogleBigQueryType": "numeric"
17223
+ },
17224
+ "inline_link_clicks": {
17225
+ "description": "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.",
17226
+ "type": "numeric string",
17227
+ "GoogleBigQueryType": "numeric"
17228
+ },
17229
+ "inline_post_engagement": {
17230
+ "description": "The total number of actions that people take involving your ads. Inline post engagements use a fixed 1-day-click attribution window.",
17231
+ "type": "numeric string",
17232
+ "GoogleBigQueryType": "numeric"
17233
+ },
17234
+ "instagram_upcoming_event_reminders_set": {
17235
+ "description": "instagram_upcoming_event_reminders_set",
17236
+ "type": "numeric string",
17237
+ "GoogleBigQueryType": "numeric"
17238
+ },
17239
+ "instant_experience_clicks_to_open": {
17240
+ "description": "instant_experience_clicks_to_open",
17241
+ "type": "numeric string",
17242
+ "GoogleBigQueryType": "numeric"
17243
+ },
17244
+ "instant_experience_clicks_to_start": {
17245
+ "description": "instant_experience_clicks_to_start",
17246
+ "type": "numeric string",
17247
+ "GoogleBigQueryType": "numeric"
17248
+ },
17249
+ "instant_experience_outbound_clicks": {
17250
+ "description": "instant_experience_outbound_clicks",
17251
+ "type": "list<AdsActionStats>"
17252
+ },
17253
+ "interactive_component_tap": {
17254
+ "description": "interactive_component_tap",
17255
+ "type": "list<AdsActionStats>"
17256
+ },
17257
+ "marketing_messages_delivery_rate": {
17258
+ "description": "The number of messages delivered divided by the number of messages sent. Some messages may not be delivered, such as when a customer's device is out of service. This metric doesn't include messages sent to Europe and Japan.",
17259
+ "type": "numeric string",
17260
+ "GoogleBigQueryType": "numeric"
17261
+ },
17262
+ "mobile_app_purchase_roas": {
17263
+ "description": "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.",
17264
+ "type": "list<AdsActionStats>"
17265
+ },
17266
+ "objective": {
17267
+ "description": "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.",
17268
+ "type": "string"
17269
+ },
17270
+ "optimization_goal": {
17271
+ "description": "The optimization goal you selected for your ad or ad set. Your optimization goal reflects what you want to optimize for the ads.",
17272
+ "type": "string"
17273
+ },
17274
+ "outbound_clicks": {
17275
+ "description": "The number of clicks on links that take people off Facebook-owned properties.",
17276
+ "type": "list<AdsActionStats>"
17277
+ },
17278
+ "outbound_clicks_ctr": {
17279
+ "description": "The percentage of times people saw your ad and performed an outbound click.",
17280
+ "type": "list<AdsActionStats>"
17281
+ },
17282
+ "purchase_roas": {
17283
+ "description": "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.",
17284
+ "type": "list<AdsActionStats>"
17285
+ },
17286
+ "qualifying_question_qualify_answer_rate": {
17287
+ "description": "qualifying_question_qualify_answer_rate",
17288
+ "type": "numeric string",
17289
+ "GoogleBigQueryType": "numeric"
17290
+ },
17291
+ "reach": {
17292
+ "description": "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.",
17293
+ "type": "numeric string",
17294
+ "GoogleBigQueryType": "numeric"
17295
+ },
17296
+ "region": {
17297
+ "description": "The region where your ads were shown.",
17298
+ "type": "string"
17299
+ },
17300
+ "shops_assisted_purchases": {
17301
+ "description": "shops_assisted_purchases",
17302
+ "type": "string"
17303
+ },
17304
+ "social_spend": {
17305
+ "description": "The total amount you've spent so far for your ads showed with social information. (ex: Jane Doe likes this).",
17306
+ "type": "numeric string",
17307
+ "GoogleBigQueryType": "numeric"
17308
+ },
17309
+ "spend": {
17310
+ "description": "The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated.",
17311
+ "type": "numeric string",
17312
+ "GoogleSheetsFormat": "$#,##0.00",
17313
+ "GoogleBigQueryType": "numeric"
17314
+ },
17315
+ "updated_time": {
17316
+ "description": "updated_time",
17317
+ "type": "string"
17318
+ },
17319
+ "video_30_sec_watched_actions": {
17320
+ "description": "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.",
17321
+ "type": "list<AdsActionStats>"
17322
+ },
17323
+ "video_avg_time_watched_actions": {
17324
+ "description": "The average time a video was played, including any time spent replaying the video for a single impression.",
17325
+ "type": "list<AdsActionStats>"
17326
+ },
17327
+ "video_continuous_2_sec_watched_actions": {
17328
+ "description": "video_continuous_2_sec_watched_actions",
17329
+ "type": "list<AdsActionStats>"
17330
+ },
17331
+ "video_p100_watched_actions": {
17332
+ "description": "The number of times your video was played at 100% of its length, including plays that skipped to this point.",
17333
+ "type": "list<AdsActionStats>"
17334
+ },
17335
+ "video_p25_watched_actions": {
17336
+ "description": "The number of times your video was played at 25% of its length, including plays that skipped to this point.",
17337
+ "type": "list<AdsActionStats>"
17338
+ },
17339
+ "video_p50_watched_actions": {
17340
+ "description": "The number of times your video was played at 50% of its length, including plays that skipped to this point.",
17341
+ "type": "list<AdsActionStats>"
17342
+ },
17343
+ "video_p75_watched_actions": {
17344
+ "description": "The number of times your video was played at 75% of its length, including plays that skipped to this point.",
17345
+ "type": "list<AdsActionStats>"
17346
+ },
17347
+ "video_p95_watched_actions": {
17348
+ "description": "The number of times your video was played at 95% of its length, including plays that skipped to this point.",
17349
+ "type": "list<AdsActionStats>"
17350
+ },
17351
+ "video_play_actions": {
17352
+ "description": "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.",
17353
+ "type": "list<AdsActionStats>"
17354
+ },
17355
+ "video_play_curve_actions": {
17356
+ "description": "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.",
17357
+ "type": "list<AdsHistogramStats>"
17358
+ },
17359
+ "video_play_retention_0_to_15s_actions": {
17360
+ "description": "video_play_retention_0_to_15s_actions",
17361
+ "type": "list<AdsHistogramStats>"
17362
+ },
17363
+ "video_play_retention_20_to_60s_actions": {
17364
+ "description": "video_play_retention_20_to_60s_actions",
17365
+ "type": "list<AdsHistogramStats>"
17366
+ },
17367
+ "video_play_retention_graph_actions": {
17368
+ "description": "video_play_retention_graph_actions",
17369
+ "type": "list<AdsHistogramStats>"
17370
+ },
17371
+ "video_time_watched_actions": {
17372
+ "description": "video_time_watched_actions",
17373
+ "type": "list<AdsActionStats>"
17374
+ },
17375
+ "website_ctr": {
17376
+ "description": "The percentage of times people saw your ad and performed a link click.",
17377
+ "type": "list<AdsActionStats>"
17378
+ },
17379
+ "website_purchase_roas": {
17380
+ "description": "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.",
17381
+ "type": "list<AdsActionStats>"
17382
+ },
17383
+ "wish_bid": {
17384
+ "description": "wish_bid",
17385
+ "type": "numeric string",
17386
+ "GoogleBigQueryType": "numeric"
17387
+ }
17388
+ };
17389
+ var adAccountInsightsFieldsByPublisherPlatformAndPosition = {
17390
+ "account_currency": {
17391
+ "description": "Currency that is used by your ad account.",
17392
+ "type": "string"
17393
+ },
17394
+ "account_id": {
17395
+ "description": "The ID number of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.",
17396
+ "type": "numeric string",
17397
+ "GoogleSheetsFormat": "@"
17398
+ },
17399
+ "account_name": {
17400
+ "description": "The name of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.",
17401
+ "type": "string"
17402
+ },
17403
+ "action_values": {
17404
+ "description": "The total value of all conversions attributed to your ads.",
17405
+ "type": "list<AdsActionStats>"
17406
+ },
17407
+ "actions": {
17408
+ "description": "The total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions.",
17409
+ "type": "list<AdsActionStats>"
17410
+ },
17411
+ "ad_click_actions": {
17412
+ "description": "ad_click_actions",
17413
+ "type": "list<AdsActionStats>"
17414
+ },
17415
+ "ad_id": {
17416
+ "description": "The unique ID of the ad you're viewing in reporting.",
17417
+ "type": "numeric string",
17418
+ "GoogleSheetsFormat": "@"
17419
+ },
17420
+ "ad_impression_actions": {
17421
+ "description": "ad_impression_actions",
17422
+ "type": "list<AdsActionStats>"
17423
+ },
17424
+ "ad_name": {
17425
+ "description": "The name of the ad you're viewing in reporting.",
17426
+ "type": "string"
17427
+ },
17428
+ "adset_id": {
17429
+ "description": "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.",
17430
+ "type": "numeric string",
17431
+ "GoogleSheetsFormat": "@"
17432
+ },
17433
+ "adset_name": {
17434
+ "description": "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.",
17435
+ "type": "string"
17436
+ },
17437
+ "attribution_setting": {
17438
+ "description": "The default attribution window to be used when attribution result is calculated. Each ad set has its own attribution setting value. The attribution setting for campaign or account is calculated based on existing ad sets.",
17439
+ "type": "string"
17440
+ },
17441
+ "auction_bid": {
17442
+ "description": "auction_bid",
17443
+ "type": "numeric string",
17444
+ "GoogleBigQueryType": "numeric"
17445
+ },
17446
+ "auction_competitiveness": {
17447
+ "description": "auction_competitiveness",
17448
+ "type": "numeric string",
17449
+ "GoogleBigQueryType": "numeric"
17450
+ },
17451
+ "auction_max_competitor_bid": {
17452
+ "description": "auction_max_competitor_bid",
17453
+ "type": "numeric string",
17454
+ "GoogleBigQueryType": "numeric"
17455
+ },
17456
+ "buying_type": {
17457
+ "description": "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.",
17458
+ "type": "string"
17459
+ },
17460
+ "campaign_id": {
17461
+ "description": "The unique ID number of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.",
17462
+ "type": "numeric string",
17463
+ "GoogleSheetsFormat": "@"
17464
+ },
17465
+ "campaign_name": {
17466
+ "description": "The name of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.",
17467
+ "type": "string"
17468
+ },
17469
+ "canvas_avg_view_percent": {
17470
+ "description": "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.",
17471
+ "type": "numeric string",
17472
+ "GoogleBigQueryType": "numeric"
17473
+ },
17474
+ "canvas_avg_view_time": {
17475
+ "description": "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.",
17476
+ "type": "numeric string",
17477
+ "GoogleBigQueryType": "numeric"
17478
+ },
17479
+ "catalog_segment_actions": {
17480
+ "description": "The number of actions performed attributed to your ads promoting your catalog segment, broken down by action type.",
17481
+ "type": "list<AdsActionStats>"
17482
+ },
17483
+ "catalog_segment_value": {
17484
+ "description": "The total value of all conversions from your catalog segment attributed to your ads.",
17485
+ "type": "list<AdsActionStats>"
17486
+ },
17487
+ "catalog_segment_value_mobile_purchase_roas": {
17488
+ "description": "The total return on ad spend (ROAS) from mobile app purchases for your catalog segment.",
17489
+ "type": "list<AdsActionStats>"
17490
+ },
17491
+ "catalog_segment_value_omni_purchase_roas": {
17492
+ "description": "The total return on ad spend (ROAS) from all purchases for your catalog segment.",
17493
+ "type": "list<AdsActionStats>"
17494
+ },
17495
+ "catalog_segment_value_website_purchase_roas": {
17496
+ "description": "The total return on ad spend (ROAS) from website purchases for your catalog segment.",
17497
+ "type": "list<AdsActionStats>"
17498
+ },
17499
+ "clicks": {
17500
+ "description": "The number of clicks on your ads.",
17501
+ "type": "numeric string",
17502
+ "GoogleBigQueryType": "numeric"
17503
+ },
17504
+ "conversion_values": {
17505
+ "description": "conversion_values",
17506
+ "type": "list<AdsActionStats>"
17507
+ },
17508
+ "conversions": {
17509
+ "description": "conversions",
17510
+ "type": "list<AdsActionStats>"
17511
+ },
17512
+ "converted_product_quantity": {
17513
+ "description": "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.",
17514
+ "type": "list<AdsActionStats>"
17515
+ },
17516
+ "converted_product_value": {
17517
+ "description": "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.",
17518
+ "type": "list<AdsActionStats>"
17519
+ },
17520
+ "cost_per_15_sec_video_view": {
17521
+ "description": "cost_per_15_sec_video_view",
17522
+ "type": "list<AdsActionStats>"
17523
+ },
17524
+ "cost_per_2_sec_continuous_video_view": {
17525
+ "description": "cost_per_2_sec_continuous_video_view",
17526
+ "type": "list<AdsActionStats>"
17527
+ },
17528
+ "cost_per_action_type": {
17529
+ "description": "The average cost of a relevant action.",
17530
+ "type": "list<AdsActionStats>"
17531
+ },
17532
+ "cost_per_ad_click": {
17533
+ "description": "cost_per_ad_click",
17534
+ "type": "list<AdsActionStats>"
17535
+ },
17536
+ "cost_per_conversion": {
17537
+ "description": "cost_per_conversion",
17538
+ "type": "list<AdsActionStats>"
17539
+ },
17540
+ "cost_per_dda_countby_convs": {
17541
+ "description": "cost_per_dda_countby_convs",
17542
+ "type": "numeric string",
17543
+ "GoogleBigQueryType": "numeric"
17544
+ },
17545
+ "cost_per_inline_link_click": {
17546
+ "description": "The average cost of each inline link click.",
17547
+ "type": "numeric string",
17548
+ "GoogleBigQueryType": "numeric"
17549
+ },
17550
+ "cost_per_inline_post_engagement": {
17551
+ "description": "The average cost of each inline post engagement.",
17552
+ "type": "numeric string",
17553
+ "GoogleBigQueryType": "numeric"
17554
+ },
17555
+ "cost_per_one_thousand_ad_impression": {
17556
+ "description": "cost_per_one_thousand_ad_impression",
17557
+ "type": "list<AdsActionStats>"
17558
+ },
17559
+ "cost_per_outbound_click": {
17560
+ "description": "The average cost for each outbound click.",
17561
+ "type": "list<AdsActionStats>"
17562
+ },
17563
+ "cost_per_thruplay": {
17564
+ "description": "The average cost for each ThruPlay. This metric is in development.",
17565
+ "type": "list<AdsActionStats>"
17566
+ },
17567
+ "cost_per_unique_action_type": {
17568
+ "description": "The average cost of each unique action. This metric is estimated.",
17569
+ "type": "list<AdsActionStats>"
17570
+ },
17571
+ "cost_per_unique_click": {
17572
+ "description": "The average cost for each unique click (all). This metric is estimated.",
17573
+ "type": "numeric string",
17574
+ "GoogleBigQueryType": "numeric"
17575
+ },
17576
+ "cost_per_unique_conversion": {
17577
+ "description": "cost_per_unique_conversion",
17578
+ "type": "list<AdsActionStats>"
17579
+ },
17580
+ "cost_per_unique_inline_link_click": {
17581
+ "description": "The average cost of each unique inline link click. This metric is estimated.",
17582
+ "type": "numeric string",
17583
+ "GoogleBigQueryType": "numeric"
17584
+ },
17585
+ "cost_per_unique_outbound_click": {
17586
+ "description": "The average cost for each unique outbound click. This metric is estimated.",
17587
+ "type": "list<AdsActionStats>"
17588
+ },
17589
+ "cpc": {
17590
+ "description": "The average cost for each click (all).",
17591
+ "type": "numeric string",
17592
+ "GoogleBigQueryType": "numeric"
17593
+ },
17594
+ "cpm": {
17595
+ "description": "The average cost for 1,000 impressions.",
17596
+ "type": "numeric string",
17597
+ "GoogleBigQueryType": "numeric"
17598
+ },
17599
+ "cpp": {
17600
+ "description": "The average cost to reach 1,000 people. This metric is estimated.",
17601
+ "type": "numeric string",
17602
+ "GoogleBigQueryType": "numeric"
17603
+ },
17604
+ "created_time": {
17605
+ "description": "created_time",
17606
+ "type": "string"
17607
+ },
17608
+ "ctr": {
17609
+ "description": "The percentage of times people saw your ad and performed a click (all).",
17610
+ "type": "numeric string",
17611
+ "GoogleBigQueryType": "numeric"
17612
+ },
17613
+ "date_start": {
17614
+ "description": "The start date for your data. This is controlled by the date range you've selected for your reporting view.",
17615
+ "type": "string",
17616
+ "GoogleBigQueryType": "date",
17617
+ "GoogleBigQueryPartitioned": true
17618
+ },
17619
+ "date_stop": {
17620
+ "description": "The end date for your data. This is controlled by the date range you've selected for your reporting view.",
17621
+ "type": "string",
17622
+ "GoogleBigQueryType": "date"
17623
+ },
17624
+ "dda_countby_convs": {
17625
+ "description": "dda_countby_convs",
17626
+ "type": "numeric string",
17627
+ "GoogleBigQueryType": "numeric"
17628
+ },
17629
+ "dda_results": {
17630
+ "description": "dda_results",
17631
+ "type": "list<AdsInsightsDdaResult>"
17632
+ },
17633
+ "frequency": {
17634
+ "description": "The average number of times each person saw your ad. This metric is estimated.",
17635
+ "type": "numeric string",
17636
+ "GoogleBigQueryType": "numeric"
17637
+ },
17638
+ "full_view_impressions": {
17639
+ "description": "The number of Full Views on your Page's posts as a result of your ad.",
17640
+ "type": "numeric string",
17641
+ "GoogleBigQueryType": "numeric"
17642
+ },
17643
+ "full_view_reach": {
17644
+ "description": "The number of people who performed a Full View on your Page's post as a result of your ad.",
17645
+ "type": "numeric string",
17646
+ "GoogleBigQueryType": "numeric"
17647
+ },
17648
+ "impressions": {
17649
+ "description": "The number of times your ads were on screen.",
17650
+ "type": "numeric string",
17651
+ "GoogleBigQueryType": "numeric"
17652
+ },
17653
+ "inline_link_click_ctr": {
17654
+ "description": "The percentage of time people saw your ads and performed an inline link click.",
17655
+ "type": "numeric string",
17656
+ "GoogleBigQueryType": "numeric"
17657
+ },
17658
+ "inline_link_clicks": {
17659
+ "description": "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.",
17660
+ "type": "numeric string",
17661
+ "GoogleBigQueryType": "numeric"
17662
+ },
17663
+ "inline_post_engagement": {
17664
+ "description": "The total number of actions that people take involving your ads. Inline post engagements use a fixed 1-day-click attribution window.",
17665
+ "type": "numeric string",
17666
+ "GoogleBigQueryType": "numeric"
17667
+ },
17668
+ "instagram_upcoming_event_reminders_set": {
17669
+ "description": "instagram_upcoming_event_reminders_set",
17670
+ "type": "numeric string",
17671
+ "GoogleBigQueryType": "numeric"
17672
+ },
17673
+ "instant_experience_clicks_to_open": {
17674
+ "description": "instant_experience_clicks_to_open",
17675
+ "type": "numeric string",
17676
+ "GoogleBigQueryType": "numeric"
17677
+ },
17678
+ "instant_experience_clicks_to_start": {
17679
+ "description": "instant_experience_clicks_to_start",
17680
+ "type": "numeric string",
17681
+ "GoogleBigQueryType": "numeric"
17682
+ },
17683
+ "instant_experience_outbound_clicks": {
17684
+ "description": "instant_experience_outbound_clicks",
17685
+ "type": "list<AdsActionStats>"
17686
+ },
17687
+ "interactive_component_tap": {
17688
+ "description": "interactive_component_tap",
17689
+ "type": "list<AdsActionStats>"
17690
+ },
17691
+ "marketing_messages_delivery_rate": {
17692
+ "description": "The number of messages delivered divided by the number of messages sent. Some messages may not be delivered, such as when a customer's device is out of service. This metric doesn't include messages sent to Europe and Japan.",
17693
+ "type": "numeric string",
17694
+ "GoogleBigQueryType": "numeric"
17695
+ },
17696
+ "mobile_app_purchase_roas": {
17697
+ "description": "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.",
17698
+ "type": "list<AdsActionStats>"
17699
+ },
17700
+ "objective": {
17701
+ "description": "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.",
17702
+ "type": "string"
17703
+ },
17704
+ "optimization_goal": {
17705
+ "description": "The optimization goal you selected for your ad or ad set. Your optimization goal reflects what you want to optimize for the ads.",
17706
+ "type": "string"
17707
+ },
17708
+ "outbound_clicks": {
17709
+ "description": "The number of clicks on links that take people off Facebook-owned properties.",
17710
+ "type": "list<AdsActionStats>"
17711
+ },
17712
+ "outbound_clicks_ctr": {
17713
+ "description": "The percentage of times people saw your ad and performed an outbound click.",
17714
+ "type": "list<AdsActionStats>"
17715
+ },
17716
+ "platform_position": {
17717
+ "description": "platform_position",
17718
+ "type": "string"
17719
+ },
17720
+ "publisher_platform": {
17721
+ "description": "Which platform your ad was shown, for example on Facebook, Instagram, or Audience Network.",
17722
+ "type": "string"
17723
+ },
17724
+ "purchase_roas": {
17725
+ "description": "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.",
17726
+ "type": "list<AdsActionStats>"
17727
+ },
17728
+ "qualifying_question_qualify_answer_rate": {
17729
+ "description": "qualifying_question_qualify_answer_rate",
17730
+ "type": "numeric string",
17731
+ "GoogleBigQueryType": "numeric"
17732
+ },
17733
+ "reach": {
17734
+ "description": "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.",
17735
+ "type": "numeric string",
17736
+ "GoogleBigQueryType": "numeric"
17737
+ },
17738
+ "shops_assisted_purchases": {
17739
+ "description": "shops_assisted_purchases",
17740
+ "type": "string"
17741
+ },
17742
+ "social_spend": {
17743
+ "description": "The total amount you've spent so far for your ads showed with social information. (ex: Jane Doe likes this).",
17744
+ "type": "numeric string",
17745
+ "GoogleBigQueryType": "numeric"
17746
+ },
17747
+ "spend": {
17748
+ "description": "The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated.",
17749
+ "type": "numeric string",
17750
+ "GoogleSheetsFormat": "$#,##0.00",
17751
+ "GoogleBigQueryType": "numeric"
17752
+ },
17753
+ "updated_time": {
17754
+ "description": "updated_time",
17755
+ "type": "string"
17756
+ },
17757
+ "video_30_sec_watched_actions": {
17758
+ "description": "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.",
17759
+ "type": "list<AdsActionStats>"
17760
+ },
17761
+ "video_avg_time_watched_actions": {
17762
+ "description": "The average time a video was played, including any time spent replaying the video for a single impression.",
17763
+ "type": "list<AdsActionStats>"
17764
+ },
17765
+ "video_continuous_2_sec_watched_actions": {
17766
+ "description": "video_continuous_2_sec_watched_actions",
17767
+ "type": "list<AdsActionStats>"
17768
+ },
17769
+ "video_p100_watched_actions": {
17770
+ "description": "The number of times your video was played at 100% of its length, including plays that skipped to this point.",
17771
+ "type": "list<AdsActionStats>"
17772
+ },
17773
+ "video_p25_watched_actions": {
17774
+ "description": "The number of times your video was played at 25% of its length, including plays that skipped to this point.",
17775
+ "type": "list<AdsActionStats>"
17776
+ },
17777
+ "video_p50_watched_actions": {
17778
+ "description": "The number of times your video was played at 50% of its length, including plays that skipped to this point.",
17779
+ "type": "list<AdsActionStats>"
17780
+ },
17781
+ "video_p75_watched_actions": {
17782
+ "description": "The number of times your video was played at 75% of its length, including plays that skipped to this point.",
17783
+ "type": "list<AdsActionStats>"
17784
+ },
17785
+ "video_p95_watched_actions": {
17786
+ "description": "The number of times your video was played at 95% of its length, including plays that skipped to this point.",
17787
+ "type": "list<AdsActionStats>"
17788
+ },
17789
+ "video_play_actions": {
17790
+ "description": "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.",
17791
+ "type": "list<AdsActionStats>"
17792
+ },
17793
+ "video_play_curve_actions": {
17794
+ "description": "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.",
17795
+ "type": "list<AdsHistogramStats>"
17796
+ },
17797
+ "video_play_retention_0_to_15s_actions": {
17798
+ "description": "video_play_retention_0_to_15s_actions",
17799
+ "type": "list<AdsHistogramStats>"
17800
+ },
17801
+ "video_play_retention_20_to_60s_actions": {
17802
+ "description": "video_play_retention_20_to_60s_actions",
17803
+ "type": "list<AdsHistogramStats>"
17804
+ },
17805
+ "video_play_retention_graph_actions": {
17806
+ "description": "video_play_retention_graph_actions",
17807
+ "type": "list<AdsHistogramStats>"
17808
+ },
17809
+ "video_time_watched_actions": {
17810
+ "description": "video_time_watched_actions",
17811
+ "type": "list<AdsActionStats>"
17812
+ },
17813
+ "website_ctr": {
17814
+ "description": "The percentage of times people saw your ad and performed a link click.",
17815
+ "type": "list<AdsActionStats>"
17816
+ },
17817
+ "website_purchase_roas": {
17818
+ "description": "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.",
17819
+ "type": "list<AdsActionStats>"
17820
+ },
17821
+ "wish_bid": {
17822
+ "description": "wish_bid",
17823
+ "type": "numeric string",
17824
+ "GoogleBigQueryType": "numeric"
17825
+ }
17826
+ };
17827
+ var adAccountInsightsFieldsByProductId = {
17828
+ "account_currency": {
17829
+ "description": "Currency that is used by your ad account.",
17830
+ "type": "string"
17831
+ },
17832
+ "account_id": {
17833
+ "description": "The ID number of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.",
17834
+ "type": "numeric string",
17835
+ "GoogleSheetsFormat": "@"
17836
+ },
17837
+ "account_name": {
17838
+ "description": "The name of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.",
17839
+ "type": "string"
17840
+ },
17841
+ "action_values": {
17842
+ "description": "The total value of all conversions attributed to your ads.",
17843
+ "type": "list<AdsActionStats>"
17844
+ },
17845
+ "actions": {
17846
+ "description": "The total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions.",
17847
+ "type": "list<AdsActionStats>"
17848
+ },
17849
+ "ad_click_actions": {
17850
+ "description": "ad_click_actions",
17851
+ "type": "list<AdsActionStats>"
17852
+ },
17853
+ "ad_id": {
17854
+ "description": "The unique ID of the ad you're viewing in reporting.",
17855
+ "type": "numeric string",
17856
+ "GoogleSheetsFormat": "@"
17857
+ },
17858
+ "ad_impression_actions": {
17859
+ "description": "ad_impression_actions",
17860
+ "type": "list<AdsActionStats>"
17861
+ },
17862
+ "ad_name": {
17863
+ "description": "The name of the ad you're viewing in reporting.",
17864
+ "type": "string"
17865
+ },
17866
+ "adset_id": {
17867
+ "description": "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.",
17868
+ "type": "numeric string",
17869
+ "GoogleSheetsFormat": "@"
17870
+ },
17871
+ "adset_name": {
17872
+ "description": "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.",
17873
+ "type": "string"
17874
+ },
17875
+ "attribution_setting": {
17876
+ "description": "The default attribution window to be used when attribution result is calculated. Each ad set has its own attribution setting value. The attribution setting for campaign or account is calculated based on existing ad sets.",
17877
+ "type": "string"
17878
+ },
17879
+ "auction_bid": {
17880
+ "description": "auction_bid",
17881
+ "type": "numeric string",
17882
+ "GoogleBigQueryType": "numeric"
17883
+ },
17884
+ "auction_competitiveness": {
17885
+ "description": "auction_competitiveness",
17886
+ "type": "numeric string",
17887
+ "GoogleBigQueryType": "numeric"
17888
+ },
17889
+ "auction_max_competitor_bid": {
17890
+ "description": "auction_max_competitor_bid",
17891
+ "type": "numeric string",
17892
+ "GoogleBigQueryType": "numeric"
17893
+ },
17894
+ "buying_type": {
17895
+ "description": "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.",
17896
+ "type": "string"
17897
+ },
17898
+ "campaign_id": {
17899
+ "description": "The unique ID number of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.",
17900
+ "type": "numeric string",
17901
+ "GoogleSheetsFormat": "@"
17902
+ },
17903
+ "campaign_name": {
17904
+ "description": "The name of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.",
17905
+ "type": "string"
17906
+ },
17907
+ "canvas_avg_view_percent": {
17908
+ "description": "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.",
17909
+ "type": "numeric string",
17910
+ "GoogleBigQueryType": "numeric"
17911
+ },
17912
+ "canvas_avg_view_time": {
17913
+ "description": "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.",
17914
+ "type": "numeric string",
17915
+ "GoogleBigQueryType": "numeric"
17916
+ },
17917
+ "catalog_segment_actions": {
17918
+ "description": "The number of actions performed attributed to your ads promoting your catalog segment, broken down by action type.",
17919
+ "type": "list<AdsActionStats>"
17920
+ },
17921
+ "catalog_segment_value": {
17922
+ "description": "The total value of all conversions from your catalog segment attributed to your ads.",
17923
+ "type": "list<AdsActionStats>"
17924
+ },
17925
+ "catalog_segment_value_mobile_purchase_roas": {
17926
+ "description": "The total return on ad spend (ROAS) from mobile app purchases for your catalog segment.",
17927
+ "type": "list<AdsActionStats>"
17928
+ },
17929
+ "catalog_segment_value_omni_purchase_roas": {
17930
+ "description": "The total return on ad spend (ROAS) from all purchases for your catalog segment.",
17931
+ "type": "list<AdsActionStats>"
17932
+ },
17933
+ "catalog_segment_value_website_purchase_roas": {
17934
+ "description": "The total return on ad spend (ROAS) from website purchases for your catalog segment.",
17935
+ "type": "list<AdsActionStats>"
17936
+ },
17937
+ "clicks": {
17938
+ "description": "The number of clicks on your ads.",
17939
+ "type": "numeric string",
17940
+ "GoogleBigQueryType": "numeric"
17941
+ },
17942
+ "conversion_values": {
17943
+ "description": "conversion_values",
17944
+ "type": "list<AdsActionStats>"
17945
+ },
17946
+ "conversions": {
17947
+ "description": "conversions",
17948
+ "type": "list<AdsActionStats>"
17949
+ },
17950
+ "converted_product_quantity": {
17951
+ "description": "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.",
17952
+ "type": "list<AdsActionStats>"
17953
+ },
17954
+ "converted_product_value": {
17955
+ "description": "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.",
17956
+ "type": "list<AdsActionStats>"
17957
+ },
17958
+ "cost_per_15_sec_video_view": {
17959
+ "description": "cost_per_15_sec_video_view",
17960
+ "type": "list<AdsActionStats>"
17961
+ },
17962
+ "cost_per_2_sec_continuous_video_view": {
17963
+ "description": "cost_per_2_sec_continuous_video_view",
17964
+ "type": "list<AdsActionStats>"
17965
+ },
17966
+ "cost_per_action_type": {
17967
+ "description": "The average cost of a relevant action.",
17968
+ "type": "list<AdsActionStats>"
17969
+ },
17970
+ "cost_per_ad_click": {
17971
+ "description": "cost_per_ad_click",
17972
+ "type": "list<AdsActionStats>"
17973
+ },
17974
+ "cost_per_conversion": {
17975
+ "description": "cost_per_conversion",
17976
+ "type": "list<AdsActionStats>"
17977
+ },
17978
+ "cost_per_dda_countby_convs": {
17979
+ "description": "cost_per_dda_countby_convs",
17980
+ "type": "numeric string",
17981
+ "GoogleBigQueryType": "numeric"
17982
+ },
17983
+ "cost_per_inline_link_click": {
17984
+ "description": "The average cost of each inline link click.",
17985
+ "type": "numeric string",
17986
+ "GoogleBigQueryType": "numeric"
17987
+ },
17988
+ "cost_per_inline_post_engagement": {
17989
+ "description": "The average cost of each inline post engagement.",
17990
+ "type": "numeric string",
17991
+ "GoogleBigQueryType": "numeric"
17992
+ },
17993
+ "cost_per_one_thousand_ad_impression": {
17994
+ "description": "cost_per_one_thousand_ad_impression",
17995
+ "type": "list<AdsActionStats>"
17996
+ },
17997
+ "cost_per_outbound_click": {
17998
+ "description": "The average cost for each outbound click.",
17999
+ "type": "list<AdsActionStats>"
18000
+ },
18001
+ "cost_per_thruplay": {
18002
+ "description": "The average cost for each ThruPlay. This metric is in development.",
18003
+ "type": "list<AdsActionStats>"
18004
+ },
18005
+ "cost_per_unique_action_type": {
18006
+ "description": "The average cost of each unique action. This metric is estimated.",
18007
+ "type": "list<AdsActionStats>"
18008
+ },
18009
+ "cost_per_unique_click": {
18010
+ "description": "The average cost for each unique click (all). This metric is estimated.",
18011
+ "type": "numeric string",
18012
+ "GoogleBigQueryType": "numeric"
18013
+ },
18014
+ "cost_per_unique_conversion": {
18015
+ "description": "cost_per_unique_conversion",
18016
+ "type": "list<AdsActionStats>"
18017
+ },
18018
+ "cost_per_unique_inline_link_click": {
18019
+ "description": "The average cost of each unique inline link click. This metric is estimated.",
18020
+ "type": "numeric string",
18021
+ "GoogleBigQueryType": "numeric"
18022
+ },
18023
+ "cost_per_unique_outbound_click": {
18024
+ "description": "The average cost for each unique outbound click. This metric is estimated.",
18025
+ "type": "list<AdsActionStats>"
18026
+ },
18027
+ "cpc": {
18028
+ "description": "The average cost for each click (all).",
18029
+ "type": "numeric string",
18030
+ "GoogleBigQueryType": "numeric"
18031
+ },
18032
+ "cpm": {
18033
+ "description": "The average cost for 1,000 impressions.",
18034
+ "type": "numeric string",
18035
+ "GoogleBigQueryType": "numeric"
18036
+ },
18037
+ "cpp": {
18038
+ "description": "The average cost to reach 1,000 people. This metric is estimated.",
18039
+ "type": "numeric string",
18040
+ "GoogleBigQueryType": "numeric"
18041
+ },
18042
+ "created_time": {
18043
+ "description": "created_time",
18044
+ "type": "string"
18045
+ },
18046
+ "ctr": {
18047
+ "description": "The percentage of times people saw your ad and performed a click (all).",
18048
+ "type": "numeric string",
18049
+ "GoogleBigQueryType": "numeric"
18050
+ },
18051
+ "date_start": {
18052
+ "description": "The start date for your data. This is controlled by the date range you've selected for your reporting view.",
18053
+ "type": "string",
18054
+ "GoogleBigQueryType": "date",
18055
+ "GoogleBigQueryPartitioned": true
18056
+ },
18057
+ "date_stop": {
18058
+ "description": "The end date for your data. This is controlled by the date range you've selected for your reporting view.",
18059
+ "type": "string",
18060
+ "GoogleBigQueryType": "date"
18061
+ },
18062
+ "dda_countby_convs": {
18063
+ "description": "dda_countby_convs",
18064
+ "type": "numeric string",
18065
+ "GoogleBigQueryType": "numeric"
18066
+ },
18067
+ "dda_results": {
18068
+ "description": "dda_results",
18069
+ "type": "list<AdsInsightsDdaResult>"
18070
+ },
18071
+ "frequency": {
18072
+ "description": "The average number of times each person saw your ad. This metric is estimated.",
18073
+ "type": "numeric string",
18074
+ "GoogleBigQueryType": "numeric"
18075
+ },
18076
+ "full_view_impressions": {
18077
+ "description": "The number of Full Views on your Page's posts as a result of your ad.",
18078
+ "type": "numeric string",
18079
+ "GoogleBigQueryType": "numeric"
18080
+ },
18081
+ "full_view_reach": {
18082
+ "description": "The number of people who performed a Full View on your Page's post as a result of your ad.",
18083
+ "type": "numeric string",
18084
+ "GoogleBigQueryType": "numeric"
18085
+ },
18086
+ "impressions": {
18087
+ "description": "The number of times your ads were on screen.",
18088
+ "type": "numeric string",
18089
+ "GoogleBigQueryType": "numeric"
18090
+ },
18091
+ "inline_link_click_ctr": {
18092
+ "description": "The percentage of time people saw your ads and performed an inline link click.",
18093
+ "type": "numeric string",
18094
+ "GoogleBigQueryType": "numeric"
18095
+ },
18096
+ "inline_link_clicks": {
18097
+ "description": "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.",
18098
+ "type": "numeric string",
18099
+ "GoogleBigQueryType": "numeric"
18100
+ },
18101
+ "inline_post_engagement": {
18102
+ "description": "The total number of actions that people take involving your ads. Inline post engagements use a fixed 1-day-click attribution window.",
18103
+ "type": "numeric string",
18104
+ "GoogleBigQueryType": "numeric"
18105
+ },
18106
+ "instagram_upcoming_event_reminders_set": {
18107
+ "description": "instagram_upcoming_event_reminders_set",
18108
+ "type": "numeric string",
18109
+ "GoogleBigQueryType": "numeric"
18110
+ },
18111
+ "instant_experience_clicks_to_open": {
18112
+ "description": "instant_experience_clicks_to_open",
18113
+ "type": "numeric string",
18114
+ "GoogleBigQueryType": "numeric"
18115
+ },
18116
+ "instant_experience_clicks_to_start": {
18117
+ "description": "instant_experience_clicks_to_start",
18118
+ "type": "numeric string",
18119
+ "GoogleBigQueryType": "numeric"
18120
+ },
18121
+ "instant_experience_outbound_clicks": {
18122
+ "description": "instant_experience_outbound_clicks",
18123
+ "type": "list<AdsActionStats>"
18124
+ },
18125
+ "interactive_component_tap": {
18126
+ "description": "interactive_component_tap",
18127
+ "type": "list<AdsActionStats>"
18128
+ },
18129
+ "marketing_messages_delivery_rate": {
18130
+ "description": "The number of messages delivered divided by the number of messages sent. Some messages may not be delivered, such as when a customer's device is out of service. This metric doesn't include messages sent to Europe and Japan.",
18131
+ "type": "numeric string",
18132
+ "GoogleBigQueryType": "numeric"
18133
+ },
18134
+ "mobile_app_purchase_roas": {
18135
+ "description": "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.",
18136
+ "type": "list<AdsActionStats>"
18137
+ },
18138
+ "objective": {
18139
+ "description": "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.",
18140
+ "type": "string"
18141
+ },
18142
+ "optimization_goal": {
18143
+ "description": "The optimization goal you selected for your ad or ad set. Your optimization goal reflects what you want to optimize for the ads.",
18144
+ "type": "string"
18145
+ },
18146
+ "outbound_clicks": {
18147
+ "description": "The number of clicks on links that take people off Facebook-owned properties.",
18148
+ "type": "list<AdsActionStats>"
18149
+ },
18150
+ "outbound_clicks_ctr": {
18151
+ "description": "The percentage of times people saw your ad and performed an outbound click.",
18152
+ "type": "list<AdsActionStats>"
18153
+ },
18154
+ "product_id": {
18155
+ "description": "The ID of the product associated with the ad.",
18156
+ "type": "string"
18157
+ },
18158
+ "purchase_roas": {
18159
+ "description": "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.",
18160
+ "type": "list<AdsActionStats>"
18161
+ },
18162
+ "qualifying_question_qualify_answer_rate": {
18163
+ "description": "qualifying_question_qualify_answer_rate",
18164
+ "type": "numeric string",
18165
+ "GoogleBigQueryType": "numeric"
18166
+ },
18167
+ "reach": {
18168
+ "description": "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.",
18169
+ "type": "numeric string",
18170
+ "GoogleBigQueryType": "numeric"
18171
+ },
18172
+ "shops_assisted_purchases": {
18173
+ "description": "shops_assisted_purchases",
18174
+ "type": "string"
18175
+ },
18176
+ "social_spend": {
18177
+ "description": "The total amount you've spent so far for your ads showed with social information. (ex: Jane Doe likes this).",
18178
+ "type": "numeric string",
18179
+ "GoogleBigQueryType": "numeric"
18180
+ },
18181
+ "spend": {
18182
+ "description": "The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated.",
18183
+ "type": "numeric string",
18184
+ "GoogleSheetsFormat": "$#,##0.00",
18185
+ "GoogleBigQueryType": "numeric"
18186
+ },
18187
+ "updated_time": {
18188
+ "description": "updated_time",
18189
+ "type": "string"
18190
+ },
18191
+ "video_30_sec_watched_actions": {
18192
+ "description": "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.",
18193
+ "type": "list<AdsActionStats>"
18194
+ },
18195
+ "video_avg_time_watched_actions": {
18196
+ "description": "The average time a video was played, including any time spent replaying the video for a single impression.",
18197
+ "type": "list<AdsActionStats>"
18198
+ },
18199
+ "video_continuous_2_sec_watched_actions": {
18200
+ "description": "video_continuous_2_sec_watched_actions",
18201
+ "type": "list<AdsActionStats>"
18202
+ },
18203
+ "video_p100_watched_actions": {
18204
+ "description": "The number of times your video was played at 100% of its length, including plays that skipped to this point.",
18205
+ "type": "list<AdsActionStats>"
18206
+ },
18207
+ "video_p25_watched_actions": {
18208
+ "description": "The number of times your video was played at 25% of its length, including plays that skipped to this point.",
18209
+ "type": "list<AdsActionStats>"
18210
+ },
18211
+ "video_p50_watched_actions": {
18212
+ "description": "The number of times your video was played at 50% of its length, including plays that skipped to this point.",
18213
+ "type": "list<AdsActionStats>"
18214
+ },
18215
+ "video_p75_watched_actions": {
18216
+ "description": "The number of times your video was played at 75% of its length, including plays that skipped to this point.",
18217
+ "type": "list<AdsActionStats>"
18218
+ },
18219
+ "video_p95_watched_actions": {
18220
+ "description": "The number of times your video was played at 95% of its length, including plays that skipped to this point.",
18221
+ "type": "list<AdsActionStats>"
18222
+ },
18223
+ "video_play_actions": {
18224
+ "description": "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.",
18225
+ "type": "list<AdsActionStats>"
18226
+ },
18227
+ "video_play_curve_actions": {
18228
+ "description": "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.",
18229
+ "type": "list<AdsHistogramStats>"
18230
+ },
18231
+ "video_play_retention_0_to_15s_actions": {
18232
+ "description": "video_play_retention_0_to_15s_actions",
18233
+ "type": "list<AdsHistogramStats>"
18234
+ },
18235
+ "video_play_retention_20_to_60s_actions": {
18236
+ "description": "video_play_retention_20_to_60s_actions",
18237
+ "type": "list<AdsHistogramStats>"
18238
+ },
18239
+ "video_play_retention_graph_actions": {
18240
+ "description": "video_play_retention_graph_actions",
18241
+ "type": "list<AdsHistogramStats>"
18242
+ },
18243
+ "video_time_watched_actions": {
18244
+ "description": "video_time_watched_actions",
18245
+ "type": "list<AdsActionStats>"
18246
+ },
18247
+ "website_ctr": {
18248
+ "description": "The percentage of times people saw your ad and performed a link click.",
18249
+ "type": "list<AdsActionStats>"
18250
+ },
18251
+ "website_purchase_roas": {
18252
+ "description": "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.",
18253
+ "type": "list<AdsActionStats>"
18254
+ },
18255
+ "wish_bid": {
18256
+ "description": "wish_bid",
18257
+ "type": "numeric string",
18258
+ "GoogleBigQueryType": "numeric"
18259
+ }
18260
+ };
18261
+ var adAccountInsightsFieldsByLinkUrlAsset = {
18262
+ "account_currency": {
18263
+ "description": "Currency that is used by your ad account.",
18264
+ "type": "string"
18265
+ },
18266
+ "account_id": {
18267
+ "description": "The ID number of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.",
18268
+ "type": "numeric string",
18269
+ "GoogleSheetsFormat": "@"
18270
+ },
18271
+ "account_name": {
18272
+ "description": "The name of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.",
18273
+ "type": "string"
18274
+ },
18275
+ "action_values": {
18276
+ "description": "The total value of all conversions attributed to your ads.",
18277
+ "type": "list<AdsActionStats>"
18278
+ },
18279
+ "actions": {
18280
+ "description": "The total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions.",
18281
+ "type": "list<AdsActionStats>"
18282
+ },
18283
+ "ad_click_actions": {
18284
+ "description": "ad_click_actions",
18285
+ "type": "list<AdsActionStats>"
18286
+ },
18287
+ "ad_id": {
18288
+ "description": "The unique ID of the ad you're viewing in reporting.",
18289
+ "type": "numeric string",
18290
+ "GoogleSheetsFormat": "@"
18291
+ },
18292
+ "ad_impression_actions": {
18293
+ "description": "ad_impression_actions",
18294
+ "type": "list<AdsActionStats>"
18295
+ },
18296
+ "ad_name": {
18297
+ "description": "The name of the ad you're viewing in reporting.",
18298
+ "type": "string"
18299
+ },
18300
+ "adset_id": {
18301
+ "description": "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.",
18302
+ "type": "numeric string",
18303
+ "GoogleSheetsFormat": "@"
18304
+ },
18305
+ "adset_name": {
18306
+ "description": "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.",
18307
+ "type": "string"
18308
+ },
18309
+ "attribution_setting": {
18310
+ "description": "The default attribution window to be used when attribution result is calculated. Each ad set has its own attribution setting value. The attribution setting for campaign or account is calculated based on existing ad sets.",
18311
+ "type": "string"
18312
+ },
18313
+ "auction_bid": {
18314
+ "description": "auction_bid",
18315
+ "type": "numeric string",
18316
+ "GoogleBigQueryType": "numeric"
18317
+ },
18318
+ "auction_competitiveness": {
18319
+ "description": "auction_competitiveness",
18320
+ "type": "numeric string",
18321
+ "GoogleBigQueryType": "numeric"
18322
+ },
18323
+ "auction_max_competitor_bid": {
18324
+ "description": "auction_max_competitor_bid",
18325
+ "type": "numeric string",
18326
+ "GoogleBigQueryType": "numeric"
18327
+ },
18328
+ "buying_type": {
18329
+ "description": "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.",
18330
+ "type": "string"
18331
+ },
18332
+ "campaign_id": {
18333
+ "description": "The unique ID number of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.",
18334
+ "type": "numeric string",
18335
+ "GoogleSheetsFormat": "@"
18336
+ },
18337
+ "campaign_name": {
18338
+ "description": "The name of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.",
18339
+ "type": "string"
18340
+ },
18341
+ "canvas_avg_view_percent": {
18342
+ "description": "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.",
18343
+ "type": "numeric string",
18344
+ "GoogleBigQueryType": "numeric"
18345
+ },
18346
+ "canvas_avg_view_time": {
18347
+ "description": "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.",
18348
+ "type": "numeric string",
18349
+ "GoogleBigQueryType": "numeric"
18350
+ },
18351
+ "catalog_segment_actions": {
18352
+ "description": "The number of actions performed attributed to your ads promoting your catalog segment, broken down by action type.",
18353
+ "type": "list<AdsActionStats>"
18354
+ },
18355
+ "catalog_segment_value": {
18356
+ "description": "The total value of all conversions from your catalog segment attributed to your ads.",
18357
+ "type": "list<AdsActionStats>"
18358
+ },
18359
+ "catalog_segment_value_mobile_purchase_roas": {
18360
+ "description": "The total return on ad spend (ROAS) from mobile app purchases for your catalog segment.",
18361
+ "type": "list<AdsActionStats>"
18362
+ },
18363
+ "catalog_segment_value_omni_purchase_roas": {
18364
+ "description": "The total return on ad spend (ROAS) from all purchases for your catalog segment.",
18365
+ "type": "list<AdsActionStats>"
18366
+ },
18367
+ "catalog_segment_value_website_purchase_roas": {
18368
+ "description": "The total return on ad spend (ROAS) from website purchases for your catalog segment.",
18369
+ "type": "list<AdsActionStats>"
18370
+ },
18371
+ "clicks": {
18372
+ "description": "The number of clicks on your ads.",
18373
+ "type": "numeric string",
18374
+ "GoogleBigQueryType": "numeric"
18375
+ },
18376
+ "conversion_values": {
18377
+ "description": "conversion_values",
18378
+ "type": "list<AdsActionStats>"
18379
+ },
18380
+ "conversions": {
18381
+ "description": "conversions",
18382
+ "type": "list<AdsActionStats>"
18383
+ },
18384
+ "converted_product_quantity": {
18385
+ "description": "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.",
18386
+ "type": "list<AdsActionStats>"
18387
+ },
18388
+ "converted_product_value": {
18389
+ "description": "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.",
18390
+ "type": "list<AdsActionStats>"
18391
+ },
18392
+ "cost_per_15_sec_video_view": {
18393
+ "description": "cost_per_15_sec_video_view",
18394
+ "type": "list<AdsActionStats>"
18395
+ },
18396
+ "cost_per_2_sec_continuous_video_view": {
18397
+ "description": "cost_per_2_sec_continuous_video_view",
18398
+ "type": "list<AdsActionStats>"
18399
+ },
18400
+ "cost_per_action_type": {
18401
+ "description": "The average cost of a relevant action.",
18402
+ "type": "list<AdsActionStats>"
18403
+ },
18404
+ "cost_per_ad_click": {
18405
+ "description": "cost_per_ad_click",
18406
+ "type": "list<AdsActionStats>"
18407
+ },
18408
+ "cost_per_conversion": {
18409
+ "description": "cost_per_conversion",
18410
+ "type": "list<AdsActionStats>"
18411
+ },
18412
+ "cost_per_dda_countby_convs": {
18413
+ "description": "cost_per_dda_countby_convs",
18414
+ "type": "numeric string",
18415
+ "GoogleBigQueryType": "numeric"
18416
+ },
18417
+ "cost_per_inline_link_click": {
18418
+ "description": "The average cost of each inline link click.",
18419
+ "type": "numeric string",
18420
+ "GoogleBigQueryType": "numeric"
18421
+ },
18422
+ "cost_per_inline_post_engagement": {
18423
+ "description": "The average cost of each inline post engagement.",
18424
+ "type": "numeric string",
18425
+ "GoogleBigQueryType": "numeric"
18426
+ },
18427
+ "cost_per_one_thousand_ad_impression": {
18428
+ "description": "cost_per_one_thousand_ad_impression",
18429
+ "type": "list<AdsActionStats>"
18430
+ },
18431
+ "cost_per_outbound_click": {
18432
+ "description": "The average cost for each outbound click.",
18433
+ "type": "list<AdsActionStats>"
18434
+ },
18435
+ "cost_per_thruplay": {
18436
+ "description": "The average cost for each ThruPlay. This metric is in development.",
18437
+ "type": "list<AdsActionStats>"
18438
+ },
18439
+ "cost_per_unique_action_type": {
18440
+ "description": "The average cost of each unique action. This metric is estimated.",
18441
+ "type": "list<AdsActionStats>"
18442
+ },
18443
+ "cost_per_unique_click": {
18444
+ "description": "The average cost for each unique click (all). This metric is estimated.",
18445
+ "type": "numeric string",
18446
+ "GoogleBigQueryType": "numeric"
18447
+ },
18448
+ "cost_per_unique_conversion": {
18449
+ "description": "cost_per_unique_conversion",
18450
+ "type": "list<AdsActionStats>"
18451
+ },
18452
+ "cost_per_unique_inline_link_click": {
18453
+ "description": "The average cost of each unique inline link click. This metric is estimated.",
18454
+ "type": "numeric string",
18455
+ "GoogleBigQueryType": "numeric"
18456
+ },
18457
+ "cost_per_unique_outbound_click": {
18458
+ "description": "The average cost for each unique outbound click. This metric is estimated.",
18459
+ "type": "list<AdsActionStats>"
18460
+ },
18461
+ "cpc": {
18462
+ "description": "The average cost for each click (all).",
18463
+ "type": "numeric string",
18464
+ "GoogleBigQueryType": "numeric"
18465
+ },
18466
+ "cpm": {
18467
+ "description": "The average cost for 1,000 impressions.",
18468
+ "type": "numeric string",
18469
+ "GoogleBigQueryType": "numeric"
18470
+ },
18471
+ "cpp": {
18472
+ "description": "The average cost to reach 1,000 people. This metric is estimated.",
18473
+ "type": "numeric string",
18474
+ "GoogleBigQueryType": "numeric"
18475
+ },
18476
+ "created_time": {
18477
+ "description": "created_time",
18478
+ "type": "string"
18479
+ },
18480
+ "ctr": {
18481
+ "description": "The percentage of times people saw your ad and performed a click (all).",
18482
+ "type": "numeric string",
18483
+ "GoogleBigQueryType": "numeric"
18484
+ },
18485
+ "date_start": {
18486
+ "description": "The start date for your data. This is controlled by the date range you've selected for your reporting view.",
18487
+ "type": "string",
18488
+ "GoogleBigQueryType": "date",
18489
+ "GoogleBigQueryPartitioned": true
18490
+ },
18491
+ "date_stop": {
18492
+ "description": "The end date for your data. This is controlled by the date range you've selected for your reporting view.",
18493
+ "type": "string",
18494
+ "GoogleBigQueryType": "date"
18495
+ },
18496
+ "dda_countby_convs": {
18497
+ "description": "dda_countby_convs",
18498
+ "type": "numeric string",
18499
+ "GoogleBigQueryType": "numeric"
18500
+ },
18501
+ "dda_results": {
18502
+ "description": "dda_results",
18503
+ "type": "list<AdsInsightsDdaResult>"
18504
+ },
18505
+ "frequency": {
18506
+ "description": "The average number of times each person saw your ad. This metric is estimated.",
18507
+ "type": "numeric string",
18508
+ "GoogleBigQueryType": "numeric"
18509
+ },
18510
+ "full_view_impressions": {
18511
+ "description": "The number of Full Views on your Page's posts as a result of your ad.",
18512
+ "type": "numeric string",
18513
+ "GoogleBigQueryType": "numeric"
18514
+ },
18515
+ "full_view_reach": {
18516
+ "description": "The number of people who performed a Full View on your Page's post as a result of your ad.",
18517
+ "type": "numeric string",
18518
+ "GoogleBigQueryType": "numeric"
18519
+ },
18520
+ "impressions": {
18521
+ "description": "The number of times your ads were on screen.",
18522
+ "type": "numeric string",
18523
+ "GoogleBigQueryType": "numeric"
18524
+ },
18525
+ "inline_link_click_ctr": {
18526
+ "description": "The percentage of time people saw your ads and performed an inline link click.",
18527
+ "type": "numeric string",
18528
+ "GoogleBigQueryType": "numeric"
18529
+ },
18530
+ "inline_link_clicks": {
18531
+ "description": "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.",
18532
+ "type": "numeric string",
18533
+ "GoogleBigQueryType": "numeric"
18534
+ },
18535
+ "inline_post_engagement": {
18536
+ "description": "The total number of actions that people take involving your ads. Inline post engagements use a fixed 1-day-click attribution window.",
18537
+ "type": "numeric string",
18538
+ "GoogleBigQueryType": "numeric"
18539
+ },
18540
+ "instagram_upcoming_event_reminders_set": {
18541
+ "description": "instagram_upcoming_event_reminders_set",
18542
+ "type": "numeric string",
18543
+ "GoogleBigQueryType": "numeric"
18544
+ },
18545
+ "instant_experience_clicks_to_open": {
18546
+ "description": "instant_experience_clicks_to_open",
18547
+ "type": "numeric string",
18548
+ "GoogleBigQueryType": "numeric"
18549
+ },
18550
+ "instant_experience_clicks_to_start": {
18551
+ "description": "instant_experience_clicks_to_start",
18552
+ "type": "numeric string",
18553
+ "GoogleBigQueryType": "numeric"
18554
+ },
18555
+ "instant_experience_outbound_clicks": {
18556
+ "description": "instant_experience_outbound_clicks",
18557
+ "type": "list<AdsActionStats>"
18558
+ },
18559
+ "interactive_component_tap": {
18560
+ "description": "interactive_component_tap",
18561
+ "type": "list<AdsActionStats>"
18562
+ },
18563
+ "link_url_asset": {
18564
+ "description": "The ID of the URL asset involved in impression, click or action.",
18565
+ "type": "object"
18566
+ },
18567
+ "marketing_messages_delivery_rate": {
18568
+ "description": "The number of messages delivered divided by the number of messages sent. Some messages may not be delivered, such as when a customer's device is out of service. This metric doesn't include messages sent to Europe and Japan.",
18569
+ "type": "numeric string",
18570
+ "GoogleBigQueryType": "numeric"
18571
+ },
18572
+ "mobile_app_purchase_roas": {
18573
+ "description": "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.",
18574
+ "type": "list<AdsActionStats>"
16439
18575
  },
16440
- "creative_asset_groups_spec": {
16441
- "description": "This field is used to create ads using the Flexible ad format. You can read more about that here",
16442
- "type": "AdCreativeAssetGroupsSpec"
18576
+ "objective": {
18577
+ "description": "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.",
18578
+ "type": "string"
16443
18579
  },
16444
- "effective_status": {
16445
- "description": "The effective status of the ad. The status could be effective either because of its own status, or the status of its parent units. WITH_ISSUES is available for version 3.2 or higher. IN_PROCESS is available for version 4.0 or higher",
16446
- "type": "enum {ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES}"
18580
+ "optimization_goal": {
18581
+ "description": "The optimization goal you selected for your ad or ad set. Your optimization goal reflects what you want to optimize for the ads.",
18582
+ "type": "string"
16447
18583
  },
16448
- "issues_info": {
16449
- "description": "Issues for this ad that prevented it from delivering",
16450
- "type": "list<AdgroupIssuesInfo>"
18584
+ "outbound_clicks": {
18585
+ "description": "The number of clicks on links that take people off Facebook-owned properties.",
18586
+ "type": "list<AdsActionStats>"
16451
18587
  },
16452
- "last_updated_by_app_id": {
16453
- "description": "Indicates the app used for the most recent update of the ad.",
16454
- "type": "id"
18588
+ "outbound_clicks_ctr": {
18589
+ "description": "The percentage of times people saw your ad and performed an outbound click.",
18590
+ "type": "list<AdsActionStats>"
16455
18591
  },
16456
- "name": {
16457
- "description": "Name of the ad.",
18592
+ "purchase_roas": {
18593
+ "description": "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.",
18594
+ "type": "list<AdsActionStats>"
18595
+ },
18596
+ "qualifying_question_qualify_answer_rate": {
18597
+ "description": "qualifying_question_qualify_answer_rate",
18598
+ "type": "numeric string",
18599
+ "GoogleBigQueryType": "numeric"
18600
+ },
18601
+ "reach": {
18602
+ "description": "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.",
18603
+ "type": "numeric string",
18604
+ "GoogleBigQueryType": "numeric"
18605
+ },
18606
+ "shops_assisted_purchases": {
18607
+ "description": "shops_assisted_purchases",
16458
18608
  "type": "string"
16459
18609
  },
16460
- "preview_shareable_link": {
16461
- "description": "A link that enables users to preview ads in different placements",
18610
+ "social_spend": {
18611
+ "description": "The total amount you've spent so far for your ads showed with social information. (ex: Jane Doe likes this).",
18612
+ "type": "numeric string",
18613
+ "GoogleBigQueryType": "numeric"
18614
+ },
18615
+ "spend": {
18616
+ "description": "The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated.",
18617
+ "type": "numeric string",
18618
+ "GoogleSheetsFormat": "$#,##0.00",
18619
+ "GoogleBigQueryType": "numeric"
18620
+ },
18621
+ "updated_time": {
18622
+ "description": "updated_time",
16462
18623
  "type": "string"
16463
18624
  },
16464
- "recommendations": {
16465
- "description": "If there are recommendations for this ad, this field includes them. Otherwise, it is not included in the response. Field not included in redownload mode.",
16466
- "type": "list<AdRecommendation>"
18625
+ "video_30_sec_watched_actions": {
18626
+ "description": "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.",
18627
+ "type": "list<AdsActionStats>"
16467
18628
  },
16468
- "source_ad": {
16469
- "description": "The source ad that this ad is copied from",
16470
- "type": "Ad"
18629
+ "video_avg_time_watched_actions": {
18630
+ "description": "The average time a video was played, including any time spent replaying the video for a single impression.",
18631
+ "type": "list<AdsActionStats>"
16471
18632
  },
16472
- "source_ad_id": {
16473
- "description": "The source ad id that this ad is copied from",
16474
- "type": "numeric string"
18633
+ "video_continuous_2_sec_watched_actions": {
18634
+ "description": "video_continuous_2_sec_watched_actions",
18635
+ "type": "list<AdsActionStats>"
16475
18636
  },
16476
- "status": {
16477
- "description": "The configured status of the ad. The field returns the same value as configured_status. Use this field, instead of configured_status.",
16478
- "type": "enum {ACTIVE, PAUSED, DELETED, ARCHIVED}"
18637
+ "video_p100_watched_actions": {
18638
+ "description": "The number of times your video was played at 100% of its length, including plays that skipped to this point.",
18639
+ "type": "list<AdsActionStats>"
16479
18640
  },
16480
- "tracking_specs": {
16481
- "description": "With tracking specs, you log actions taken by people on your ad. This field takes arguments identical to action spec. See Tracking and Conversion Specs.",
16482
- "type": "list<ConversionActionQuery>"
18641
+ "video_p25_watched_actions": {
18642
+ "description": "The number of times your video was played at 25% of its length, including plays that skipped to this point.",
18643
+ "type": "list<AdsActionStats>"
16483
18644
  },
16484
- "updated_time": {
16485
- "description": "Time when this ad was updated.",
16486
- "type": "datetime"
16487
- }
16488
- };
16489
- var adAccountUserFields = {
16490
- "id": {
16491
- "description": "ID of the App Scoped User",
16492
- "type": "numeric string"
18645
+ "video_p50_watched_actions": {
18646
+ "description": "The number of times your video was played at 50% of its length, including plays that skipped to this point.",
18647
+ "type": "list<AdsActionStats>"
16493
18648
  },
16494
- "name": {
16495
- "description": "User public full name",
16496
- "type": "string"
18649
+ "video_p75_watched_actions": {
18650
+ "description": "The number of times your video was played at 75% of its length, including plays that skipped to this point.",
18651
+ "type": "list<AdsActionStats>"
18652
+ },
18653
+ "video_p95_watched_actions": {
18654
+ "description": "The number of times your video was played at 95% of its length, including plays that skipped to this point.",
18655
+ "type": "list<AdsActionStats>"
18656
+ },
18657
+ "video_play_actions": {
18658
+ "description": "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.",
18659
+ "type": "list<AdsActionStats>"
18660
+ },
18661
+ "video_play_curve_actions": {
18662
+ "description": "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.",
18663
+ "type": "list<AdsHistogramStats>"
18664
+ },
18665
+ "video_play_retention_0_to_15s_actions": {
18666
+ "description": "video_play_retention_0_to_15s_actions",
18667
+ "type": "list<AdsHistogramStats>"
18668
+ },
18669
+ "video_play_retention_20_to_60s_actions": {
18670
+ "description": "video_play_retention_20_to_60s_actions",
18671
+ "type": "list<AdsHistogramStats>"
18672
+ },
18673
+ "video_play_retention_graph_actions": {
18674
+ "description": "video_play_retention_graph_actions",
18675
+ "type": "list<AdsHistogramStats>"
18676
+ },
18677
+ "video_time_watched_actions": {
18678
+ "description": "video_time_watched_actions",
18679
+ "type": "list<AdsActionStats>"
18680
+ },
18681
+ "website_ctr": {
18682
+ "description": "The percentage of times people saw your ad and performed a link click.",
18683
+ "type": "list<AdsActionStats>"
18684
+ },
18685
+ "website_purchase_roas": {
18686
+ "description": "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.",
18687
+ "type": "list<AdsActionStats>"
18688
+ },
18689
+ "wish_bid": {
18690
+ "description": "wish_bid",
18691
+ "type": "numeric string",
18692
+ "GoogleBigQueryType": "numeric"
16497
18693
  }
16498
- // Commented because this field is lead to mistake despite to presence in schema.
16499
- // 'tasks': {
16500
- // 'description': 'Tasks of App Scoped User',
16501
- // 'type': 'list<string>'
16502
- // }
16503
18694
  };
16504
- var adAccountInsightsFields = {
18695
+ var adAccountInsightsFieldsByDevicePlatform = {
16505
18696
  "account_currency": {
16506
18697
  "description": "Currency that is used by your ad account.",
16507
18698
  "type": "string"
@@ -16568,10 +18759,6 @@ const FacebookMarketing = (function() {
16568
18759
  "type": "numeric string",
16569
18760
  "GoogleBigQueryType": "numeric"
16570
18761
  },
16571
- "body_asset": {
16572
- "description": "body_asset",
16573
- "type": "AdAssetBody"
16574
- },
16575
18762
  "buying_type": {
16576
18763
  "description": "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.",
16577
18764
  "type": "string"
@@ -16749,9 +18936,9 @@ const FacebookMarketing = (function() {
16749
18936
  "description": "dda_results",
16750
18937
  "type": "list<AdsInsightsDdaResult>"
16751
18938
  },
16752
- "description_asset": {
16753
- "description": "description_asset",
16754
- "type": "AdAssetDescription"
18939
+ "device_platform": {
18940
+ "description": "device_platform",
18941
+ "type": "string"
16755
18942
  },
16756
18943
  "frequency": {
16757
18944
  "description": "The average number of times each person saw your ad. This metric is estimated.",
@@ -16768,10 +18955,6 @@ const FacebookMarketing = (function() {
16768
18955
  "type": "numeric string",
16769
18956
  "GoogleBigQueryType": "numeric"
16770
18957
  },
16771
- "image_asset": {
16772
- "description": "image_asset",
16773
- "type": "AdAssetImage"
16774
- },
16775
18958
  "impressions": {
16776
18959
  "description": "The number of times your ads were on screen.",
16777
18960
  "type": "numeric string",
@@ -16869,26 +19052,14 @@ const FacebookMarketing = (function() {
16869
19052
  "GoogleSheetsFormat": "$#,##0.00",
16870
19053
  "GoogleBigQueryType": "numeric"
16871
19054
  },
16872
- "title_asset": {
16873
- "description": "title_asset",
16874
- "type": "AdAssetTitle"
16875
- },
16876
19055
  "updated_time": {
16877
19056
  "description": "updated_time",
16878
19057
  "type": "string"
16879
19058
  },
16880
- "user_segment_key": {
16881
- "description": "user_segment_key",
16882
- "type": "string"
16883
- },
16884
19059
  "video_30_sec_watched_actions": {
16885
19060
  "description": "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.",
16886
19061
  "type": "list<AdsActionStats>"
16887
19062
  },
16888
- "video_asset": {
16889
- "description": "video_asset",
16890
- "type": "AdAssetVideo"
16891
- },
16892
19063
  "video_avg_time_watched_actions": {
16893
19064
  "description": "The average time a video was played, including any time spent replaying the video for a single impression.",
16894
19065
  "type": "list<AdsActionStats>"
@@ -16955,7 +19126,7 @@ const FacebookMarketing = (function() {
16955
19126
  "GoogleBigQueryType": "numeric"
16956
19127
  }
16957
19128
  };
16958
- var adAccountInsightsFieldsByLinkUrlAsset = {
19129
+ var adAccountInsightsFieldsByCountry = {
16959
19130
  "account_currency": {
16960
19131
  "description": "Currency that is used by your ad account.",
16961
19132
  "type": "string"
@@ -17022,10 +19193,6 @@ const FacebookMarketing = (function() {
17022
19193
  "type": "numeric string",
17023
19194
  "GoogleBigQueryType": "numeric"
17024
19195
  },
17025
- "body_asset": {
17026
- "description": "body_asset",
17027
- "type": "AdAssetBody"
17028
- },
17029
19196
  "buying_type": {
17030
19197
  "description": "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.",
17031
19198
  "type": "string"
@@ -17074,6 +19241,10 @@ const FacebookMarketing = (function() {
17074
19241
  "type": "numeric string",
17075
19242
  "GoogleBigQueryType": "numeric"
17076
19243
  },
19244
+ "country": {
19245
+ "description": "The country where the people you've reached are located. This is based on information, such as a person's hometown, their current city, and the geographical location where they tend to be when they visit Meta.",
19246
+ "type": "string"
19247
+ },
17077
19248
  "conversion_values": {
17078
19249
  "description": "conversion_values",
17079
19250
  "type": "list<AdsActionStats>"
@@ -17203,10 +19374,6 @@ const FacebookMarketing = (function() {
17203
19374
  "description": "dda_results",
17204
19375
  "type": "list<AdsInsightsDdaResult>"
17205
19376
  },
17206
- "description_asset": {
17207
- "description": "description_asset",
17208
- "type": "AdAssetDescription"
17209
- },
17210
19377
  "frequency": {
17211
19378
  "description": "The average number of times each person saw your ad. This metric is estimated.",
17212
19379
  "type": "numeric string",
@@ -17222,10 +19389,6 @@ const FacebookMarketing = (function() {
17222
19389
  "type": "numeric string",
17223
19390
  "GoogleBigQueryType": "numeric"
17224
19391
  },
17225
- "image_asset": {
17226
- "description": "image_asset",
17227
- "type": "AdAssetImage"
17228
- },
17229
19392
  "impressions": {
17230
19393
  "description": "The number of times your ads were on screen.",
17231
19394
  "type": "numeric string",
@@ -17269,10 +19432,6 @@ const FacebookMarketing = (function() {
17269
19432
  "description": "interactive_component_tap",
17270
19433
  "type": "list<AdsActionStats>"
17271
19434
  },
17272
- "link_url_asset": {
17273
- "description": "The ID of the URL asset involved in impression, click or action.",
17274
- "type": "object"
17275
- },
17276
19435
  "marketing_messages_delivery_rate": {
17277
19436
  "description": "The number of messages delivered divided by the number of messages sent. Some messages may not be delivered, such as when a customer's device is out of service. This metric doesn't include messages sent to Europe and Japan.",
17278
19437
  "type": "numeric string",
@@ -17327,26 +19486,14 @@ const FacebookMarketing = (function() {
17327
19486
  "GoogleSheetsFormat": "$#,##0.00",
17328
19487
  "GoogleBigQueryType": "numeric"
17329
19488
  },
17330
- "title_asset": {
17331
- "description": "title_asset",
17332
- "type": "AdAssetTitle"
17333
- },
17334
19489
  "updated_time": {
17335
19490
  "description": "updated_time",
17336
19491
  "type": "string"
17337
19492
  },
17338
- "user_segment_key": {
17339
- "description": "user_segment_key",
17340
- "type": "string"
17341
- },
17342
19493
  "video_30_sec_watched_actions": {
17343
19494
  "description": "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.",
17344
19495
  "type": "list<AdsActionStats>"
17345
19496
  },
17346
- "video_asset": {
17347
- "description": "video_asset",
17348
- "type": "AdAssetVideo"
17349
- },
17350
19497
  "video_avg_time_watched_actions": {
17351
19498
  "description": "The average time a video was played, including any time spent replaying the video for a single impression.",
17352
19499
  "type": "list<AdsActionStats>"
@@ -17413,7 +19560,7 @@ const FacebookMarketing = (function() {
17413
19560
  "GoogleBigQueryType": "numeric"
17414
19561
  }
17415
19562
  };
17416
- var adAccountInsightsFieldsByCountry = {
19563
+ var adAccountInsightsFieldsByAgeAndGender = {
17417
19564
  "account_currency": {
17418
19565
  "description": "Currency that is used by your ad account.",
17419
19566
  "type": "string"
@@ -17461,6 +19608,10 @@ const FacebookMarketing = (function() {
17461
19608
  "description": "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.",
17462
19609
  "type": "string"
17463
19610
  },
19611
+ "age": {
19612
+ "description": "The age range of the people who saw your ad. This is based on the age people have listed in their Facebook profiles.",
19613
+ "type": "string"
19614
+ },
17464
19615
  "attribution_setting": {
17465
19616
  "description": "The default attribution window to be used when attribution result is calculated. Each ad set has its own attribution setting value. The attribution setting for campaign or account is calculated based on existing ad sets.",
17466
19617
  "type": "string"
@@ -17480,10 +19631,6 @@ const FacebookMarketing = (function() {
17480
19631
  "type": "numeric string",
17481
19632
  "GoogleBigQueryType": "numeric"
17482
19633
  },
17483
- "body_asset": {
17484
- "description": "body_asset",
17485
- "type": "AdAssetBody"
17486
- },
17487
19634
  "buying_type": {
17488
19635
  "description": "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.",
17489
19636
  "type": "string"
@@ -17532,10 +19679,6 @@ const FacebookMarketing = (function() {
17532
19679
  "type": "numeric string",
17533
19680
  "GoogleBigQueryType": "numeric"
17534
19681
  },
17535
- "country": {
17536
- "description": "The country where the people you've reached are located. This is based on information, such as a person's hometown, their current city, and the geographical location where they tend to be when they visit Meta.",
17537
- "type": "string"
17538
- },
17539
19682
  "conversion_values": {
17540
19683
  "description": "conversion_values",
17541
19684
  "type": "list<AdsActionStats>"
@@ -17665,10 +19808,6 @@ const FacebookMarketing = (function() {
17665
19808
  "description": "dda_results",
17666
19809
  "type": "list<AdsInsightsDdaResult>"
17667
19810
  },
17668
- "description_asset": {
17669
- "description": "description_asset",
17670
- "type": "AdAssetDescription"
17671
- },
17672
19811
  "frequency": {
17673
19812
  "description": "The average number of times each person saw your ad. This metric is estimated.",
17674
19813
  "type": "numeric string",
@@ -17684,9 +19823,9 @@ const FacebookMarketing = (function() {
17684
19823
  "type": "numeric string",
17685
19824
  "GoogleBigQueryType": "numeric"
17686
19825
  },
17687
- "image_asset": {
17688
- "description": "image_asset",
17689
- "type": "AdAssetImage"
19826
+ "gender": {
19827
+ "description": "The gender of the people who saw your ad. This is based on the gender people have listed in their Facebook profiles.",
19828
+ "type": "string"
17690
19829
  },
17691
19830
  "impressions": {
17692
19831
  "description": "The number of times your ads were on screen.",
@@ -17785,26 +19924,14 @@ const FacebookMarketing = (function() {
17785
19924
  "GoogleSheetsFormat": "$#,##0.00",
17786
19925
  "GoogleBigQueryType": "numeric"
17787
19926
  },
17788
- "title_asset": {
17789
- "description": "title_asset",
17790
- "type": "AdAssetTitle"
17791
- },
17792
19927
  "updated_time": {
17793
19928
  "description": "updated_time",
17794
19929
  "type": "string"
17795
19930
  },
17796
- "user_segment_key": {
17797
- "description": "user_segment_key",
17798
- "type": "string"
17799
- },
17800
19931
  "video_30_sec_watched_actions": {
17801
19932
  "description": "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.",
17802
19933
  "type": "list<AdsActionStats>"
17803
19934
  },
17804
- "video_asset": {
17805
- "description": "video_asset",
17806
- "type": "AdAssetVideo"
17807
- },
17808
19935
  "video_avg_time_watched_actions": {
17809
19936
  "description": "The average time a video was played, including any time spent replaying the video for a single impression.",
17810
19937
  "type": "list<AdsActionStats>"
@@ -18488,6 +20615,16 @@ const FacebookMarketing = (function() {
18488
20615
  "destinationName": "facebook_ads_ad_account_insights",
18489
20616
  "limit": 500
18490
20617
  },
20618
+ "ad-account/insights-by-age-and-gender": {
20619
+ "description": "Interface for insights with breakdown by age and gender.",
20620
+ "documentation": "https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights",
20621
+ "fields": adAccountInsightsFieldsByAgeAndGender,
20622
+ "breakdowns": ["age", "gender"],
20623
+ "uniqueKeys": ["ad_id", "date_start", "date_stop", "age", "gender"],
20624
+ "isTimeSeries": true,
20625
+ "destinationName": "facebook_ads_ad_account_insights_by_age_and_gender",
20626
+ "limit": 500
20627
+ },
18491
20628
  "ad-account/insights-by-country": {
18492
20629
  "description": "Interface for insights with breakdown by country.",
18493
20630
  "documentation": "https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights",
@@ -18498,6 +20635,16 @@ const FacebookMarketing = (function() {
18498
20635
  "destinationName": "facebook_ads_ad_account_insights_by_country",
18499
20636
  "limit": 500
18500
20637
  },
20638
+ "ad-account/insights-by-device-platform": {
20639
+ "description": "Interface for insights with breakdown by device platform.",
20640
+ "documentation": "https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights",
20641
+ "fields": adAccountInsightsFieldsByDevicePlatform,
20642
+ "breakdowns": ["device_platform"],
20643
+ "uniqueKeys": ["ad_id", "date_start", "date_stop", "device_platform"],
20644
+ "isTimeSeries": true,
20645
+ "destinationName": "facebook_ads_ad_account_insights_by_device_platform",
20646
+ "limit": 500
20647
+ },
18501
20648
  "ad-account/insights-by-link-url-asset": {
18502
20649
  "description": "Interface for insights with breakdown by link URL asset.",
18503
20650
  "documentation": "https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights",
@@ -18508,6 +20655,36 @@ const FacebookMarketing = (function() {
18508
20655
  "destinationName": "facebook_ads_ad_account_insights_by_link_url_asset",
18509
20656
  "limit": 500
18510
20657
  },
20658
+ "ad-account/insights-by-product-id": {
20659
+ "description": "Interface for insights with breakdown by product ID.",
20660
+ "documentation": "https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights",
20661
+ "fields": adAccountInsightsFieldsByProductId,
20662
+ "breakdowns": ["product_id"],
20663
+ "uniqueKeys": ["ad_id", "date_start", "date_stop", "product_id"],
20664
+ "isTimeSeries": true,
20665
+ "destinationName": "facebook_ads_ad_account_insights_by_product_id",
20666
+ "limit": 500
20667
+ },
20668
+ "ad-account/insights-by-publisher-platform-and-position": {
20669
+ "description": "Interface for insights with breakdown by publisher platform and position.",
20670
+ "documentation": "https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights",
20671
+ "fields": adAccountInsightsFieldsByPublisherPlatformAndPosition,
20672
+ "breakdowns": ["publisher_platform", "platform_position"],
20673
+ "uniqueKeys": ["ad_id", "date_start", "date_stop", "publisher_platform", "platform_position"],
20674
+ "isTimeSeries": true,
20675
+ "destinationName": "facebook_ads_ad_account_insights_by_publisher_platform_and_position",
20676
+ "limit": 500
20677
+ },
20678
+ "ad-account/insights-by-region": {
20679
+ "description": "Interface for insights with breakdown by region.",
20680
+ "documentation": "https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights",
20681
+ "fields": adAccountInsightsFieldsByRegion,
20682
+ "breakdowns": ["region"],
20683
+ "uniqueKeys": ["ad_id", "date_start", "date_stop", "region"],
20684
+ "isTimeSeries": true,
20685
+ "destinationName": "facebook_ads_ad_account_insights_by_region",
20686
+ "limit": 500
20687
+ },
18511
20688
  "ad-group": {
18512
20689
  "overview": "Ad",
18513
20690
  "description": "Contains information for an ad, such as creative elements and measurement information.",
@@ -18723,16 +20900,21 @@ const FacebookMarketing = (function() {
18723
20900
  case "ad-account/insights":
18724
20901
  case "ad-account/insights-by-country":
18725
20902
  case "ad-account/insights-by-link-url-asset":
20903
+ case "ad-account/insights-by-publisher-platform-and-position":
20904
+ case "ad-account/insights-by-device-platform":
20905
+ case "ad-account/insights-by-region":
20906
+ case "ad-account/insights-by-product-id":
20907
+ case "ad-account/insights-by-age-and-gender":
18726
20908
  return this._fetchInsightsData({ nodeName, accountId, fields, timeRange, url });
18727
20909
  case "ad-group":
18728
- url += `act_${accountId}/ads?fields=${fields.join(",")}&limit=${this.fieldsSchema[nodeName].limit}`;
20910
+ url += `act_${accountId}/ads?fields=${this._buildFieldsString({ nodeName, fields })}&limit=${this.fieldsSchema[nodeName].limit}`;
18729
20911
  break;
18730
20912
  default:
18731
20913
  throw new Error(`End point for ${nodeName} is not implemented yet. Feel free add idea here: https://github.com/OWOX/owox-data-marts/discussions/categories/ideas`);
18732
20914
  }
18733
20915
  console.log(`Facebook API URL:`, url);
18734
20916
  url += `&access_token=${this.config.AccessToken.value}`;
18735
- return this._fetchPaginatedData(url, nodeName);
20917
+ return this._fetchPaginatedData(url, nodeName, fields);
18736
20918
  }
18737
20919
  //---- castRecordFields -------------------------------------------------
18738
20920
  /**
@@ -18805,7 +20987,7 @@ const FacebookMarketing = (function() {
18805
20987
  nodeName,
18806
20988
  url
18807
20989
  });
18808
- const allData = this._fetchPaginatedData(requestUrl, nodeName);
20990
+ const allData = this._fetchPaginatedData(requestUrl, nodeName, fields);
18809
20991
  if (this.config.ProcessShortLinks.value && allData.length > 0 && allData.some((record) => record.link_url_asset)) {
18810
20992
  return processShortLinks(allData, {
18811
20993
  shortLinkField: "link_url_asset",
@@ -18847,6 +21029,7 @@ const FacebookMarketing = (function() {
18847
21029
  * @private
18848
21030
  */
18849
21031
  _buildInsightsUrl({ accountId, fields, breakdowns, timeRange, nodeName, url }) {
21032
+ console.log("Insights request fields for", nodeName, ":", fields);
18850
21033
  let insightsUrl = `${url}act_${accountId}/insights?level=ad&period=day&time_range=${timeRange}&fields=${fields.join(",")}&limit=${this.fieldsSchema[nodeName].limit}`;
18851
21034
  if (breakdowns.length > 0) {
18852
21035
  insightsUrl += `&breakdowns=${breakdowns.join(",")}`;
@@ -18855,17 +21038,97 @@ const FacebookMarketing = (function() {
18855
21038
  insightsUrl += `&access_token=${this.config.AccessToken.value}`;
18856
21039
  return insightsUrl;
18857
21040
  }
21041
+ //---- _buildFieldsString ------------------------------------------------
21042
+ /**
21043
+ * Build fields string for Facebook API request
21044
+ * Filters out fields that don't exist in schema
21045
+ * Handles nested fields using Facebook's syntax: parent{field1,field2}
21046
+ *
21047
+ * @param {Object} params - Parameters object
21048
+ * @param {string} params.nodeName - Node name
21049
+ * @param {Array} params.fields - Fields to fetch
21050
+ * @return {string} Fields string for API request
21051
+ * @private
21052
+ */
21053
+ _buildFieldsString({ nodeName, fields }) {
21054
+ const nestedFields = {};
21055
+ const regularFields = [];
21056
+ const skippedFields = [];
21057
+ for (const field of fields) {
21058
+ const fieldConfig = this.fieldsSchema[nodeName].fields[field];
21059
+ if (!fieldConfig) {
21060
+ skippedFields.push(field);
21061
+ continue;
21062
+ }
21063
+ if (fieldConfig.apiName && fieldConfig.apiName.includes(".")) {
21064
+ const [parent, ...childParts] = fieldConfig.apiName.split(".");
21065
+ const child = childParts.join(".");
21066
+ if (!nestedFields[parent]) {
21067
+ nestedFields[parent] = [];
21068
+ }
21069
+ nestedFields[parent].push(child);
21070
+ } else {
21071
+ regularFields.push(field);
21072
+ }
21073
+ }
21074
+ if (skippedFields.length > 0) {
21075
+ console.log(`Skipped fields not found in ${nodeName} schema:`, skippedFields.join(", "));
21076
+ }
21077
+ const finalFields = [...regularFields];
21078
+ for (const [parent, children] of Object.entries(nestedFields)) {
21079
+ finalFields.push(`${parent}{${children.join(",")}}`);
21080
+ }
21081
+ return finalFields.join(",");
21082
+ }
21083
+ //---- _mapResultToColumns -----------------------------------------------
21084
+ /**
21085
+ * Map API result to requested column names
21086
+ * Only includes fields that exist in schema and were requested
21087
+ * Handles nested fields using apiName mapping
21088
+ *
21089
+ * @param {Object} result - API response result
21090
+ * @param {string} nodeName - Node name for schema lookup
21091
+ * @param {Array<string>} requestedFields - Fields that were requested
21092
+ * @return {Object} Mapped result with only requested columns
21093
+ * @private
21094
+ */
21095
+ _mapResultToColumns(result, nodeName, requestedFields) {
21096
+ const mapped = {};
21097
+ for (const fieldName of requestedFields) {
21098
+ const fieldConfig = this.fieldsSchema[nodeName].fields[fieldName];
21099
+ if (!fieldConfig) {
21100
+ continue;
21101
+ }
21102
+ if (fieldConfig.apiName) {
21103
+ mapped[fieldName] = this._getNestedValue(result, fieldConfig.apiName);
21104
+ } else {
21105
+ mapped[fieldName] = result[fieldName];
21106
+ }
21107
+ }
21108
+ return mapped;
21109
+ }
21110
+ //---- _getNestedValue ---------------------------------------------------
21111
+ /**
21112
+ * Get nested value from object using dot-notation path
21113
+ * @param {Object} obj - Object to search in
21114
+ * @param {string} path - Dot-notation path (e.g. 'creative.id')
21115
+ * @return {*} Value at path or undefined
21116
+ * @private
21117
+ */
21118
+ _getNestedValue(obj, path) {
21119
+ return path.split(".").reduce((current, key) => current == null ? void 0 : current[key], obj);
21120
+ }
18858
21121
  //---- _fetchPaginatedData -----------------------------------------------
18859
21122
  /**
18860
21123
  * Fetch paginated data from Facebook API
18861
21124
  *
18862
21125
  * @param {string} initialUrl - Initial URL to fetch
18863
21126
  * @param {string} nodeName - Node name for field casting
18864
- * @param {string} logContext - Context for logging
21127
+ * @param {Array} fields - Fields that were requested
18865
21128
  * @return {Array} All fetched data
18866
21129
  * @private
18867
21130
  */
18868
- _fetchPaginatedData(initialUrl, nodeName, logContext = "") {
21131
+ _fetchPaginatedData(initialUrl, nodeName, fields) {
18869
21132
  var allData = [];
18870
21133
  var nextPageURL = initialUrl;
18871
21134
  while (nextPageURL) {
@@ -18873,8 +21136,10 @@ const FacebookMarketing = (function() {
18873
21136
  var jsonData = JSON.parse(response.getContentText());
18874
21137
  if ("data" in jsonData) {
18875
21138
  nextPageURL = jsonData.paging ? jsonData.paging.next : null;
18876
- jsonData.data.forEach((record) => {
18877
- record = this.castRecordFields(nodeName, record);
21139
+ jsonData.data.forEach((record, index) => {
21140
+ let mappedRecord = this._mapResultToColumns(record, nodeName, fields);
21141
+ mappedRecord = this.castRecordFields(nodeName, mappedRecord);
21142
+ jsonData.data[index] = mappedRecord;
18878
21143
  });
18879
21144
  allData = allData.concat(jsonData.data);
18880
21145
  } else {