@googleapis/searchads360 11.1.0 → 12.0.0
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.
- package/CHANGELOG.md +13 -0
- package/build/index.d.ts +5 -0
- package/build/index.js +4 -1
- package/build/index.js.map +1 -1
- package/build/tsconfig.tsbuildinfo +1 -1
- package/build/v0.d.ts +68 -34
- package/build/v0.js.map +1 -1
- package/build/v23.d.ts +42511 -0
- package/build/v23.js +6201 -0
- package/build/v23.js.map +1 -0
- package/index.ts +12 -2
- package/package.json +1 -1
- package/v0.ts +68 -34
- package/v23.ts +57177 -0
package/v0.ts
CHANGED
|
@@ -454,7 +454,7 @@ export namespace searchads360_v0 {
|
|
|
454
454
|
*/
|
|
455
455
|
allConversions?: number | null;
|
|
456
456
|
/**
|
|
457
|
-
* The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.
|
|
457
|
+
* The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the `by_conversion_date` columns are available at [About the "All conversions" column](https://support.google.com/sa360/answer/9250611).
|
|
458
458
|
*/
|
|
459
459
|
allConversionsByConversionDate?: number | null;
|
|
460
460
|
/**
|
|
@@ -498,7 +498,7 @@ export namespace searchads360_v0 {
|
|
|
498
498
|
*/
|
|
499
499
|
allConversionsValue?: number | null;
|
|
500
500
|
/**
|
|
501
|
-
* The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.
|
|
501
|
+
* The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the `by_conversion_date` columns are available at [About the "All conversions" column](https://support.google.com/sa360/answer/9250611).
|
|
502
502
|
*/
|
|
503
503
|
allConversionsValueByConversionDate?: number | null;
|
|
504
504
|
/**
|
|
@@ -514,11 +514,11 @@ export namespace searchads360_v0 {
|
|
|
514
514
|
*/
|
|
515
515
|
averageCost?: number | null;
|
|
516
516
|
/**
|
|
517
|
-
* The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
517
|
+
* The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
518
518
|
*/
|
|
519
519
|
averageCpc?: number | null;
|
|
520
520
|
/**
|
|
521
|
-
* Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
521
|
+
* Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
522
522
|
*/
|
|
523
523
|
averageCpm?: number | null;
|
|
524
524
|
/**
|
|
@@ -538,23 +538,23 @@ export namespace searchads360_v0 {
|
|
|
538
538
|
*/
|
|
539
539
|
clicks?: string | null;
|
|
540
540
|
/**
|
|
541
|
-
* The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true
|
|
541
|
+
* The number of client account conversions. This only includes conversion actions which `include_in_client_account_conversions_metric` attribute is set to `true`. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
|
|
542
542
|
*/
|
|
543
543
|
clientAccountConversions?: number | null;
|
|
544
544
|
/**
|
|
545
|
-
* The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true
|
|
545
|
+
* The value of client account conversions. This only includes conversion actions which `include_in_client_account_conversions_metric` attribute is set to `true`. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
|
|
546
546
|
*/
|
|
547
547
|
clientAccountConversionsValue?: number | null;
|
|
548
548
|
/**
|
|
549
|
-
* Client account cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
549
|
+
* Client account cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
550
550
|
*/
|
|
551
551
|
clientAccountCrossSellCostOfGoodsSoldMicros?: string | null;
|
|
552
552
|
/**
|
|
553
|
-
* Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
553
|
+
* Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
554
554
|
*/
|
|
555
555
|
clientAccountCrossSellGrossProfitMicros?: string | null;
|
|
556
556
|
/**
|
|
557
|
-
* Client account cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
557
|
+
* Client account cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
558
558
|
*/
|
|
559
559
|
clientAccountCrossSellRevenueMicros?: string | null;
|
|
560
560
|
/**
|
|
@@ -562,15 +562,15 @@ export namespace searchads360_v0 {
|
|
|
562
562
|
*/
|
|
563
563
|
clientAccountCrossSellUnitsSold?: number | null;
|
|
564
564
|
/**
|
|
565
|
-
* Client account lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
565
|
+
* Client account lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
566
566
|
*/
|
|
567
567
|
clientAccountLeadCostOfGoodsSoldMicros?: string | null;
|
|
568
568
|
/**
|
|
569
|
-
* Client account lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
569
|
+
* Client account lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
570
570
|
*/
|
|
571
571
|
clientAccountLeadGrossProfitMicros?: string | null;
|
|
572
572
|
/**
|
|
573
|
-
* Client account lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
573
|
+
* Client account lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
574
574
|
*/
|
|
575
575
|
clientAccountLeadRevenueMicros?: string | null;
|
|
576
576
|
/**
|
|
@@ -602,7 +602,7 @@ export namespace searchads360_v0 {
|
|
|
602
602
|
*/
|
|
603
603
|
conversions?: number | null;
|
|
604
604
|
/**
|
|
605
|
-
* The sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in date column
|
|
605
|
+
* The sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in the date column mean the conversion date.
|
|
606
606
|
*/
|
|
607
607
|
conversionsByConversionDate?: number | null;
|
|
608
608
|
/**
|
|
@@ -610,7 +610,7 @@ export namespace searchads360_v0 {
|
|
|
610
610
|
*/
|
|
611
611
|
conversionsFromInteractionsRate?: number | null;
|
|
612
612
|
/**
|
|
613
|
-
* The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true
|
|
613
|
+
* The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which `include_in_conversions_metric` attribute is set to `true`. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
|
|
614
614
|
*/
|
|
615
615
|
conversionsFromInteractionsValuePerInteraction?: number | null;
|
|
616
616
|
/**
|
|
@@ -626,7 +626,7 @@ export namespace searchads360_v0 {
|
|
|
626
626
|
*/
|
|
627
627
|
conversionsValuePerCost?: number | null;
|
|
628
628
|
/**
|
|
629
|
-
* The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
629
|
+
* The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause) for more details.
|
|
630
630
|
*/
|
|
631
631
|
costMicros?: string | null;
|
|
632
632
|
/**
|
|
@@ -642,15 +642,15 @@ export namespace searchads360_v0 {
|
|
|
642
642
|
*/
|
|
643
643
|
costPerConversion?: number | null;
|
|
644
644
|
/**
|
|
645
|
-
* The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true
|
|
645
|
+
* The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which `include_in_conversions_metric` attribute is set to `true`. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
|
|
646
646
|
*/
|
|
647
647
|
costPerCurrentModelAttributedConversion?: number | null;
|
|
648
648
|
/**
|
|
649
|
-
* Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions
|
|
649
|
+
* Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in `all_conversions`.
|
|
650
650
|
*/
|
|
651
651
|
crossDeviceConversions?: number | null;
|
|
652
652
|
/**
|
|
653
|
-
* The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611
|
|
653
|
+
* The number of cross-device conversions by conversion date. Details for the `by_conversion_date` columns are available at [About the "All conversions" column](https://support.google.com/sa360/answer/9250611)
|
|
654
654
|
*/
|
|
655
655
|
crossDeviceConversionsByConversionDate?: number | null;
|
|
656
656
|
/**
|
|
@@ -658,19 +658,19 @@ export namespace searchads360_v0 {
|
|
|
658
658
|
*/
|
|
659
659
|
crossDeviceConversionsValue?: number | null;
|
|
660
660
|
/**
|
|
661
|
-
* The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611
|
|
661
|
+
* The sum of cross-device conversions value by conversion date. Details for the `by_conversion_date` columns are available at [About the "All conversions" column](https://support.google.com/sa360/answer/9250611)
|
|
662
662
|
*/
|
|
663
663
|
crossDeviceConversionsValueByConversionDate?: number | null;
|
|
664
664
|
/**
|
|
665
|
-
* Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
665
|
+
* Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
666
666
|
*/
|
|
667
667
|
crossSellCostOfGoodsSoldMicros?: string | null;
|
|
668
668
|
/**
|
|
669
|
-
* Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
669
|
+
* Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
670
670
|
*/
|
|
671
671
|
crossSellGrossProfitMicros?: string | null;
|
|
672
672
|
/**
|
|
673
|
-
* Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
673
|
+
* Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
674
674
|
*/
|
|
675
675
|
crossSellRevenueMicros?: string | null;
|
|
676
676
|
/**
|
|
@@ -682,11 +682,11 @@ export namespace searchads360_v0 {
|
|
|
682
682
|
*/
|
|
683
683
|
ctr?: number | null;
|
|
684
684
|
/**
|
|
685
|
-
* The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See
|
|
685
|
+
* The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See [Filtering invalid traffic to ensure quality](https://support.google.com/campaignmanager/answer/6076504).
|
|
686
686
|
*/
|
|
687
687
|
generalInvalidClickRate?: number | null;
|
|
688
688
|
/**
|
|
689
|
-
* Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See
|
|
689
|
+
* Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See [Filtering invalid traffic to ensure quality](https://support.google.com/campaignmanager/answer/6076504).
|
|
690
690
|
*/
|
|
691
691
|
generalInvalidClicks?: string | null;
|
|
692
692
|
/**
|
|
@@ -738,15 +738,15 @@ export namespace searchads360_v0 {
|
|
|
738
738
|
*/
|
|
739
739
|
invalidClicks?: string | null;
|
|
740
740
|
/**
|
|
741
|
-
* Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
741
|
+
* Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
742
742
|
*/
|
|
743
743
|
leadCostOfGoodsSoldMicros?: string | null;
|
|
744
744
|
/**
|
|
745
|
-
* Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
745
|
+
* Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
746
746
|
*/
|
|
747
747
|
leadGrossProfitMicros?: string | null;
|
|
748
748
|
/**
|
|
749
|
-
* Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
|
|
749
|
+
* Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the `metrics_currency` parameter at [PARAMETERS clause](https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause).
|
|
750
750
|
*/
|
|
751
751
|
leadRevenueMicros?: string | null;
|
|
752
752
|
/**
|
|
@@ -770,7 +770,7 @@ export namespace searchads360_v0 {
|
|
|
770
770
|
*/
|
|
771
771
|
revenueMicros?: string | null;
|
|
772
772
|
/**
|
|
773
|
-
* The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999.
|
|
773
|
+
* The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See [About top and absolute top metrics](https://support.google.com/sa360/answer/9566729) for details. Any value below 0.1 is reported as 0.0999.
|
|
774
774
|
*/
|
|
775
775
|
searchAbsoluteTopImpressionShare?: number | null;
|
|
776
776
|
/**
|
|
@@ -782,7 +782,7 @@ export namespace searchads360_v0 {
|
|
|
782
782
|
*/
|
|
783
783
|
searchBudgetLostImpressionShare?: number | null;
|
|
784
784
|
/**
|
|
785
|
-
* The
|
|
785
|
+
* The estimated percent of times that your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
|
|
786
786
|
*/
|
|
787
787
|
searchBudgetLostTopImpressionShare?: number | null;
|
|
788
788
|
/**
|
|
@@ -830,7 +830,7 @@ export namespace searchads360_v0 {
|
|
|
830
830
|
*/
|
|
831
831
|
valuePerAllConversions?: number | null;
|
|
832
832
|
/**
|
|
833
|
-
* The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.
|
|
833
|
+
* The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the `by_conversion_date` columns are available at [About the "All conversions" column](https://support.google.com/sa360/answer/9250611).
|
|
834
834
|
*/
|
|
835
835
|
valuePerAllConversionsByConversionDate?: number | null;
|
|
836
836
|
/**
|
|
@@ -899,7 +899,7 @@ export namespace searchads360_v0 {
|
|
|
899
899
|
description2?: string | null;
|
|
900
900
|
}
|
|
901
901
|
/**
|
|
902
|
-
* A Search Ads 360 expanded text ad.
|
|
902
|
+
* A Search Ads 360 expanded text ad. Expanded text ads are deprecated. Use SearchAds360ResponsiveSearchAd instead.
|
|
903
903
|
*/
|
|
904
904
|
export interface Schema$GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo {
|
|
905
905
|
/**
|
|
@@ -1294,6 +1294,32 @@ export namespace searchads360_v0 {
|
|
|
1294
1294
|
*/
|
|
1295
1295
|
year?: number | null;
|
|
1296
1296
|
}
|
|
1297
|
+
/**
|
|
1298
|
+
* Represents an attestation about synthetic content from a single source.
|
|
1299
|
+
*/
|
|
1300
|
+
export interface Schema$GoogleAdsSearchads360V0Common__SyntheticContentAttestation {
|
|
1301
|
+
/**
|
|
1302
|
+
* The source of the synthetic content attestation.
|
|
1303
|
+
*/
|
|
1304
|
+
source?: string | null;
|
|
1305
|
+
/**
|
|
1306
|
+
* Indicates whether the content is considered synthetic by this source.
|
|
1307
|
+
*/
|
|
1308
|
+
status?: string | null;
|
|
1309
|
+
}
|
|
1310
|
+
/**
|
|
1311
|
+
* Container for synthetic content attestations from different sources, such as the advertiser and Google systems.
|
|
1312
|
+
*/
|
|
1313
|
+
export interface Schema$GoogleAdsSearchads360V0Common__SyntheticContentInfo {
|
|
1314
|
+
/**
|
|
1315
|
+
* Input provided by the advertiser.
|
|
1316
|
+
*/
|
|
1317
|
+
advertiserAttestation?: Schema$GoogleAdsSearchads360V0Common__SyntheticContentAttestation;
|
|
1318
|
+
/**
|
|
1319
|
+
* Output only. Information about synthetic content generated by Google's systems.
|
|
1320
|
+
*/
|
|
1321
|
+
systemAttestation?: Schema$GoogleAdsSearchads360V0Common__SyntheticContentAttestation;
|
|
1322
|
+
}
|
|
1297
1323
|
/**
|
|
1298
1324
|
* An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
|
|
1299
1325
|
*/
|
|
@@ -2184,7 +2210,7 @@ export namespace searchads360_v0 {
|
|
|
2184
2210
|
*/
|
|
2185
2211
|
expandedDynamicSearchAd?: Schema$GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo;
|
|
2186
2212
|
/**
|
|
2187
|
-
* Immutable. Details pertaining to an expanded text ad.
|
|
2213
|
+
* Immutable. Details pertaining to an expanded text ad. Expanded text ads are deprecated. Use `SearchAds360ResponsiveSearchAd` instead.
|
|
2188
2214
|
*/
|
|
2189
2215
|
expandedTextAd?: Schema$GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo;
|
|
2190
2216
|
/**
|
|
@@ -2223,6 +2249,10 @@ export namespace searchads360_v0 {
|
|
|
2223
2249
|
* Immutable. Details pertaining to a responsive search ad.
|
|
2224
2250
|
*/
|
|
2225
2251
|
responsiveSearchAd?: Schema$GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo;
|
|
2252
|
+
/**
|
|
2253
|
+
* Synthetic content info for the ad. Only ads with specific ad types are eligible for updates using the `synthetic_content_info` field. Allowed `AdType` values: * `HTML5_UPLOAD_AD` * `DYNAMIC_HTML5_AD` * `IMAGE_AD`
|
|
2254
|
+
*/
|
|
2255
|
+
syntheticContentInfo?: Schema$GoogleAdsSearchads360V0Common__SyntheticContentInfo;
|
|
2226
2256
|
/**
|
|
2227
2257
|
* Immutable. Details pertaining to a text ad.
|
|
2228
2258
|
*/
|
|
@@ -2674,7 +2704,7 @@ export namespace searchads360_v0 {
|
|
|
2674
2704
|
resourceName?: string | null;
|
|
2675
2705
|
}
|
|
2676
2706
|
/**
|
|
2677
|
-
* An age range view.
|
|
2707
|
+
* An age range view. Represents the view of a customer's performance metrics (like impressions and clicks) aggregated by age range. All statistics are aggregated at the ad group level. Note: While you can segment metrics by age range using `age_range_view` or by gender using `gender_view`, the Search Ads 360 API does not support segmenting metrics by both age range and gender simultaneously in a single query. Analyzing performance across both dimensions combined is not supported in the Search Ads 360 API.
|
|
2678
2708
|
*/
|
|
2679
2709
|
export interface Schema$GoogleAdsSearchads360V0Resources__AgeRangeView {
|
|
2680
2710
|
/**
|
|
@@ -2758,6 +2788,10 @@ export namespace searchads360_v0 {
|
|
|
2758
2788
|
* Output only. The status of the asset.
|
|
2759
2789
|
*/
|
|
2760
2790
|
status?: string | null;
|
|
2791
|
+
/**
|
|
2792
|
+
* Synthetic content info for the asset. Only assets with specific asset types are eligible for updates using the `synthetic_content_info` field. Allowed `AssetType` values: * `IMAGE` * `MEDIA_BUNDLE` * `YOUTUBE_VIDEO`
|
|
2793
|
+
*/
|
|
2794
|
+
syntheticContentInfo?: Schema$GoogleAdsSearchads360V0Common__SyntheticContentInfo;
|
|
2761
2795
|
/**
|
|
2762
2796
|
* Output only. A text asset.
|
|
2763
2797
|
*/
|
|
@@ -3983,7 +4017,7 @@ export namespace searchads360_v0 {
|
|
|
3983
4017
|
resourceName?: string | null;
|
|
3984
4018
|
}
|
|
3985
4019
|
/**
|
|
3986
|
-
* A gender view
|
|
4020
|
+
* A gender view resource. Represents the view of a customer's performance metrics aggregated by gender. All statistics are aggregated at the ad group level. Note: While you can segment metrics by age range using `age_range_view` or by gender using `gender_view`, the Search Ads 360 API does not support segmenting metrics by both age range and gender simultaneously in a single query. Analyzing performance across both dimensions combined is not supported in the Search Ads 360 API.
|
|
3987
4021
|
*/
|
|
3988
4022
|
export interface Schema$GoogleAdsSearchads360V0Resources__GenderView {
|
|
3989
4023
|
/**
|