Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Herstellen einer Verbindung mit Google Ads
Die Google-Ads-API ist die programmgesteuerte Schnittstelle zu Google Ads, die zur Verwaltung großer oder komplexer Google-Ads-Konten und -Kampagnen verwendet wird. Wenn Sie ein Google Ads-Nutzer sind, können Sie eine Verbindung AWS Glue zu Ihrem Google Ads-Konto herstellen. Anschließend können Sie Google Ads als Datenquelle in Ihren ETL-Aufträgen verwenden. Führen Sie diese Jobs aus, um Daten zwischen Google Ads und AWS Diensten oder anderen unterstützten Anwendungen zu übertragen.
**Topics**
+ [AWS Glue Unterstützung für Google Ads](googleads-support.md)
+ [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](googleads-configuring-iam-permissions.md)
+ [Konfigurieren von Google Ads](googleads-configuring.md)
+ [Konfigurieren von Google-Ads-Verbindungen](googleads-configuring-connections.md)
+ [Lesen aus Google-Ads-Entitäten](googleads-reading-from-entities.md)
+ [Verbindungsoptionen für Google Ads](googleads-connection-options.md)
+ [Erstellen eines Google-Ads-Kontos](googleads-create-account.md)
+ [Einschränkungen](googleads-connector-limitations.md)
# AWS Glue Unterstützung für Google Ads
AWS Glue unterstützt Google Ads wie folgt:
**Als Quelle unterstützt?**
Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten aus Google Ads abzufragen.
**Als Ziel unterstützt?**
Nein.
**Unterstützte Versionen der Google-Ads-API**
v18
# Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten
Die folgende Beispielrichtlinie beschreibt die erforderlichen AWS Berechtigungen für das Erstellen und Verwenden von Verbindungen. Wenn Sie eine neue Rolle erstellen, erstellen Sie eine Richtlinie, die Folgendes enthält:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Sie können auch die folgenden verwalteten IAM-Richtlinien verwenden, um den Zugriff zuzulassen:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Gewährt Zugriff auf Ressourcen, die verschiedene AWS Glue Prozesse benötigen, um in Ihrem Namen ausgeführt zu werden. Zu diesen Ressourcen gehören AWS Glue Amazon S3, IAM, CloudWatch Logs und Amazon EC2. Wenn Sie die in dieser Richtlinie angegebene Benennungskonvention für Ressourcen einhalten, verfügen AWS Glue Prozesse über die erforderlichen Berechtigungen. Diese Richtlinie wird typischerweise mit Rollen verknüpft, die bei der Definition von Crawlern, Aufträgen und Entwicklungsendpunkten angegeben werden.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Gewährt vollen Zugriff auf AWS Glue Ressourcen, wenn eine Identität, an die die Richtlinie angehängt ist, die AWS Managementkonsole verwendet. Wenn Sie die Namenskonvention für Ressourcen befolgen, die in dieser Richtlinie angegeben sind, haben Benutzer alle Konsolenfunktionalitäten. Diese Richtlinie wird in der Regel Benutzern der AWS Glue Konsole zugewiesen.
# Konfigurieren von Google Ads
Bevor Sie die Übertragung von Google Ads verwenden AWS Glue können, müssen Sie die folgenden Anforderungen erfüllen:
## Mindestanforderungen
+ Sie haben ein Google-Ads-Konto mit E-Mail und Passwort. Weitere Informationen zum Erstellen eines Kontos finden Sie unter [Erstellen eines Google-Ads-Kontos](googleads-create-account.md).
+ Ihr Google-Ads-Konto ist für den API-Zugriff aktiviert. Die Nutzung der Google-Ads-API ist ohne zusätzliche Kosten möglich.
+ Mit Ihrem Google-Ads-Konto können Sie verbundene Apps installieren. Wenn Sie keinen Zugriff auf diese Funktion haben, wenden Sie sich an Ihren Google-Ads-Administrator.
Wenn Sie diese Anforderungen erfüllen, können Sie eine Verbindung AWS Glue zu Ihrem Google Ads-Konto herstellen.
# Konfigurieren von Google-Ads-Verbindungen
Google Ads unterstützt den `AUTHORIZATION_CODE` Zuschusstyp für OAuth2.
Diese Art der Gewährung gilt als „dreibeiniges“, OAuth da sie darauf angewiesen ist, dass Benutzer zur Authentifizierung des Benutzers an den Autorisierungsserver eines Drittanbieters weitergeleitet werden. Er wird verwendet, wenn Verbindungen über die Konsole hergestellt werden. AWS Glue Die AWS Glue Konsole leitet den Nutzer zu Google Ads weiter, wo er sich anmelden und den angeforderten Berechtigungen für AWS Glue den Zugriff auf seine Google Ads-Instanz gewähren muss.
Nutzer können sich dafür entscheiden, ihre eigene verbundene App in Google Ads zu erstellen und beim Herstellen von Verbindungen über die AWS Glue Konsole ihre eigene Client-ID und ihr eigenes Client-Geheimnis anzugeben. In diesem Szenario werden sie weiterhin zu Google Ads weitergeleitet, um sich anzumelden und den Zugriff auf ihre Ressourcen AWS Glue zu autorisieren.
Dieser Gewährungstyp führt zu einem Aktualisierungstoken und einem Zugriffstoken. Das Zugriffstoken ist kurzlebig und kann mithilfe des Aktualisierungstokens automatisch ohne Benutzerinteraktion aktualisiert werden.
Weitere Informationen finden Sie in der [öffentlichen Google Ads-Dokumentation zum Erstellen einer verbundenen App für den OAuth Autorisierungscodefluss](https://developers.google.com/workspace/guides/create-credentials).
So konfigurieren Sie eine Google-Ads-Verbindung:
1. Erstellen Sie in AWS Secrets Manager ein Geheimnis mit den folgenden Details. Es ist erforderlich, für jede Verbindung in AWS Glue ein Geheimnis zu erstellen.
1. Für den AuthorizationCode Zuschusstyp:
+ Für kundenseitig verwaltete verbundene App – Geheimnis muss das Verbrauchergeheimnis der verbundenen App mit `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` als Schlüssel enthalten.
1. Erstellen Sie in AWS Glue Glue Studio eine Verbindung unter **Datenverbindungen**, indem Sie die folgenden Schritte ausführen:
1. Wählen Sie für den **Verbindungstyp** Google Ads aus.
1. Geben Sie die `developer token` von Google Ads an, zu der eine Verbindung hergestellt werden soll.
1. Geben Sie die `MANAGER ID` von Google Ads an, wenn Sie sich als Manager anmelden möchten.
1. Wählen Sie die IAM-Rolle aus, die die folgenden Aktionen übernehmen AWS Glue kann und über Berechtigungen verfügt:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Wählen Sie `secretName` die aus, in die Sie für diese Verbindung die Token einfügen AWS Glue möchten.
1. Wählen Sie die Netzwerkoptionen aus, wenn Sie Ihr Netzwerk verwenden möchten.
1. Erteilen Sie der mit Ihrem AWS Glue Job verknüpften IAM-Rolle `secretName` Leserechte.
# Lesen aus Google-Ads-Entitäten
**Voraussetzungen**
+ Ein Google-Ads-Objekt, aus dem gelesen werden soll. In der folgenden Tabelle mit unterstützten Entitäten können Sie die verfügbaren Entitäten überprüfen.
**Unterstützte Entitäten**
| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung |
| --- | --- | --- | --- | --- | --- |
| Anzeige der Anzeigengruppe | Ja | Ja | Ja | Nein | Ja |
| Anzeigengruppe | Ja | Ja | Ja | Nein | Ja |
| Kampagnebudget | Ja | Ja | Ja | Ja | Ja |
| Kontobudget | Ja | Nein | Ja | Ja | Nein |
| Kampagne | Ja | Ja | Ja | Ja | Ja |
| Account | Ja | Nein | Ja | Nein | Nein |
**Beispiel**
```
googleAds_read = glueContext.create_dynamic_frame.from_options(
connection_type="googleads",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "campaign-3467***",
"API_VERSION": "v16"
}
```
**Google-Ads-Entitäts- und Felddetails**
| Entität | Feld | Datentyp | Unterstützte Operatoren |
| --- | --- | --- | --- |
| Account | RessourcenNamen | Zeichenfolge | \$1=, = |
| Account | callReportingEnabled | Boolesch | \$1=, = |
| Account | callConversionReportingAktiviert | Boolesch | \$1=, = |
| Account | callConversionAction | Zeichenfolge | \$1=, = |
| Account | conversionTrackingId | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Account | crossAccountConversionTrackingId | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Account | payPerConversionEligibilityFailureReasons | Auflisten | |
| Account | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Account | currencyCode | Zeichenfolge | \$1=, =, LIKE |
| Account | timeZone | Zeichenfolge | \$1=, =, LIKE |
| Account | autoTaggingEnabled | Boolesch | \$1=, = |
| Account | hasPartnersBadge | Boolesch | \$1=, = |
| Account | manager | Boolesch | \$1=, = |
| Account | testAccount | Boolesch | \$1=, = |
| Account | date | Date | BETWEEN, =, <, >, <=, >= |
| Account | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Account | acceptedCustomerDataBedingungen | Boolesch | |
| Account | conversionTrackingStatus | Zeichenfolge | \$1=, =, LIKE |
| Account | enhancedConversionsForLeadsEnabled | Boolesch | |
| Account | googleAdsConversionKunde | Zeichenfolge | |
| Account | Status | Zeichenfolge | \$1=, = |
| Account | allConversionsByConversionDate | Double | \$1=, =, <, > |
| Account | allConversionsValueByConversionDate | Double | \$1=, =, <, > |
| Account | conversionsByConversionDatum | Double | \$1=, =, <, > |
| Account | conversionsValueByConversionDate | Double | \$1=, =, <, > |
| Account | valuePerAllConversionsByConversionDate | Double | \$1=, =, <, > |
| Account | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Account | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Account | invalidClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Account | costPerAllKonvertierungen | Double | \$1=, =, <, > |
| Account | costPerConversion | Double | \$1=, =, <, > |
| Account | conversions | Double | \$1=, =, <, > |
| Account | absoluteTopImpressionProzentsatz | Double | \$1=, =, <, > |
| Account | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Account | topImpressionPercentage | Double | \$1=, =, <, > |
| Account | averageCpc | Double | \$1=, =, <, > |
| Account | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Account | averageCost | Double | \$1=, =, <, > |
| Account | ctr | Double | \$1=, =, <, > |
| Account | activeViewCtr | Double | \$1=, =, <, > |
| Account | searchImpressionShare | Double | \$1=, =, <, > |
| Account | conversionAction | Zeichenfolge | \$1=, = |
| Account | conversionActionCategory | Zeichenfolge | \$1=, = |
| Account | conversionActionName | Zeichenfolge | \$1=, =, LIKE |
| Kontobudget | RessourcenNamen | Zeichenfolge | \$1=, = |
| Kontobudget | Status | Zeichenfolge | \$1=, = |
| Kontobudget | proposedEndTimeTyp | Zeichenfolge | \$1=, = |
| Kontobudget | approvedEndTimeTyp | Zeichenfolge | \$1=, = |
| Kontobudget | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kontobudget | billingSetup | Zeichenfolge | \$1=, = |
| Kontobudget | Name | Zeichenfolge | \$1=, =, LIKE |
| Kontobudget | approvedStartDateZeit | DateTime | BETWEEN, =, <, >, <=, >= |
| Kontobudget | proposedSpendingLimitMikros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kontobudget | approvedSpendingLimitMikros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kontobudget | adjustedSpendingLimitMikros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kontobudget | amountServedMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | RessourcenNamen | Zeichenfolge | \$1=, =, LIKE |
| Anzeigengruppe | Status | Zeichenfolge | \$1=, =, LIKE |
| Anzeigengruppe | type | Zeichenfolge | \$1=, =, LIKE |
| Anzeigengruppe | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | Name | Zeichenfolge | \$1=, =, LIKE |
| Anzeigengruppe | campaign | Zeichenfolge | \$1=, = |
| Anzeigengruppe | cpcBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | targetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | cpmBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | cpvBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | targetCpmMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | effectiveTargetCpaMikros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | date | Date | BETWEEN, =, <, >, <=, >= |
| Anzeigengruppe | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | useAudienceGrouped | Boolesch | \$1=, = |
| Anzeigengruppe | effectiveCpcBidMikros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | allConversionsByConversionDate | Double | \$1=, =, <, > |
| Anzeigengruppe | allConversionsValueByConversionDate | Double | \$1=, =, <, > |
| Anzeigengruppe | conversionsByConversionDatum | Double | \$1=, =, <, > |
| Anzeigengruppe | conversionsValueByConversionDate | Double | \$1=, =, <, > |
| Anzeigengruppe | valuePerAllConversionsByConversionDate | Double | \$1=, =, <, > |
| Anzeigengruppe | valuePerConversionsByConversionDate | Double | \$1=, =, <, > |
| Anzeigengruppe | averageCost | Double | \$1=, =, <, > |
| Anzeigengruppe | costPerAllKonvertierungen | Double | \$1=, =, <, > |
| Anzeigengruppe | costPerConversion | Double | \$1=, =, <, > |
| Anzeigengruppe | averagePageViews | Double | \$1=, =, <, > |
| Anzeigengruppe | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | allConversions | Double | \$1=, =, <, > |
| Anzeigengruppe | averageCpc | Double | \$1=, =, <, > |
| Anzeigengruppe | absoluteTopImpressionProzentsatz | Double | \$1=, =, <, > |
| Anzeigengruppe | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeigengruppe | topImpressionPercentage | Double | \$1=, =, <, > |
| Anzeigengruppe | activeViewCtr | Double | \$1=, =, <, > |
| Anzeigengruppe | ctr | Double | \$1=, =, <, > |
| Anzeigengruppe | searchTopImpressionTeilen | Double | \$1=, =, <, > |
| Anzeigengruppe | searchImpressionShare | Double | \$1=, =, <, > |
| Anzeigengruppe | searchAbsoluteTopImpressionShare | Double | \$1=, =, <, > |
| Anzeigengruppe | relativeCtr | Double | \$1=, =, <, > |
| Anzeigengruppe | conversionAction | Zeichenfolge | \$1=, = |
| Anzeigengruppe | conversionActionCategory | Zeichenfolge | \$1=, = |
| Anzeigengruppe | conversionActionName | Zeichenfolge | \$1=, =, LIKE |
| Anzeigengruppe | updateMask | Zeichenfolge | |
| Anzeigengruppe | Erstellen | Struct | |
| Anzeigengruppe | update | Struct | |
| Anzeigengruppe | primaryStatus | Zeichenfolge | \$1=, = |
| Anzeigengruppe | primaryStatusReasons | Auflisten | |
| Anzeige der Anzeigengruppe | RessourcenNamen | Zeichenfolge | \$1=, = |
| Anzeige der Anzeigengruppe | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeige der Anzeigengruppe | Status | Zeichenfolge | \$1=, = |
| Anzeige der Anzeigengruppe | labels | Auflisten | |
| Anzeige der Anzeigengruppe | adGroup | Zeichenfolge | \$1=, = |
| Anzeige der Anzeigengruppe | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeige der Anzeigengruppe | approvalStatus | Zeichenfolge | \$1=, = |
| Anzeige der Anzeigengruppe | reviewStatus | Zeichenfolge | \$1=, = |
| Anzeige der Anzeigengruppe | adStrength | Zeichenfolge | \$1=, = |
| Anzeige der Anzeigengruppe | type | Zeichenfolge | \$1=, = |
| Anzeige der Anzeigengruppe | businessName | Zeichenfolge | \$1=, =, LIKE |
| Anzeige der Anzeigengruppe | date | Date | BETWEEN, =, <, >, <=, >= |
| Anzeige der Anzeigengruppe | allConversionsByConversionDate | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | allConversionsValueByConversionDate | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | conversionsByConversionDatum | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | conversionsValueByConversionDate | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | valuePerAllConversionsByConversionDate | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | valuePerConversionsByConversionDate | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeige der Anzeigengruppe | averageCost | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | costPerAllKonvertierungen | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | costPerConversion | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeige der Anzeigengruppe | averagePageViews | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeige der Anzeigengruppe | allConversions | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | averageCpc | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | topImpressionPercentage | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Anzeige der Anzeigengruppe | absoluteTopImpressionProzentsatz | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | activeViewCtr | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | ctr | Double | \$1=, =, <, > |
| Anzeige der Anzeigengruppe | conversionAction | Zeichenfolge | \$1=, = |
| Anzeige der Anzeigengruppe | conversionActionCategory | Zeichenfolge | \$1=, = |
| Anzeige der Anzeigengruppe | conversionActionName | Zeichenfolge | \$1=, =, LIKE |
| Anzeige der Anzeigengruppe | updateMask | Zeichenfolge | |
| Anzeige der Anzeigengruppe | Erstellen | Struct | |
| Anzeige der Anzeigengruppe | update | Struct | |
| Anzeige der Anzeigengruppe | policyValidationParameter | Struct | |
| Anzeige der Anzeigengruppe | primaryStatus | Zeichenfolge | \$1=, = |
| Anzeige der Anzeigengruppe | primaryStatusReasons | Auflisten | |
| Kampagne | RessourcenNamen | Zeichenfolge | \$1=, = |
| Kampagne | Status | Zeichenfolge | \$1=, = |
| Kampagne | baseCampaign | Zeichenfolge | \$1=, = |
| Kampagne | Name | Zeichenfolge | \$1=, =, LIKE |
| Kampagne | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagne | campaignBudget | Zeichenfolge | \$1=, =, LIKE |
| Kampagne | startDate | Date | BETWEEN, =, <, >, <=, >= |
| Kampagne | endDate | Date | BETWEEN, =, <, >, <=, >= |
| Kampagne | adServingOptimizationStatus | Zeichenfolge | \$1=, = |
| Kampagne | advertisingChannelType | Zeichenfolge | \$1=, = |
| Kampagne | advertisingChannelSubTyp | Zeichenfolge | \$1=, = |
| Kampagne | experimentType | Zeichenfolge | \$1=, = |
| Kampagne | servingStatus | Zeichenfolge | \$1=, = |
| Kampagne | biddingStrategyType | Zeichenfolge | \$1=, = |
| Kampagne | domainName | Zeichenfolge | \$1=, =, LIKE |
| Kampagne | languageCode | Zeichenfolge | \$1=, =, LIKE |
| Kampagne | useSuppliedUrlsNur | Boolesch | \$1=, = |
| Kampagne | positiveGeoTargetTyp | Zeichenfolge | \$1=, = |
| Kampagne | negativeGeoTargetTyp | Zeichenfolge | \$1=, = |
| Kampagne | paymentMode | Zeichenfolge | \$1=, = |
| Kampagne | optimizationGoalTypes | Auflisten | |
| Kampagne | date | Date | BETWEEN, =, <, >, <=, >= |
| Kampagne | averageCost | Double | |
| Kampagne | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagne | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagne | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagne | useAudienceGrouped | Boolesch | \$1=, = |
| Kampagne | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagne | costPerAllKonvertierungen | Double | \$1=, =, <, > |
| Kampagne | costPerConversion | Double | \$1=, =, <, > |
| Kampagne | invalidClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagne | publisherPurchasedClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagne | averagePageViews | Double | \$1=, =, <, > |
| Kampagne | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagne | allConversionsByConversionDate | Double | \$1=, =, <, > |
| Kampagne | allConversionsValueByConversionDate | Double | \$1=, =, <, > |
| Kampagne | conversionsByConversionDatum | Double | \$1=, =, <, > |
| Kampagne | conversionsValueByConversionDate | Double | \$1=, =, <, > |
| Kampagne | valuePerAllConversionsByConversionDate | Double | \$1=, =, <, > |
| Kampagne | valuePerConversionsByConversionDate | Double | \$1=, =, <, > |
| Kampagne | allConversions | Double | \$1=, =, <, > |
| Kampagne | absoluteTopImpressionProzentsatz | Double | \$1=, =, <, > |
| Kampagne | searchAbsoluteTopImpressionShare | Double | \$1=, =, <, > |
| Kampagne | averageCpc | Double | \$1=, =, <, > |
| Kampagne | searchImpressionShare | Double | \$1=, =, <, > |
| Kampagne | searchTopImpressionTeilen | Double | \$1=, =, <, > |
| Kampagne | activeViewCtr | Double | \$1=, =, <, > |
| Kampagne | ctr | Double | \$1=, =, <, > |
| Kampagne | relativeCtr | Double | \$1=, =, <, > |
| Kampagne | updateMask | Zeichenfolge | |
| Kampagne | Erstellen | Struct | |
| Kampagne | update | Struct | |
| Kampagnebudget | RessourcenNamen | Zeichenfolge | \$1=, = |
| Kampagnebudget | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagnebudget | Status | Zeichenfolge | \$1=, = |
| Kampagnebudget | deliveryMethod | Zeichenfolge | \$1=, = |
| Kampagnebudget | Zeitraum | Zeichenfolge | \$1=, = |
| Kampagnebudget | type | Zeichenfolge | \$1=, = |
| Kampagnebudget | Name | Zeichenfolge | \$1=, =, LIKE |
| Kampagnebudget | amountMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagnebudget | explicitlyShared | Boolesch | \$1=, = |
| Kampagnebudget | referenceCount | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagnebudget | hasRecommendedBudget | Boolesch | \$1=, = |
| Kampagnebudget | date | Date | BETWEEN, =, <, >, <=, >= |
| Kampagnebudget | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagnebudget | startDate | Date | BETWEEN, =, <, >, <=, >= |
| Kampagnebudget | endDate | Date | BETWEEN, =, <, >, <=, >= |
| Kampagnebudget | maximizeConversionValueTargetRoas | Double | \$1=, =, <, > |
| Kampagnebudget | maximizeConversionsTargetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagnebudget | selectiveOptimizationConversionAktionen | Zeichenfolge | |
| Kampagnebudget | averageCost | Double | \$1=, =, <, > |
| Kampagnebudget | costPerAllKonvertierungen | Double | \$1=, =, <, > |
| Kampagnebudget | costPerConversion | Double | \$1=, =, <, > |
| Kampagnebudget | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagnebudget | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagnebudget | allConversions | Double | \$1=, =, <, > |
| Kampagnebudget | valuePerAllKonvertierungen | Double | \$1=, =, <, > |
| Kampagnebudget | averageCpc | Double | \$1=, =, <, > |
| Kampagnebudget | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= |
| Kampagnebudget | ctr | Double | \$1=, =, <, > |
| Kampagnebudget | updateMask | Zeichenfolge | |
| Kampagnebudget | Erstellen | Struct | |
| Kampagnebudget | update | Struct | |
**Partinionieren von Abfragen**
Die zusätzlichen Spark-Optionen `PARTITION_FIELD`,`LOWER_BOUND`, `UPPER_BOUND` und `NUM_PARTITIONS` können angegeben werden, wenn Sie Parallelität in Spark nutzen möchten. Mit diesen Parametern würde die ursprüngliche Abfrage in `NUM_PARTITIONS` Unterabfragen aufgeteilt, die von Spark-Aufgaben gleichzeitig ausgeführt werden können.
+ `PARTITION_FIELD`: der Name des Feldes, das zur Partitionierung der Abfrage verwendet werden soll.
+ `LOWER_BOUND`: ein inklusiver Untergrenzwert des ausgewählten Partitionsfelds.
Als Datum akzeptieren wir das Spark-Datumsformat, das in Spark-SQL-Abfragen verwendet wird. Beispiel für gültige Werte: `"2024-02-06"`.
+ `UPPER_BOUND`: ein exklusiver Obergrenzwert des ausgewählten Partitionsfelds.
+ `NUM_PARTITIONS`: Anzahl der Partitionen.
Details zur Unterstützung von Feldern für die entitätsbezogene Partitionierung sind in der folgenden Tabelle aufgeführt.
| Entity Name | Partitionierungsfeld | Datentyp |
| --- | --- | --- |
| Anzeige der Anzeigengruppe | date | Date |
| Anzeigengruppe | date | Date |
| Kampagne | date | Date |
| Kampagnebudget | date | Date |
**Beispiel**
```
googleads_read = glueContext.create_dynamic_frame.from_options(
connection_type="googleads",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "campaign-3467***",
"API_VERSION": "v16",
"PARTITION_FIELD": "date"
"LOWER_BOUND": "2024-01-01"
"UPPER_BOUND": "2024-06-05"
"NUM_PARTITIONS": "10"
}
)
```
# Verbindungsoptionen für Google Ads
Im Folgenden sind Verbindungsoptionen für Google Ads aufgeführt:
+ `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen/Schreiben verwendet. Der Name Ihres Objekts in Google Ads.
+ `API_VERSION` (Zeichenfolge) – (Erforderlich) Zum Lesen/Schreiben verwendet. Version der REST-API von Google Ads, die Sie verwenden möchten. Beispiel: v16.
+ `DEVELOPER_TOKEN` (Zeichenfolge) – (Erforderlich) Zum Lesen/Schreiben verwendet. Erforderlich, um den Entwickler oder die Anwendung zu authentifizieren, die Anforderungen an die API stellen.
+ `MANAGER_ID` (Zeichenfolge) – Zum Lesen/Schreiben verwendet. Eine eindeutige Kennung, mit der Sie mehrere Google-Ads-Konten verwalten können. Dies ist die Kunden-ID des autorisierten Managers. Wenn Ihr Zugriff auf das Kundenkonto über ein Managerkonto erfolgt, ist die `MANAGER_ID` erforderlich. Weitere Informationen finden Sie unter [login-customer-id](https://developers.google.com/google-ads/api/docs/concepts/call-structure#cid).
+ `SELECTED_FIELDS` (Liste) – Standard: leer(SELECT \$1). Zum Lesen verwendet. Spalten, die Sie für das Objekt auswählen möchten.
+ `FILTER_PREDICATE`(Zeichenfolge) – Standard: leer. Zum Lesen verwendet. Muss das Spark-SQL-Format aufweisen.
+ `QUERY`(Zeichenfolge) – Standard: leer Zum Lesen verwendet. Vollständige Spark-SQL-Abfrage.
+ `PARTITION_FIELD`(Zeichenfolge) – Zum Lesen verwendet. Feld, das zur Partitionierung der Abfrage verwendet werden soll.
+ `LOWER_BOUND`(Zeichenfolge) – Zum Lesen verwendet. Ein inklusiver Untergrenzwert des ausgewählten Partitionsfelds.
+ `UPPER_BOUND`(Zeichenfolge) – Zum Lesen verwendet. Ein exklusiver Obergrenzwert des ausgewählten Partitionsfelds.
+ `NUM_PARTITIONS`(Ganzzahl) – Standard: 1. Zum Lesen verwendet. Anzahl der zu lesenden Partitionen.
# Erstellen eines Google-Ads-Kontos
1. Melden Sie sich mit Ihren Anmeldeinformationen beim [Google Ads Developer Account](https://console.cloud.google.com) an und gehen Sie zu \$1MyProject.
![\[Der Screenshot zeigt den Begrüßungsbildschirm für die Anmeldung beim Google Ads-Entwicklerkonto.\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/google-ads-log-in-developer-account.png)
1. Wählen Sie **Neues Projekt** und geben Sie die erforderlichen Informationen für die Erstellung eines Google-Projekts ein, wenn Sie noch keine registrierte Anwendung darin haben.
![\[Der Screenshot zeigt die Seite zum Auswählen eines Projekts. Wählen Sie oben rechts „Neues Projekt“ aus.\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/google-ads-new-project.png)
![\[Der Screenshot zeigt das Fenster mit dem neuen Projekt, in dem Sie einen Projektnamen eingeben und einen Speicherort auswählen können.\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/google-ads-new-project-name-location.png)
1. Wählen Sie die **Registerkarte „Navigation“**, dann „**API und Einstellungen**“ und dann „**Client-ID erstellen**“. Für diese Option ist eine weitere Konfiguration erforderlich, um eine Verbindung zwischen AWS Glue und herzustellen GoogleAds. **ClientSecret** Weitere Informationen finden Sie unter [API-Anmeldeinformationen](https://console.cloud.google.com/apis/credentials).
![\[Der Screenshot zeigt die APIs Seite mit der Konfiguration der Dienste.\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/google-ads-apis-and-services.png)
1. Wählen Sie **CREATE CREDENTIALS** und wählen Sie **OAuth Client-ID**.
![\[Der Screenshot zeigt die Seite mit der APIs Konfiguration der Dienste, auf der das Drop-down-Menü Credentials erstellen und die Option Oauth-Client-ID hervorgehoben ist.\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/google-ads-create-credentials.png)
1. Wählen Sie als **Anwendungstyp** die Option **Webanwendung** aus.
![\[Der Screenshot zeigt die Seite „ OAuth Client-ID erstellen“ und den Anwendungstyp als Webanwendung.\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/google-ads-oauth-client-id-application-type.png)
1. Fügen Sie unter **Autorisierte Weiterleitung URIs** die OAuth Weiterleitung hinzu URIs und wählen Sie **Erstellen** aus. Sie können bei URIs Bedarf mehrere Weiterleitungen hinzufügen.
![\[Der Screenshot zeigt die Seite „ OAuth Kunden-ID erstellen“ und den URIs Abschnitt „Autorisierte Weiterleitung“. Fügen Sie hier die hinzu URIs und wählen Sie bei Bedarf URI HINZUFÜGEN. Klicken Sie auf „ERSTELLEN“, wenn Sie fertig sind.\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/google-ads-oauth-redirect-uris.png)
1. Ihre **Kunden-ID** und Ihr **Kundengeheimnis** werden generiert, wenn Sie eine Verbindung zwischen AWS Glue und Google Ads herstellen.
![\[Der Screenshot zeigt die Seite „ OAuth Kunden-ID erstellen“ und den URIs Abschnitt „Autorisierte Weiterleitung“. Fügen Sie hier die hinzu URIs und wählen Sie bei Bedarf URI HINZUFÜGEN. Klicken Sie auf „ERSTELLEN“, wenn Sie fertig sind.\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/google-ads-oauth-client-created.png)
1. Fügen Sie die Bereiche entsprechend den Anforderungen Ihrer Anwendung hinzu, wählen Sie den **OAuth Zustimmungsbildschirm** aus, geben Sie die erforderlichen Informationen ein und fügen Sie die Bereiche je nach Bedarf hinzu.
![\[Der Screenshot zeigt die Seite „Ausgewählte Bereiche aktualisieren“. Wählen Sie Ihre Bereiche nach Bedarf aus.\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/google-ads-selected-scopes.png)
# Einschränkungen
Die folgenden Einschränkungen gelten für den Google-Ads-Connector:
+ `MANAGER_ID` ist eine optionale Eingabe beim Herstellen einer Verbindung. Wenn Sie jedoch auf die Kunden zugreifen möchten, die zu einem bestimmten Manager gehören, ist `MANAGER_ID` eine obligatorische Eingabe. In der folgenden Tabelle werden die Zugriffsbeschränkungen basierend darauf erläutert, ob `MANAGER_ID` in einer Verbindung enthalten ist oder nicht.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/googleads-connector-limitations.html)
+ Wenn ein Verwaltungskonto als Objekt ausgewählt wird, erscheint nur `Account` als Unterobjekt. Im Google-Ads-Connector werden Entitäten wie Kampagnen, Anzeigen usw. anhand einzelner Kundenkonten abgerufen, nicht anhand des Verwaltungskontos.
+ Sie können keine Metriken für das Verwaltungskonto abrufen. Sie können stattdessen Metriken für einzelne Kundenkonten abrufen.
+ Jedes Konto kann über bis zu 10.000 Kampagnen verfügen, darunter sowohl aktive als auch pausierte Kampagnen. Weitere Informationen finden Sie unter [Kampagne pro Konto](https://support.google.com/google-ads/answer/6372658).
+ Wenn Sie bei der Erstellung eines Berichts bestimmte Metriken für die Anzeige auswählen, werden alle Zeilen, deren ausgewählte Metriken alle null sind, nicht zurückgegeben. Weitere Informationen finden Sie unter [Null-Metriken](https://developers.google.com/google-ads/api/docs/reporting/zero-metrics?hl=en#exclude_zero_metrics_by_segmenting).
+ Mit den folgenden Feldern funktioniert der Ablauf „Vollständige Zuordnung“ nicht für die Anzeigenentitäten Account, Ad Group und Ad Group, insbesondere für ConversionAction,, conversionActionCategory. conversionActionName Weitere Informationen finden Sie unter [Segment und Metriken](https://developers.google.com/google-ads/api/docs/reporting/segmentation?hl=en#selectability_between_segments_and_metrics).
+ Ein Datumsbereichsfilter ist erforderlich, wenn das Feld `segments.date` ausgewählt ist.