xref: /aosp_15_r20/external/googleapis/google/ads/googleads/v14/enums/custom_placeholder_field.proto (revision d5c09012810ac0c9f33fe448fb6da8260d444cc9) 
1// Copyright 2023 Google LLC
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15syntax = "proto3";
16
17package google.ads.googleads.v14.enums;
18
19option csharp_namespace = "Google.Ads.GoogleAds.V14.Enums";
20option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v14/enums;enums";
21option java_multiple_files = true;
22option java_outer_classname = "CustomPlaceholderFieldProto";
23option java_package = "com.google.ads.googleads.v14.enums";
24option objc_class_prefix = "GAA";
25option php_namespace = "Google\\Ads\\GoogleAds\\V14\\Enums";
26option ruby_package = "Google::Ads::GoogleAds::V14::Enums";
27
28// Proto file describing Custom placeholder fields.
29
30// Values for Custom placeholder fields.
31// For more information about dynamic remarketing feeds, see
32// https://support.google.com/google-ads/answer/6053288.
33message CustomPlaceholderFieldEnum {
34  // Possible values for Custom placeholder fields.
35  enum CustomPlaceholderField {
36    // Not specified.
37    UNSPECIFIED = 0;
38
39    // Used for return value only. Represents value unknown in this version.
40    UNKNOWN = 1;
41
42    // Data Type: STRING. Required. Combination ID and ID2 must be unique per
43    // offer.
44    ID = 2;
45
46    // Data Type: STRING. Combination ID and ID2 must be unique per offer.
47    ID2 = 3;
48
49    // Data Type: STRING. Required. Main headline with product name to be shown
50    // in dynamic ad.
51    ITEM_TITLE = 4;
52
53    // Data Type: STRING. Optional text to be shown in the image ad.
54    ITEM_SUBTITLE = 5;
55
56    // Data Type: STRING. Optional description of the product to be shown in the
57    // ad.
58    ITEM_DESCRIPTION = 6;
59
60    // Data Type: STRING. Full address of your offer or service, including
61    // postal code. This will be used to identify the closest product to the
62    // user when there are multiple offers in the feed that are relevant to the
63    // user.
64    ITEM_ADDRESS = 7;
65
66    // Data Type: STRING. Price to be shown in the ad.
67    // Example: "100.00 USD"
68    PRICE = 8;
69
70    // Data Type: STRING. Formatted price to be shown in the ad.
71    // Example: "Starting at $100.00 USD", "$80 - $100"
72    FORMATTED_PRICE = 9;
73
74    // Data Type: STRING. Sale price to be shown in the ad.
75    // Example: "80.00 USD"
76    SALE_PRICE = 10;
77
78    // Data Type: STRING. Formatted sale price to be shown in the ad.
79    // Example: "On sale for $80.00", "$60 - $80"
80    FORMATTED_SALE_PRICE = 11;
81
82    // Data Type: URL. Image to be displayed in the ad. Highly recommended for
83    // image ads.
84    IMAGE_URL = 12;
85
86    // Data Type: STRING. Used as a recommendation engine signal to serve items
87    // in the same category.
88    ITEM_CATEGORY = 13;
89
90    // Data Type: URL_LIST. Final URLs for the ad when using Upgraded
91    // URLs. User will be redirected to these URLs when they click on an ad, or
92    // when they click on a specific product for ads that have multiple
93    // products.
94    FINAL_URLS = 14;
95
96    // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded
97    // URLs.
98    FINAL_MOBILE_URLS = 15;
99
100    // Data Type: URL. Tracking template for the ad when using Upgraded URLs.
101    TRACKING_URL = 16;
102
103    // Data Type: STRING_LIST. Keywords used for product retrieval.
104    CONTEXTUAL_KEYWORDS = 17;
105
106    // Data Type: STRING. Android app link. Must be formatted as:
107    // android-app://{package_id}/{scheme}/{host_path}.
108    // The components are defined as follows:
109    // package_id: app ID as specified in Google Play.
110    // scheme: the scheme to pass to the application. Can be HTTP, or a custom
111    //   scheme.
112    // host_path: identifies the specific content within your application.
113    ANDROID_APP_LINK = 18;
114
115    // Data Type: STRING_LIST. List of recommended IDs to show together with
116    // this item.
117    SIMILAR_IDS = 19;
118
119    // Data Type: STRING. iOS app link.
120    IOS_APP_LINK = 20;
121
122    // Data Type: INT64. iOS app store ID.
123    IOS_APP_STORE_ID = 21;
124  }
125}
126