Class: Google::Apis::DfareportingV4::Conversion
- Inherits:
-
Object
- Object
- Google::Apis::DfareportingV4::Conversion
- Includes:
- Core::Hashable, Core::JsonObjectSupport
- Defined in:
- lib/google/apis/dfareporting_v4/classes.rb,
lib/google/apis/dfareporting_v4/representations.rb,
lib/google/apis/dfareporting_v4/representations.rb
Overview
A Conversion represents when a user successfully performs a desired action after seeing an ad.
Instance Attribute Summary collapse
-
#ad_user_data_consent ⇒ String
This represents consent for ad user data.
-
#child_directed_treatment ⇒ Boolean
(also: #child_directed_treatment?)
Whether this particular request may come from a user under the age of 13, under COPPA compliance.
-
#custom_variables ⇒ Array<Google::Apis::DfareportingV4::CustomFloodlightVariable>
Custom floodlight variables.
-
#dclid ⇒ String
The display click ID.
-
#encrypted_user_id ⇒ String
The alphanumeric encrypted user ID.
-
#encrypted_user_id_candidates ⇒ Array<String>
A list of the alphanumeric encrypted user IDs.
-
#floodlight_activity_id ⇒ Fixnum
Floodlight Activity ID of this conversion.
-
#floodlight_configuration_id ⇒ Fixnum
Floodlight Configuration ID of this conversion.
-
#gclid ⇒ String
The Google click ID.
-
#impression_id ⇒ String
The impression ID.
-
#kind ⇒ String
Identifies what kind of resource this is.
-
#limit_ad_tracking ⇒ Boolean
(also: #limit_ad_tracking?)
Whether Limit Ad Tracking is enabled.
-
#match_id ⇒ String
The match ID field.
-
#mobile_device_id ⇒ String
The mobile device ID.
-
#non_personalized_ad ⇒ Boolean
(also: #non_personalized_ad?)
Whether the conversion was for a non personalized ad.
-
#ordinal ⇒ String
The ordinal of the conversion.
-
#quantity ⇒ Fixnum
The quantity of the conversion.
-
#timestamp_micros ⇒ Fixnum
The timestamp of conversion, in Unix epoch micros.
-
#treatment_for_underage ⇒ Boolean
(also: #treatment_for_underage?)
Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union's General Data Protection Regulation (GDPR).
-
#user_identifiers ⇒ Array<Google::Apis::DfareportingV4::UserIdentifier>
The user identifiers to enhance the conversion.
-
#value ⇒ Float
The value of the conversion.
Instance Method Summary collapse
-
#initialize(**args) ⇒ Conversion
constructor
A new instance of Conversion.
-
#update!(**args) ⇒ Object
Update properties of this object.
Constructor Details
#initialize(**args) ⇒ Conversion
Returns a new instance of Conversion.
2824 2825 2826 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2824 def initialize(**args) update!(**args) end |
Instance Attribute Details
#ad_user_data_consent ⇒ String
This represents consent for ad user data.
Corresponds to the JSON property adUserDataConsent
2682 2683 2684 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2682 def @ad_user_data_consent end |
#child_directed_treatment ⇒ Boolean Also known as: child_directed_treatment?
Whether this particular request may come from a user under the age of 13,
under COPPA compliance.
Corresponds to the JSON property childDirectedTreatment
2688 2689 2690 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2688 def child_directed_treatment @child_directed_treatment end |
#custom_variables ⇒ Array<Google::Apis::DfareportingV4::CustomFloodlightVariable>
Custom floodlight variables. This field may only be used when calling
batchinsert; it is not supported by batchupdate.
Corresponds to the JSON property customVariables
2695 2696 2697 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2695 def custom_variables @custom_variables end |
#dclid ⇒ String
The display click ID. This field is mutually exclusive with encryptedUserId,
encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, and impressionId.
This or encryptedUserId or encryptedUserIdCandidates[] or matchId or
mobileDeviceId or gclid or impressionId is a required field.
Corresponds to the JSON property dclid
2703 2704 2705 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2703 def dclid @dclid end |
#encrypted_user_id ⇒ String
The alphanumeric encrypted user ID. When set, encryptionInfo should also be
specified. This field is mutually exclusive with encryptedUserIdCandidates[],
matchId, mobileDeviceId, gclid, dclid, and impressionId. This or
encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or dclid or
impressionId is a required field.
Corresponds to the JSON property encryptedUserId
2712 2713 2714 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2712 def encrypted_user_id @encrypted_user_id end |
#encrypted_user_id_candidates ⇒ Array<String>
A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior
to the conversion timestamp will be used in the inserted conversion. If no
such user ID is found then the conversion will be rejected with
INVALID_ARGUMENT error. When set, encryptionInfo should also be specified.
This field may only be used when calling batchinsert; it is not supported by
batchupdate. This field is mutually exclusive with encryptedUserId, matchId,
mobileDeviceId, gclid dclid, and impressionId. This or encryptedUserId or
matchId or mobileDeviceId or gclid or dclid or impressionId is a required
field.
Corresponds to the JSON property encryptedUserIdCandidates
2725 2726 2727 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2725 def encrypted_user_id_candidates @encrypted_user_id_candidates end |
#floodlight_activity_id ⇒ Fixnum
Floodlight Activity ID of this conversion. This is a required field.
Corresponds to the JSON property floodlightActivityId
2730 2731 2732 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2730 def floodlight_activity_id @floodlight_activity_id end |
#floodlight_configuration_id ⇒ Fixnum
Floodlight Configuration ID of this conversion. This is a required field.
Corresponds to the JSON property floodlightConfigurationId
2735 2736 2737 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2735 def floodlight_configuration_id @floodlight_configuration_id end |
#gclid ⇒ String
The Google click ID. This field is mutually exclusive with encryptedUserId,
encryptedUserIdCandidates[], matchId, mobileDeviceId, dclid, and impressionId.
This or encryptedUserId or encryptedUserIdCandidates[] or matchId or
mobileDeviceId or dclid or impressionId is a required field.
Corresponds to the JSON property gclid
2743 2744 2745 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2743 def gclid @gclid end |
#impression_id ⇒ String
The impression ID. This field is mutually exclusive with encryptedUserId,
encryptedUserIdCandidates[], matchId, mobileDeviceId, and gclid. One of these
identifiers must be set.
Corresponds to the JSON property impressionId
2750 2751 2752 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2750 def impression_id @impression_id end |
#kind ⇒ String
Identifies what kind of resource this is. Value: the fixed string "
dfareporting#conversion".
Corresponds to the JSON property kind
2756 2757 2758 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2756 def kind @kind end |
#limit_ad_tracking ⇒ Boolean Also known as: limit_ad_tracking?
Whether Limit Ad Tracking is enabled. When set to true, the conversion will be
used for reporting but not targeting. This will prevent remarketing.
Corresponds to the JSON property limitAdTracking
2762 2763 2764 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2762 def limit_ad_tracking @limit_ad_tracking end |
#match_id ⇒ String
The match ID field. A match ID is your own first-party identifier that has
been synced with Google using the match ID feature in Floodlight. This field
is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[],
mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserId
orencryptedUserIdCandidates[] or mobileDeviceId or gclid or dclid or
impressionIdis a required field.
Corresponds to the JSON property matchId
2773 2774 2775 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2773 def match_id @match_id end |
#mobile_device_id ⇒ String
The mobile device ID. This field is mutually exclusive with encryptedUserId,
encryptedUserIdCandidates[], matchId, gclid, dclid, and impressionId. This or
encryptedUserId or encryptedUserIdCandidates[] or matchId or gclid or dclid or
impressionId is a required field.
Corresponds to the JSON property mobileDeviceId
2781 2782 2783 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2781 def mobile_device_id @mobile_device_id end |
#non_personalized_ad ⇒ Boolean Also known as: non_personalized_ad?
Whether the conversion was for a non personalized ad.
Corresponds to the JSON property nonPersonalizedAd
2786 2787 2788 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2786 def non_personalized_ad @non_personalized_ad end |
#ordinal ⇒ String
The ordinal of the conversion. Use this field to control how conversions of
the same user and day are de-duplicated. This is a required field.
Corresponds to the JSON property ordinal
2793 2794 2795 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2793 def ordinal @ordinal end |
#quantity ⇒ Fixnum
The quantity of the conversion. This is a required field.
Corresponds to the JSON property quantity
2798 2799 2800 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2798 def quantity @quantity end |
#timestamp_micros ⇒ Fixnum
The timestamp of conversion, in Unix epoch micros. This is a required field.
Corresponds to the JSON property timestampMicros
2803 2804 2805 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2803 def @timestamp_micros end |
#treatment_for_underage ⇒ Boolean Also known as: treatment_for_underage?
Whether this particular request may come from a user under the age of 16 (may
differ by country), under compliance with the European Union's General Data
Protection Regulation (GDPR).
Corresponds to the JSON property treatmentForUnderage
2810 2811 2812 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2810 def treatment_for_underage @treatment_for_underage end |
#user_identifiers ⇒ Array<Google::Apis::DfareportingV4::UserIdentifier>
The user identifiers to enhance the conversion. The maximum number of user
identifiers for each conversion is 5.
Corresponds to the JSON property userIdentifiers
2817 2818 2819 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2817 def user_identifiers @user_identifiers end |
#value ⇒ Float
The value of the conversion. This is a required field.
Corresponds to the JSON property value
2822 2823 2824 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2822 def value @value end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
2829 2830 2831 2832 2833 2834 2835 2836 2837 2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 2848 2849 2850 2851 |
# File 'lib/google/apis/dfareporting_v4/classes.rb', line 2829 def update!(**args) @ad_user_data_consent = args[:ad_user_data_consent] if args.key?(:ad_user_data_consent) @child_directed_treatment = args[:child_directed_treatment] if args.key?(:child_directed_treatment) @custom_variables = args[:custom_variables] if args.key?(:custom_variables) @dclid = args[:dclid] if args.key?(:dclid) @encrypted_user_id = args[:encrypted_user_id] if args.key?(:encrypted_user_id) @encrypted_user_id_candidates = args[:encrypted_user_id_candidates] if args.key?(:encrypted_user_id_candidates) @floodlight_activity_id = args[:floodlight_activity_id] if args.key?(:floodlight_activity_id) @floodlight_configuration_id = args[:floodlight_configuration_id] if args.key?(:floodlight_configuration_id) @gclid = args[:gclid] if args.key?(:gclid) @impression_id = args[:impression_id] if args.key?(:impression_id) @kind = args[:kind] if args.key?(:kind) @limit_ad_tracking = args[:limit_ad_tracking] if args.key?(:limit_ad_tracking) @match_id = args[:match_id] if args.key?(:match_id) @mobile_device_id = args[:mobile_device_id] if args.key?(:mobile_device_id) @non_personalized_ad = args[:non_personalized_ad] if args.key?(:non_personalized_ad) @ordinal = args[:ordinal] if args.key?(:ordinal) @quantity = args[:quantity] if args.key?(:quantity) @timestamp_micros = args[:timestamp_micros] if args.key?(:timestamp_micros) @treatment_for_underage = args[:treatment_for_underage] if args.key?(:treatment_for_underage) @user_identifiers = args[:user_identifiers] if args.key?(:user_identifiers) @value = args[:value] if args.key?(:value) end |