Kopieren von Daten aus Google Ads mithilfe von Azure Data Factory oder Synapse Analytics

GILT FÜR: Azure Data Factory Azure Synapse Analytics

In diesem Artikel wird beschrieben, wie Sie die Copy-Aktivität in Azure Data Factory- oder Azure Synapse Analytics-Pipelines verwenden, um Daten aus Google Ads zu kopieren. Er baut auf dem Artikel zur Übersicht über die Kopieraktivität auf, der eine allgemeine Übersicht über die Kopieraktivität enthält.

Unterstützte Funktionen

Dieser Google Ads-Connector wird für die folgenden Funktionen unterstützt:

① Azure Integration Runtime ② Selbstgehostete Integration Runtime

Eine Liste der Datenspeicher, die als Quellen/Senken unterstützt werden, finden Sie in der Tabelle Unterstützte Datenspeicher.

Der Dienst enthält einen integrierten Treiber zum Herstellen der Konnektivität. Daher müssen Sie keinen Treiber manuell installieren, wenn dieser Connector verwendet wird.

Erste Schritte

Sie können eines der folgenden Tools oder SDKs verwenden, um die Kopieraktivität mit einer Pipeline zu verwenden:

• Das Tool „Daten kopieren“
• Azure-Portal
• Das .NET SDK
• Das Python SDK
• Azure PowerShell
• Die REST-API
• Die Azure Resource Manager-Vorlage

Erstellen eines verknüpften Diensts mit Google Ads über die Benutzeroberfläche

Verwenden Sie die folgenden Schritte, um einen verknüpften Dienst mit Google Ads auf der Azure-Portal-Benutzeroberfläche zu erstellen.

1. Navigieren Sie in Ihrem Azure Data Factory- oder Synapse-Arbeitsbereich zu der Registerkarte „Verwalten“, wählen Sie „Verknüpfte Dienste“ aus und klicken Sie dann auf „Neu“:

   • Azure Data Factory
   • Azure Synapse

   

2. Suchen Sie nach Google Ads, und wählen Sie den Google Ads-Connector aus.

   

3. Konfigurieren Sie die Dienstdetails, testen Sie die Verbindung, und erstellen Sie den neuen verknüpften Dienst.

   

Details zur Connector-Konfiguration

Die folgenden Abschnitte enthalten Details zu Eigenschaften, die zum Definieren von Data Factory-Entitäten verwendet werden, die für den Google Ads-Connector spezifisch sind.

Eigenschaften des verknüpften Diensts

Folgende Eigenschaften werden für den mit Google Ads verknüpften Dienst unterstützt:

Beispiel:

{
    "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"
        }
    }
}

Dataset-Eigenschaften

Eine vollständige Liste mit den Abschnitten und Eigenschaften, die zum Definieren von Datasets zur Verfügung stehen, finden Sie im Artikel zu Datasets. Dieser Abschnitt enthält eine Liste der Eigenschaften, die vom Google Ads-Dataset unterstützt werden.

Legen Sie zum Kopieren von Daten aus Google Ads die type-Eigenschaft des Datasets auf GoogleAdWordsObject fest. Folgende Eigenschaften werden unterstützt:

Beispiel

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

Eigenschaften der Kopieraktivität

Eine vollständige Liste mit den Abschnitten und Eigenschaften zum Definieren von Aktivitäten finden Sie im Artikel Pipelines. Dieser Abschnitt enthält eine Liste der Eigenschaften, die von der Google Ads-Quelle unterstützt werden.

Google Ads als Quelle

Legen Sie zum Kopieren von Daten aus Google Ads den Quelltyp in der Kopieraktivität auf GoogleAdWordsSource fest. Folgende Eigenschaften werden im Abschnitt source der Kopieraktivität unterstützt:

Beispiel:

"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>"
            }
        }
    }
]

Eigenschaften der Lookup-Aktivität

Ausführliche Informationen zu den Eigenschaften finden Sie unter Lookup-Aktivität.

Aktualisieren der Google Ads-Treiberversion

Um Ihre Google Ads-Treiberversion zu aktualisieren, müssen Sie Ihren verknüpften Dienst aktualisieren und erfahren, wie Sie von SQL zu Google Ads Query Language (GAQL) migrieren.

Aktualisieren der Konfiguration des verknüpften Diensts

Wählen Sie auf der Seite Verknüpften Dienst bearbeiten unter Treiberversion die Option Empfohlen aus, und konfigurieren Sie den verknüpften Dienst, indem Sie auf Eigenschaften des verknüpften Diensts verweisen.

Migrieren von SQL zu GAQL

Konvertieren Sie Ihre Abfrageanweisungen und Feldnamen beim Migrieren von SQL zu GAQL.

Abfrageanweisungen

Wenn Sie eine SQL-Abfrage in der Quelle der Kopieraktivität oder der Lookupaktivität verwenden, die sich auf den verknüpften Google Ads-Legacy-Dienst bezieht, müssen Sie sie in eine GAQL-Abfrage aktualisieren.

Im Gegensatz zu SQL besteht die Abfrage in GAQL aus sechs Arten von Klauseln:

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

Wechseln Sie zu Google Ads Query Language Grammar für die Einführung von GAQL.

Ein Beispiel hierfür wäre etwa die folgende SQL-Anweisung:

SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value

Sie können den Anweisungen unten folgen, um die SQL-Anweisung in die entsprechende GAQL-Anweisung zu konvertieren:

1. Wenn * (Sternchen) nach der SELECT-Klausel verwendet wird, müssen Sie alle erforderlichen Felder anstelle des Sternchens angeben, da GAQL SELECT * nicht unterstützt. Wechseln Sie zu diesem Artikel, um alle auswählbaren Felder in der jeweiligen Ressource anzuzeigen.
2. Wenn der Feldname nach der SELECT-Klausel verwendet wird, müssen Sie den Namen in den entsprechenden Feldnamen in GAQL konvertieren, da sie unterschiedliche Benennungskonventionen aufweisen. Beispielsweise sollte der Feldname campaign_id in SQL-Abfrageanweisungen in GAQL in campaign.id konvertiert werden. Weitere Informationen zur Feldnamenkonvertierung finden Sie unter Feldnamen.
3. Der Ressourcenname kann so bleiben, wie er ist, es sei denn, der Fall ist mit dem hier angegebenen inkonsistent.
4. Die WHERE-Klausel sollte entsprechend der GAQL-Grammatik aktualisiert werden, da die von GAQL unterstützten Operatoren nicht mit SQL konsistent sind, und der Feldname sollte ebenfalls wie im zweiten Punkt beschrieben konvertiert werden.

Hier sind zwei sehr nützliche Tools, die von Google angeboten werden, und sie werden beim Erstellen der entsprechenden GAQL-Abfrageanweisungen dringend empfohlen:

• Interaktiver GAQL-Abfrage-Generator
• GAQL-Abfragevalidierung

Feldname

Der in SQL verwendete Feldname ist nicht an GAQL ausgerichtet. Außerdem müssen Sie die Regeln für die Konvertierung von Feldnamen in SQL in Feldnamen in GAQL erlernen. Die Konvertierungsregel kann in folgender Weise zusammengefasst werden:

• Wenn der Feldname zu einer Ressource gehört, wird der Unterstrich (_) in SQL in einen Punkt (.) in GAQL geändert. Und für die Wörter zwischen dem Punkt wird die in SQL verwendete CamelCase-Typ-Anweisung in eigenständige Wörter mit zusätzlichen Unterstrichen geändert. Die erste Zeichenfolge vom Typ PascalCase in SQL wird in GAQL in den entsprechenden Ressourcennamen geändert.

• Wenn der Feldname zu Segmenten oder Metriken gehört, sollte das Präfix segments. oder metrics. in GAQL hinzugefügt werden. Befolgen Sie dann dieselbe Regel wie im ersten Punkt beschrieben, um den Namen zu konvertieren.

Hier sind die konkreten Beispiele für die Feldnamenkonvertierung:

Unterschiede zwischen Google Ads unter Verwendung der empfohlenen und der Legacy-Treiberversion

In der nachstehenden Tabelle sind die Featureunterschiede zwischen Google Ads unter Verwendung der empfohlenen und der Legacy-Treiberversion dargestellt.

Aktualisieren des Google AdWords-Connectors auf den Google Ads-Connector

Führen Sie ein Upgrade Ihres verknüpften Google AdWords-Diensts auf den neuesten verknüpften Google Ads-Dienst durch, und führen Sie die folgenden Schritte aus:

1. Wählen Sie Empfohlen als Treiberversion aus, um einen neuen verknüpften Google Ads-Dienst zu erstellen, und konfigurieren Sie ihn, indem Sie auf Eigenschaften des verknüpften Diensts verweisen.

2. Aktualisieren Sie Ihre Pipelines, die auf den verknüpften Google AdWords-Legacy-Dienst verweisen. In Anbetracht der Tatsache, dass der verknüpfte Google Ads-Dienst nur die Abfrage zum Kopieren von Daten unterstützt, gilt:

   1. Wenn Ihre Pipeline Daten direkt aus dem Bericht von Google AdWords abruft, suchen Sie den entsprechenden Ressourcennamen von Google Ads in der folgenden Tabelle, und verwenden Sie dieses Tool, um die Abfrage zu erstellen.

      Google AdWords-Bericht	Google Ads-Ressource
      ACCOUNT_PERFORMANCE_REPORT	customer
      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	Kampagne
      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	In der Google Ads-API nicht mehr verfügbar.
      URL_PERFORMANCE_REPORT	detail_placement_view
      USER_AD_DISTANCE_REPORT	distance_view
      VIDEO_PERFORMANCE_REPORT	Video

   2. Wenn die Pipeline Abfrage zum Abrufen von Daten aus Google AdWords verwendet, verwenden Sie das Abfragemigrationstool, um die AWQL (AdWords Query Language) in GAQL (Google Ads Query Language) zu übersetzen.

3. Beachten Sie, dass bei diesem Upgrade bestimmte Einschränkungen gelten:

   1. Nicht alle Berichtstypen von AWQL werden in GAQL unterstützt.
   2. Nicht alle AWQL-Abfragen werden sauber in GAQL-Abfragen übersetzt.

Zugehöriger Inhalt

Eine Liste der Datenspeicher, die als Quelles und Senken für die Kopieraktivität unterstützt werden, finden Sie in der Dokumentation für Unterstützte Datenspeicher.