--- title: "Google Ads-koppling" description: "Komplett integrationsguide för Google Ads för att synka kampanjdata, målgruppslistor och konverteringsspårning med Brevo via Tajo." url: https://tajo.io/se/docs/connectors/marketing/google-ads/ markdown: https://tajo.io/se/docs/connectors/marketing/google-ads.md lang: sv-SE robots: noindex --- Ansök om tidig åtkomst Ange ditt förnamn och din e-postadress på jobbet. Vi skickar en länk för att bekräfta din begäran om åtkomst till Tajo. # Google Ads-koppling Kopplingens status: Planerad Inte byggd än. Tajo kör inte den här kopplingen i dag. | Källfält | Målfält | Exempelvärde | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Anslut Google Ads till Brevo via Tajo för att synkronisera annonsmålgrupper, importera konverteringsdata och skapa enhetliga kundprofiler som kopplar betald förvärvning till livscykelmarknadsföring. ## Översikt | Egenskap | Värde | | --- | --- | | **Plattform** | Google Ads | | **Kategori** | Marknadsföring | | **Installationskomplexitet** | Avancerad | | **Officiell integration** | Nej | | **Data som synkas** | Kampanjer, målgrupper, konverteringar, kunder | | **Tillgängliga skills** | 7 | ## Funktioner - **Customer Match-synk** - Ladda upp Brevo-kontaktlistor till Google Ads som Customer Match-målgrupper - **Konverteringsspårning** - Importera offlinekonverteringar från Brevo-händelser till Google Ads - **Målgruppssynk** - Dubbelriktad synk mellan Brevo-listor och Google Ads-målgrupper - **Kampanjrapportering** - Hämta kampanjprestandadata till Tajo-dashboards - **GCLID-spårning** - Fånga Google Click ID:n för attribution av offlinekonverteringar - **Data för smart bidding** - Skicka tillbaka konverteringsvärdesdata till Google för budoptimering - **Lead-formulärsynk** - Importera Google Ads lead-formulärinskickningar som Brevo-kontakter ## Förutsättningar Innan du börjar, se till att du har: 1. Ett Google Ads-konto med API-åtkomst aktiverad 2. Ett Google Cloud-projekt med Google Ads API aktiverat 3. OAuth 2.0-uppgifter (Client ID och Client Secret) 4. En Google Ads Developer Token (ansök i [Google Ads API Center](https://ads.google.com/aw/apicenter)) 5. Ett Brevo-konto med API-åtkomst 6. Ett Tajo-konto med API-uppgifter ## Autentisering ### OAuth 2.0 Google Ads API använder OAuth 2.0 för autentisering. Du behöver skaffa en refresh token via OAuth-samtyckesflödet. ```bash # Required OAuth scopes https://www.googleapis.com/auth/adwords ``` ### Developer Token En Developer Token krävs för alla Google Ads API-förfrågningar och måste godkännas av Google. ```bash # Set up authentication headers curl -X POST https://googleads.googleapis.com/v18/customers/1234567890/googleAds:search \ -H "Authorization: Bearer ACCESS_TOKEN" \ -H "developer-token: DEVELOPER_TOKEN" \ -H "login-customer-id: MANAGER_ACCOUNT_ID" ``` ## Konfiguration ### Grundläggande konfiguration ```yaml connectors: google_ads: enabled: true developer_token: "your-developer-token" oauth: client_id: "your-client-id" client_secret: "your-client-secret" refresh_token: "your-refresh-token" customer_id: "123-456-7890" login_customer_id: "111-222-3333" # Manager account (optional) # Data sync options sync: customer_match: true conversions: true campaigns: true lead_forms: true # Conversion tracking conversions: action_id: "123456789" default_currency: "USD" ``` ### Konfiguration för Customer Match Ladda upp Brevo-kontakter som Google Ads-målgrupper: ```yaml customer_match: enabled: true lists: - brevo_list_id: 5 audience_name: "All Customers" match_type: "CONTACT_INFO" - brevo_list_id: 7 audience_name: "High Value Customers" match_type: "CONTACT_INFO" # Data fields to match match_fields: - email - phone - first_name - last_name - country_code - zip_code # Sync schedule schedule: "daily" sync_mode: "mirror" # mirror, append, or remove ``` ### Import av offlinekonverteringar ```yaml conversion_import: enabled: true conversion_action: "purchase" gclid_attribute: "GCLID" # Brevo attribute storing GCLID conversion_events: - brevo_event: "order_completed" conversion_name: "Purchase" value_field: "revenue" - brevo_event: "subscription_created" conversion_name: "Subscription" value_field: "plan_value" ``` ## API-ändpunkter | Metod | Ändpunkt | Beskrivning | | --- | --- | --- | | `POST` | `/v18/customers/{id}/googleAds:search` | Sök kampanjer och resurser (GAQL) | | `POST` | `/v18/customers/{id}/googleAds:searchStream` | Streama sökresultat | | `POST` | `/v18/customers/{id}/offlineUserDataJobs:create` | Skapa Customer Match-uppladdningsjobb | | `POST` | `/v18/customers/{id}/conversionUploads:uploadClickConversions` | Ladda upp offlinekonverteringar | | `POST` | `/v18/customers/{id}/conversionUploads:uploadCallConversions` | Ladda upp samtalskonverteringar | | `GET` | `/v18/customers/{id}/campaignBudgets` | Hämta kampanjbudgetar | | `POST` | `/v18/customers/{id}/customerLists:mutate` | Hantera kundlistor | ## Kodexempel ### Initiera Google Ads-kopplingen ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); // Connect Google Ads account await tajo.connectors.connect('google-ads', { developerToken: process.env.GOOGLE_ADS_DEV_TOKEN, clientId: process.env.GOOGLE_OAUTH_CLIENT_ID, clientSecret: process.env.GOOGLE_OAUTH_CLIENT_SECRET, refreshToken: process.env.GOOGLE_OAUTH_REFRESH_TOKEN, customerId: '123-456-7890' }); ``` ### Ladda upp Customer Match-målgrupp ```javascript // Sync a Brevo list to Google Ads Customer Match await tajo.connectors.syncAudience('google-ads', { brevoListId: 5, audienceName: 'High Value Customers', matchType: 'CONTACT_INFO', syncMode: 'mirror' }); ``` ### Importera offlinekonverteringar ```javascript // Upload offline conversions from Brevo order events await tajo.connectors.uploadConversions('google-ads', { conversionAction: 'customers/123456/conversionActions/789', conversions: [ { gclid: 'CjwKCAiA...', conversionDateTime: '2024-01-15 10:30:00-05:00', conversionValue: 89.99, currencyCode: 'USD' } ] }); ``` ### Fråga om kampanjprestanda (GAQL) ```javascript // Query campaign metrics using Google Ads Query Language const query = ` SELECT campaign.name, campaign.status, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.impressions DESC LIMIT 20 `; const results = await tajo.connectors.query('google-ads', { gaql: query }); ``` ## API-gränser | Resurs | Gräns | Detaljer | | --- | --- | --- | | **API-förfrågningar** | 15 000/dag | Per developer token | | **Mutate-operationer** | 10 000/dag | Per kundkonto | | **GAQL-frågor** | 1 500/dag | Per kundkonto | | **Customer Match-uppladdningar** | 10 jobb/dag | Per kundlista | | **Konverteringsuppladdningar** | 2 000/förfrågan | Per uppladdningsbatch | | **Sidstorlek** | 10 000 rader | Max per sökresultatsvar | Godkännande av Developer Token Google Ads API kräver en godkänd Developer Token. Ansök via Google Ads API Center i ditt Manager-konto. Testkonton har reducerade rate limits. ## Felsökning | Problem | Orsak | Lösning | | --- | --- | --- | | `DEVELOPER_TOKEN_NOT_APPROVED` | Token väntar på granskning | Invänta godkännande från Google eller använd ett testkonto | | `CUSTOMER_NOT_FOUND` | Fel kund-ID | Ta bort bindestreck från kund-ID eller kontrollera Manager-kontot | | Låg matchningsgrad för Customer Match | Otillräcklig data | Inkludera flera identifierare (e-post, telefon, namn, postnummer) | | Konverteringar visas inte | Attributionsfönster | Konverteringar kan ta upp till 24 timmar att bearbeta | | `OAUTH_TOKEN_EXPIRED` | Refresh token ogiltig | Autentisera på nytt och skaffa en ny refresh token | | `PERMISSION_DENIED` | Otillräcklig åtkomst | Kontrollera API-åtkomstnivå och kontokoppling | ## Bästa praxis 1. **Använd ett Manager-konto** - Hantera flera Ads-konton via ett enda Manager (MCC)-konto 2. **Hasha Customer Match-data** - Hasha alltid PII med SHA-256 innan uppladdning till Customer Match 3. **Spåra GCLID:n** - Lagra Google Click ID:n i Brevo-attribut för spårning av offlinekonverteringar 4. **Batcha konverteringsuppladdningar** - Gruppera konverteringar i dagliga batcher istället för realtidsuppladdningar 5. **Använd GAQL för rapportering** - Utnyttja Google Ads Query Language för flexibel kampanjrapportering 6. **Övervaka matchningsgrader** - Följ matchningsgrader för Customer Match-målgrupper och förbättra datakvalitet 7. **Sätt upp Enhanced Conversions** - Använd Enhanced Conversions för mer exakt konverteringsmätning ## Säkerhet - **OAuth 2.0** - Säker tokenbaserad autentisering med refresh tokens - **SHA-256-hashning** - Customer Match-data hashas före uppladdning - **Dataminimering** - Endast nödvändiga fält överförs till Google - **Google Cloud-efterlevnad** - SOC 2-, ISO 27001- och GDPR-kompatibelt - **Scope-baserad åtkomst** - API-behörigheter scopas till specifika kundkonton - **Revisionsloggning** - Alla API-förfrågningar loggas i Google Ads ändringshistorik ## Relaterade resurser - [Meta Ads-koppling](https://tajo.io/se/docs/connectors/marketing/meta-ads) - [Klaviyo-koppling](https://tajo.io/se/docs/connectors/marketing/klaviyo) - [Brevo-koppling](https://tajo.io/se/docs/connectors/marketing/brevo) - [Skill för kundsynk](https://tajo.io/se/docs/skills/data-sync/customer-sync)