Delen via


Gegevens kopiëren van Google Ads met behulp van Azure Data Factory of Synapse Analytics

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u de kopieeractiviteit in een Azure Data Factory- of Synapse Analytics-pijplijn gebruikt om gegevens te kopiëren uit Google Ads. Het is gebaseerd op het artikel over het overzicht van kopieeractiviteiten met een algemeen overzicht van de kopieeractiviteit.

Belangrijk

Upgrade uw Google Ads-stuurprogrammaversie voor 18 februari 2024. Als dat niet het probleem is, mislukt de verbinding met een fout vanwege de afschaffing van het verouderde stuurprogramma.

Ondersteunde mogelijkheden

Deze Google Ads-connector wordt ondersteund voor de volgende mogelijkheden:

Ondersteunde mogelijkheden IR
Copy-activiteit (bron/-) (1) (2)
Activiteit Lookup (1) (2)

(1) Azure Integration Runtime (2) Zelf-hostende Integration Runtime

Zie de tabel Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen/sinks.

De service biedt een ingebouwd stuurprogramma om connectiviteit in te schakelen, daarom hoeft u geen stuurprogramma handmatig te installeren met behulp van deze connector.

Aan de slag

Als u de kopieeractiviteit wilt uitvoeren met een pijplijn, kunt u een van de volgende hulpprogramma's of SDK's gebruiken:

Een gekoppelde service maken voor Google Ads met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service te maken voor Google Ads in de gebruikersinterface van Azure Portal.

  1. Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en klik vervolgens op Nieuw:

  2. Zoek naar Google Ads en selecteer de Google Ads-connector.

    Schermopname van de Google Ads-connector.

  3. Configureer de servicedetails, test de verbinding en maak de nieuwe gekoppelde service.

    Schermopname van de configuratie van gekoppelde services voor Google Ads.

Configuratiedetails van connector

De volgende secties bevatten details over eigenschappen die worden gebruikt om Data Factory-entiteiten te definiëren die specifiek zijn voor de Google Ads-connector.

Eigenschappen van gekoppelde service

De volgende eigenschappen worden ondersteund voor de gekoppelde Google Ads-service:

Eigenschappen Beschrijving Vereist
type De eigenschap type moet worden ingesteld op: GoogleAdWords Ja
googleAdsApiVersion De Google Ads-API-versie die u gebruikt wanneer u de aanbevolen stuurprogrammaversie selecteert. Raadpleeg dit artikel voor api-versiegegevens. Ja
clientCustomerID De klant-id van het Ads-account waarvoor u rapportgegevens wilt ophalen. Ja
loginCustomerID De klant-id van het Google Ads Manager-account waarmee u rapportgegevens van specifieke klanten wilt ophalen. Nee
developerToken Het ontwikkelaarstoken dat is gekoppeld aan het manageraccount dat u gebruikt om toegang te verlenen tot de Ads-API. U kunt ervoor kiezen om dit veld als secureString te markeren om het veilig op te slaan, of om het wachtwoord op te slaan in Azure Key Vault en de kopieeractiviteit daarheen te laten halen wanneer u gegevens kopieert. Lees hier meer over Store-referenties in Key Vault. Ja
authenticationType Het OAuth 2.0-verificatiemechanisme dat wordt gebruikt voor verificatie.
Toegestane waarden zijn: ServiceAuthentication, UserAuthentication.
ServiceAuthentication kan alleen worden gebruikt voor zelf-hostende IR.
Ja
Voor UserAuthentication:
refreshToken Het vernieuwingstoken dat is verkregen van Google voor het autoriseren van toegang tot Ads for UserAuthentication. U kunt ervoor kiezen om dit veld als secureString te markeren om het veilig op te slaan, of om het wachtwoord op te slaan in Azure Key Vault en de kopieeractiviteit daarheen te laten halen wanneer u gegevens kopieert. Lees hier meer over Store-referenties in Key Vault. Nee
clientId De client-id van de Google-toepassing die wordt gebruikt om het vernieuwingstoken te verkrijgen. U kunt ervoor kiezen om dit veld als secureString te markeren om het veilig op te slaan, of om het wachtwoord op te slaan in Azure Key Vault en de kopieeractiviteit daarheen te laten halen wanneer u gegevens kopieert. Lees hier meer over Store-referenties in Key Vault. Nee
clientSecret Het clientgeheim van de Google-toepassing die wordt gebruikt om het vernieuwingstoken te verkrijgen. U kunt ervoor kiezen om dit veld als secureString te markeren om het veilig op te slaan, of om het wachtwoord op te slaan in Azure Key Vault en de kopieeractiviteit daarheen te laten halen wanneer u gegevens kopieert. Lees hier meer over Store-referenties in Key Vault. Nee
Voor ServiceAuthentication:
e-mailadres De e-mailadres-id van het serviceaccount dat wordt gebruikt voor ServiceAuthentication en kan alleen worden gebruikt voor zelf-hostende IR. Nee
privateKey De persoonlijke servicesleutel die wordt gebruikt voor ServiceAuthentication voor de aanbevolen stuurprogrammaversie en kan alleen worden gebruikt voor zelf-hostende IR. U kunt ervoor kiezen om dit veld als secureString te markeren om het veilig op te slaan, of om het wachtwoord op te slaan in Azure Key Vault en de kopieeractiviteit daarheen te laten halen wanneer u gegevens kopieert. Lees hier meer over Store-referenties in Key Vault. Nee
Voor ServiceAuthentication met de verouderde stuurprogrammaversie:
e-mailadres De e-mailadres-id van het serviceaccount dat wordt gebruikt voor ServiceAuthentication en kan alleen worden gebruikt voor zelf-hostende IR. Nee
keyFilePath Het volledige pad naar het .p12 of .json sleutelbestand dat wordt gebruikt om het e-mailadres van het serviceaccount te verifiëren en kan alleen worden gebruikt voor zelf-hostende IR. Nee
trustedCertPath Het volledige pad van het PEM-bestand met vertrouwde CA-certificaten voor het verifiëren van de server bij het maken van verbinding via TLS. Deze eigenschap kan alleen worden ingesteld wanneer u TLS gebruikt op zelf-hostende IR. De standaardwaarde is het cacerts.pem-bestand dat is geïnstalleerd met de IR. Nee
useSystemTrustStore Hiermee geeft u op of u een CA-certificaat uit het systeemvertrouwensarchief of een opgegeven PEM-bestand wilt gebruiken. De standaardwaarde is false. Nee

Voorbeeld:

{
    "name": "GoogleAdsLinkedService",
    "properties": {
        "type": "GoogleAdWords",
        "typeProperties": {
            "clientCustomerID": "<clientCustomerID>",
            "loginCustomerID": "<loginCustomerID>",
            "developerToken": {
                "type": "SecureString",
                "value": "<developerToken>"
            },
            "authenticationType": "UserAuthentication",
            "refreshToken": {
                "type": "SecureString",
                "value": "<refreshToken>"
            },
            "clientId": {
                "type": "SecureString",
                "value": "<clientId>"
            },
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            },
            "googleAdsApiVersion": "v14"
        }
    }
}

Eigenschappen van gegevensset

Zie het artikel gegevenssets voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van gegevenssets . Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de Google Ads-gegevensset.

Als u gegevens van Google Ads wilt kopiëren, stelt u de typeeigenschap van de gegevensset in op GoogleAdWordsObject. De volgende eigenschappen worden ondersteund:

Eigenschappen Beschrijving Vereist
type De typeeigenschap van de gegevensset moet worden ingesteld op: GoogleAdWordsObject Ja
tableName Naam van de tabel. Geef deze eigenschap op wanneer u de verouderde stuurprogrammaversie gebruikt. Nee (als 'query' in de activiteitsbron is opgegeven)

Voorbeeld

{
    "name": "GoogleAdsDataset",
    "properties": {
        "type": "GoogleAdWordsObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<GoogleAds linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Eigenschappen van de kopieeractiviteit

Zie het artikel Pijplijnen voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van activiteiten. Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de Google Ads-bron.

Als u gegevens van Google Ads wilt kopiëren, stelt u het brontype in de kopieeractiviteit in op GoogleAdWordsSource. De volgende eigenschappen worden ondersteund in de sectie bron van kopieeractiviteit:

Eigenschappen Beschrijving Vereist
type De typeeigenschap van de bron van de kopieeractiviteit moet worden ingesteld op: GoogleAdWordsSource Ja
query Gebruik de GAQL-query om gegevens te lezen. Voorbeeld: SELECT campaign.id FROM campaign. Nee (als 'tableName' in de gegevensset is opgegeven)

Voorbeeld:

"activities":[
    {
        "name": "CopyFromGoogleAds",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<GoogleAds input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "GoogleAdWordsSource",
                "query": "SELECT campaign.id FROM campaign"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Eigenschappen van opzoekactiviteit

Als u meer wilt weten over de eigenschappen, controleert u de lookup-activiteit.

De versie van het Google Ads-stuurprogramma upgraden

Als u de versie van uw Google Ads-stuurprogramma wilt upgraden, moet u uw gekoppelde service bijwerken en leren hoe u migreert van SQL naar Google Ads Query Language (GAQL).

De configuratie van de gekoppelde service bijwerken

Selecteer op de pagina Gekoppelde service bewerken de optie Aanbevolen onder Stuurprogrammaversie en configureer de gekoppelde service door te verwijzen naar de eigenschappen van de gekoppelde service.

Migreren van SQL naar GAQL

Converteer uw queryinstructies en veldnamen bij het migreren van SQL naar GAQL.

Query-instructies

Als u SQL-query gebruikt in de bron van de kopieeractiviteit of de opzoekactiviteit die verwijst naar de verouderde gekoppelde Google Ads-service, moet u deze bijwerken naar GAQL-query.

In tegenstelling tot SQL bestaat de query in GAQL uit zes soorten componenten:

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT
  • PARAMETERS

Ga naar Google Ads Query Language Grammar voor de introductie van GAQL.

Neem de volgende SQL-instructie als voorbeeld:

SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value

U kunt de onderstaande richtlijnen volgen om de SQL-instructie te converteren naar de bijbehorende GAQL-instructie:

  1. Als * (sterretje) na de SELECT component wordt gebruikt, moet u alle vereiste velden opgeven in plaats van het sterretje, omdat GAQL geen ondersteuning biedt SELECT *voor . Ga naar dit artikel om alle selecteerbare velden in de specifieke resource weer te geven.
  2. Als de veldnaam na de SELECT component wordt gebruikt, moet u de naam converteren naar de bijbehorende veldnaam in GAQL omdat deze verschillende naamconventies hebben. De veldnaam campaign_id in de SQL-query-instructie moet bijvoorbeeld worden geconverteerd naar campaign.id in GAQL. Zie Veldnaam voor meer informatie over veldnaamconversie.
  3. De resourcenaam kan worden achtergelaten, tenzij het geval niet overeenkomt met wat hier wordt opgegeven.
  4. WHERE de component moet worden bijgewerkt volgens de GAQL-grammatica , omdat de operators die worden ondersteund door GAQL niet consistent zijn met SQL, en de veldnaam moet ook worden geconverteerd zoals beschreven in het tweede punt.

Hier volgen twee zeer nuttige hulpprogramma's die door Google worden aangeboden en ze worden ten zeerste aanbevolen bij het bouwen van de bijbehorende GAQL-queryinstructies:

Veldnaam

De veldnaam die in SQL wordt gebruikt, is niet afgestemd op GAQL. U moet ook de conversieregels leren van veldnamen in SQL naar veldnamen in GAQL. De conversieregel kan als volgt worden samengevat:

  • Als de veldnaam deel uitmaakt van een resource, wordt het onderstrepingsteken (_) in SQL gewijzigd in punt (.) in GAQL. En voor de woorden tussen de stip wordt de instructie camelCase-type die in SQL wordt gebruikt, gewijzigd in zelfstandige woorden met toegevoegde onderstrepingstekens ertussenin. De eerste tekenreeks van het type PascalCase in SQL wordt gewijzigd in de bijbehorende resourcenaam in GAQL.

  • Als de veldnaam deel uitmaakt van segmenten of metrische gegevens, moet het voorvoegsel segments. of metrics. in GAQL worden toegevoegd, en volgt u dezelfde regel als beschreven in het eerste punt om de naam te converteren.

Hier volgen de concrete voorbeelden van de veldnaamconversie:

Categorie Veldnamen in SQL Veldnamen in GAQL
Resourcevelden Campaign_startDate campaign.start_date
Resourcevelden Customer_conversionTrackingSetting_conversionTrackingStatus customer.conversion_tracking_setting.conversion_tracking_status
Segmenten DayOfWeek segments.day_of_week
Metrische gegevens voor VideoViews metrics.video_views

In de onderstaande tabel ziet u de functieverschillen tussen Google Ads met behulp van de aanbevolen en de verouderde versie van het stuurprogramma.

Aanbevolen stuurprogrammaversie Verouderde stuurprogrammaversie
Het opgeven van de Google Ads-API-versie wordt ondersteund. Het opgeven van de Google Ads-API-versie wordt niet ondersteund.
ServiceAuthentication ondersteunt twee eigenschappen:
  •E-mail
  • privateKey
ServiceAuthentication ondersteunt vier eigenschappen:
  •E-mail
  • keyFilePath
  • trustedCertPath
  • useSystemTrustStore
Het selecteren van een tabel in een gegevensset wordt niet ondersteund. Ondersteuning voor het selecteren van een tabel in een gegevensset en het uitvoeren van query's op de tabel in kopieeractiviteiten.
Ondersteuning voor GAQL-syntaxis als querytaal. Ondersteuning voor SQL-syntaxis als querytaal.
De namen van de uitvoerkolommen zijn hetzelfde als de veldnamen die zijn gedefinieerd in Google Ads. De namen van de uitvoerkolommen komen niet overeen met de veldnamen die zijn gedefinieerd in Google Ads.
De volgende toewijzingen worden gebruikt van Google Ads-gegevenstypen tot tussentijdse gegevenstypen die intern door de service worden gebruikt.

float -> float
int32 -> int
int64 -> lang
De volgende toewijzingen worden gebruikt van Google Ads-gegevenstypen tot tussentijdse gegevenstypen die intern door de service worden gebruikt.

float -> tekenreeks
int32 -> tekenreeks
int64 -> tekenreeks

Google AdWords-connector upgraden naar Google Ads-connector

Voer de onderstaande stappen uit om uw gekoppelde Google AdWords-service te upgraden naar de nieuwste gekoppelde Google Ads-service:

  1. Selecteer Aanbevolen als stuurprogrammaversie om een nieuwe gekoppelde Google Ads-service te maken en deze te configureren door te verwijzen naar eigenschappen van gekoppelde services.

  2. Werk uw pijplijnen bij die verwijzen naar de verouderde gekoppelde Google AdWords-service. Gezien het feit dat de gekoppelde Google Ads-service alleen ondersteuning biedt voor het gebruik van query's om gegevens te kopiëren, dus:

    1. Als uw pijplijn rechtstreeks gegevens opvraagt uit het rapport van Google AdWords, zoekt u de bijbehorende resourcenaam van Google Ads in de onderstaande tabel en gebruikt u dit hulpprogramma om de query te maken.

      Google AdWords-rapport Google Ads-resource
      ACCOUNT_PERFORMANCE_REPORT klant
      AD_PERFORMANCE_REPORT ad_group_ad
      ADGROUP_PERFORMANCE_REPORT ad_group
      AGE_RANGE_PERFORMANCE_REPORT age_range_view
      AUDIENCE_PERFORMANCE_REPORT campaign_audience_view,ad_group_audience_view
      AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORT group_placement_view
      BID_GOAL_PERFORMANCE_REPORT bidding_strategy
      BUDGET_PERFORMANCE_REPORT campaign_budget
      CALL_METRICS_CALL_DETAILS_REPORT call_view
      CAMPAIGN_AD_SCHEDULE_TARGET_REPORT ad_schedule_view
      CAMPAIGN_CRITERIA_REPORT campaign_criterion
      CAMPAIGN_PERFORMANCE_REPORT campaign
      CAMPAIGN_SHARED_SET_REPORT campaign_shared_set
      CAMPAIGN_LOCATION_TARGET_REPORT location_view
      CLICK_PERFORMANCE_REPORT click_view
      DISPLAY_KEYWORD_PERFORMANCE_REPORT display_keyword_view
      DISPLAY_TOPICS_PERFORMANCE_REPORT topic_view
      GENDER_PERFORMANCE_REPORT gender_view
      GEO_PERFORMANCE_REPORT geographic_view, user_location_view
      KEYWORDLESS_QUERY_REPORT dynamic_search_ads_search_term_view
      KEYWORDS_PERFORMANCE_REPORT keyword_view
      LABEL_REPORT label
      LANDING_PAGE_REPORT landing_page_view,expanded_landing_page_view
      PAID_ORGANIC_QUERY_REPORT paid_organic_search_term_view
      PARENTAL_STATUS_PERFORMANCE_REPORT parental_status_view
      PLACEHOLDER_FEED_ITEM_REPORT feed_item, feed_item_target
      PLACEHOLDER_REPORT feed_placeholder_view
      PLACEMENT_PERFORMANCE_REPORT managed_placement_view
      PRODUCT_PARTITION_REPORT product_group_view
      SEARCH_QUERY_PERFORMANCE_REPORT search_term_view
      SHARED_SET_CRITERIA_REPORT shared_criterion
      SHARED_SET_REPORT shared_set
      SHOPPING_PERFORMANCE_REPORT shopping_performance_view
      TOP_CONTENT_PERFORMANCE_REPORT Niet meer beschikbaar in de Google Ads-API.
      URL_PERFORMANCE_REPORT detail_placement_view
      USER_AD_DISTANCE_REPORT distance_view
      VIDEO_PERFORMANCE_REPORT video
    2. Als de pijplijn query gebruikt om gegevens op te halen uit Google AdWords, gebruikt u het hulpprogramma Querymigratie om de AWQL (AdWords Query Language) te vertalen naar GAQL (Google Ads Query Language).

  3. Houd er rekening mee dat er bepaalde beperkingen zijn met deze upgrade:

    1. Niet alle rapporttypen van AWQL worden ondersteund in GAQL.
    2. Niet alle AWQL-query's worden op een schone manier vertaald naar GAQL-query's.

Zie ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.