Floodlight (CM360)
Platform Summary
Floodlight event and enhanced conversion contracts.
Scope
Primary execution surface: hybrid.
Developer Source Map
| Source | Reason |
|---|---|
| developers.google.com/doubleclick-advertisers/guides/conversions_ec | User Data Contracts |
RudderStack Cross-Check
No destination mapping linked for this platform.
Verified Contracts
User Data Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
default | city | hybrid | string | Conditional | Trim, lowercase, then SHA-256 hash | lowercase; trim whitespace | SHA-256 | <sha256(sanfrancisco)> | City is normalized before hashing. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | country | hybrid | string | Conditional | Trim, lowercase ISO alpha-2, then SHA-256 hash | lowercase; trim whitespace; ISO alpha-2 | SHA-256 | <sha256(us)> | Use lowercase 2-letter country code. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | email | hybrid | string | Conditional | Trim, lowercase, remove Gmail/Googlemail dots, then SHA-256 hash | lowercase; trim whitespace | SHA-256 | <sha256(alice@example.com)> | Owner docs require trimming, lowercasing, and Gmail/Googlemail dot removal before SHA-256. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | email (hashed) | hybrid | string | Conditional | SHA-256 hash of normalized email | SHA-256 hash of normalized email | SHA-256 | <sha256(alice@example.com)> | CM360 enhanced conversions require SHA-256 for email addresses. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | email (plain) | hybrid | string | Required | Trim whitespace, lowercase, remove dots before gmail.com/googlemail.com | lowercase; trim whitespace; remove dots | SHA-256 | alice@example.com | Google says these identifiers must be normalized and hashed using SHA-256. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | first_name | hybrid | string | Recommended | Lowercase only, no punctuation, then SHA-256 hash | lowercase; remove punctuation | SHA-256 | <sha256(alice)> | Roman alphabet recommended; UTF-8 allowed for special characters. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | first_name (hashed) | hybrid | string | Conditional | SHA-256 hash of normalized first name | SHA-256 hash of normalized first name | SHA-256 | <sha256(alice)> | First names are one of the user identifiers called out on the page. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | first_name (plain) | hybrid | string | Required | Trim whitespace and lowercase | lowercase; trim whitespace | Hashed (algorithm not explicitly specified) | alice | Google says first names must be normalized before hashing. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | last_name | hybrid | string | Recommended | Lowercase only, no punctuation, then SHA-256 hash | lowercase; remove punctuation | SHA-256 | <sha256(smith)> | Roman alphabet recommended; UTF-8 allowed for special characters. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | last_name (hashed) | hybrid | string | Conditional | SHA-256 hash of normalized last name | SHA-256 hash of normalized last name | SHA-256 | <sha256(smith)> | Last names are one of the user identifiers called out on the page. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | last_name (plain) | hybrid | string | Required | Trim whitespace and lowercase | lowercase; trim whitespace | Hashed (algorithm not explicitly specified) | smith | Google says last names must be normalized before hashing. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | phone | hybrid | string | Conditional | E.164 with country code and +, then SHA-256 hash | E.164; include country code | SHA-256 | <sha256(16505551234)> | Owner docs require E.164 formatting. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | phone (hashed) | hybrid | string | Conditional | SHA-256 hash of normalized E.164 phone | E.164 | SHA-256 | <sha256(16505551234)> | CM360 enhanced conversions require SHA-256 for phone numbers. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | phone (plain) | hybrid | string | Conditional | E.164 format with plus sign and country code | E.164; include country code | Hashed (algorithm not explicitly specified) | +16505551234 | Google explicitly requires E.164 formatting before hashing. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | state | hybrid | string | Conditional | Trim, lowercase 2-letter code, then SHA-256 hash | lowercase; trim whitespace | SHA-256 | <sha256(ca)> | Use the 2-letter ANSI abbreviation code. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | street_address | hybrid | string | Conditional | Trim, lowercase, then SHA-256 hash | lowercase; trim whitespace | SHA-256 | - | Street addresses are part of enhanced conversions. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | street_address (hashed) | hybrid | string | Conditional | SHA-256 hash of normalized street address | SHA-256 hash of normalized street address | SHA-256 | - | Street addresses are one of the user identifiers called out on the page. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | street_address (plain) | hybrid | string | Required | Trim whitespace and lowercase | lowercase; trim whitespace | Hashed (algorithm not explicitly specified) | - | Google says street addresses must be normalized before hashing. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
default | zip | hybrid | string | Conditional | Trim, lowercase, no spaces or dash, then SHA-256 hash | lowercase; trim whitespace | SHA-256 | <sha256(94105)> | Use first 5 digits for U.S. ZIP. | developers.google.com/doubleclick-advertisers/guides/conversions_ec | Verified | High |
Candidate / Needs Review Items
Event Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
event | allow_custom_scripts | hybrid | boolean | Optional | Boolean flag; true enables dynamic tags. | Not clearly specified | Not clearly specified | - | Common field in all event snippets. Not verified against canonical developer documentation. | support.google.com/campaignmanager/answer/7554821 | Needs manual review | High |
event | gtag_event_name | browser | string | Required | Event name used in Floodlight event snippets. | Not clearly specified | Not clearly specified | ["conversion","purchase"] | Counter snippets use conversion, sales snippets use purchase. Not verified against canonical developer documentation. | support.google.com/campaignmanager/answer/7554821 | Needs manual review | High |
event | quantity | hybrid | integer | Conditional | Number of items sold; integer greater than zero. | Not clearly specified | Not clearly specified | 2 | Required when counting method is items_sold. Not verified against canonical developer documentation. | support.google.com/campaignmanager/answer/7554821 | Needs manual review | High |
event | send_to | hybrid | string | Required | DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+[countingMethod]. | Not clearly specified | Not clearly specified | - | Routing field present in all Floodlight event snippets. Not verified against canonical developer documentation. | support.google.com/campaignmanager/answer/7554821 | Needs manual review | High |
event | transaction_id | browser | string | Conditional | Unique transaction/order identifier for sales tags. | Not clearly specified | Not clearly specified | ord-12345 | Used in Path to Conversion report; corresponds to ord parameter in image/iframe tags. Not verified against canonical developer documentation. | support.google.com/campaignmanager/answer/7554821 | Needs manual review | High |
event | value | browser | number | Conditional | Revenue value for sales tags; number without commas or currency symbols. | Not clearly specified | Not clearly specified | 123.45 | Used for sales tags and mapped to cost in image/iframe tags. Not verified against canonical developer documentation. | support.google.com/campaignmanager/answer/7554821 | Needs manual review | High |
Excluded Items
No excluded rows in this revision.
Last Reviewed
2026-03-30