​
Prerequisites

Google Ads account with active campaigns
Admin or Standard access to Google Ads account
Conversion actions already created in Google Ads
Google Click ID (gclid) tracking enabled
Website tagged with Global Site Tag or Google Tag Manager

​
Authentication Steps

1

Connect Account

OneView Dashboard → Integrations → Google Ads → ConnectSign in with Google account that has ad access
2

Select Account

Choose Google Ads Customer ID from dropdownFormat: 123-456-7890
3

Grant Permissions

Required scopes:
  • View and manage Google Ads campaigns
  • Manage customer lists
  • View conversion tracking
4

Map Conversion Actions

Select OneView events → Map to Google conversion actionsExample: Purchase → Website Purchase (AW-123456789/abc)

​
Field Mappings

OneView FieldGoogle Ads FieldFormatRequired
emailhashedEmailSHA-256, lowercaseYes*
phonehashedPhoneNumberSHA-256, E.164Yes*
firstNameaddress.hashedFirstNameSHA-256No
lastNameaddress.hashedLastNameSHA-256No
cityaddress.cityPlaintextNo
stateaddress.state2-letter codeNo
postalCodeaddress.postalCodeNo spacesNo
countryaddress.countryISO 3166-1No
valueconversionValueDecimalYes
currencycurrencyCodeISO 4217Yes
order_idorderIdStringNo
gclidgclidStringRecommended
*At least one identifier required

​
Platform-Specific Features

​
Enhanced Conversions

Google Ads supports enhanced conversions for better matching: 
// Automatically sent when available
{
  hashedEmail: "SHA256(user@example.com)",
  hashedPhoneNumber: "SHA256(+12025551234)",
  conversionEnvironment: "WEB",
  conversionTime: "2024-01-15T10:30:00Z"
}

​
Fractional Attribution

Google uniquely supports fractional conversion values: 
// Multi-touch attribution example
{
  conversionValue: 0.4,  // 40% credit
  partialCredit: true
}

​
Customer Match Lists

Automatic audience sync capabilities:
  • Update frequency: Every 6 hours
  • Maximum list size: 100M users
  • Minimum list size: 1,000 users
  • Processing time: 6-12 hours
Google’s consent mode v2 integration: 
// Automatically handled based on user consent
{
  ad_storage: 'granted',
  analytics_storage: 'granted',
  ad_user_data: 'granted',
  ad_personalization: 'granted'
}

​
Limitations

Google-specific constraints to be aware of:
  • Conversion delay: 3-hour processing before appearing in reports
  • Modification window: Can’t modify conversions older than 55 days
  • Attribution models: View-through only for Display/Video campaigns
  • Offline conversions: Require GCLID or enhanced matching
  • Rate limits: 100 requests/second per account

​
Testing the Integration

1

Send Test Conversion

// Include GCLID in test
oneview.track('Purchase', {
  value: 1.00,
  currency: 'USD',
  gclid: 'TEST_GCLID_123'
});
2

Verify in Google Ads

Tools → Conversions → Your conversion actionCheck “Recent conversions” (may take 3 hours)
3

Check Diagnostics

Conversion action → Diagnostics tabAll should show green checkmarks

​
Common Error Messages

ErrorCauseSolution
INVALID_CUSTOMER_IDWrong account IDVerify Customer ID format (123-456-7890)
CONVERSION_ACTION_NOT_FOUNDConversion doesn’t existCreate conversion action in Google Ads first
TOO_RECENTConversion < 3 hours oldWait for Google processing
CLICK_NOT_FOUNDInvalid/expired GCLIDCheck GCLID capture and storage
DUPLICATE_ORDER_IDOrder ID already usedEnsure unique order IDs
INVALID_CONVERSION_DATE_TIMEFuture date or > 55 days oldCheck timestamp accuracy

​
Troubleshooting Tips

​
Next Steps

Test Events

Validate your setup

Configure Attribution

Set attribution models
Credentials OneView lets you connect your Google Account with OAuth, and will automatically handle all token updates for you in the backgroundTo access this integration, you’ll a Google Ads account with ADMIN or STANDARD access.

​
Enhanced Conversions

Make sure you align your Privacy Policy with to ensure regulatory compliance concerning the re-identification of users.
Descrizione sul fatto che vengano pescati in automatico in base a ads_user_data e ads_personalization

​
Required User Identifiers

PropertyDescription
NameFull name of user
AgeReported age
JoinedWhether the user joined the community

​
Smart Bidding

OneView Filtered Attributions is compatible with all Google Ads Smart Bidding strategies
In Google Ads you can use Smart Bidding strategies to help you reach your performance goals. Smart Bidding strategies use machine learning to optimize your bids in real-time:

​
Authorization

Spiegazione su developer token e oauth scopes, da linkare da app

​
Troubleshooting