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 „* 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	String	!=, =
Account	callReportingEnabled	Boolesch	!=, =
Account	callConversionReportingEnabled	Boolesch	!=, =
Account	callConversionAction	String	!=, =
Account	conversionTrackingId	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	crossAccountConversionTrackingId	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	payPerConversionEligibilityFailureReasons	Auflisten
Account	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	currencyCode	String	!=, =, LIKE
Account	timeZone	String	!=, =, LIKE
Account	autoTaggingEnabled	Boolesch	!=, =
Account	hasPartnersBadge	Boolesch	!=, =
Account	manager	Boolesch	!=, =
Account	testAccount	Boolesch	!=, =
Account	date	Datum	BETWEEN, =, <, >, <=, >=
Account	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	acceptedCustomerDataTerms	Boolesch
Account	conversionTrackingStatus	String	!=, =, LIKE
Account	enhancedConversionsForLeadsEnabled	Boolesch
Account	googleAdsConversionCustomer	String
Account	Status	String	!=, =
Account	allConversionsByConversionDate	Double	!=, =, <, >
Account	allConversionsValueByConversionDate	Double	!=, =, <, >
Account	conversionsByConversionDate	Double	!=, =, <, >
Account	conversionsValueByConversionDate	Double	!=, =, <, >
Account	valuePerAllConversionsByConversionDate	Double	!=, =, <, >
Account	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	invalidClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	costPerAllConversions	Double	!=, =, <, >
Account	costPerConversion	Double	!=, =, <, >
Account	conversions	Double	!=, =, <, >
Account	absoluteTopImpressionPercentage	Double	!=, =, <, >
Account	impressions	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	topImpressionPercentage	Double	!=, =, <, >
Account	averageCpc	Double	!=, =, <, >
Account	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	averageCost	Double	!=, =, <, >
Account	ctr	Double	!=, =, <, >
Account	activeViewCtr	Double	!=, =, <, >
Account	searchImpressionShare	Double	!=, =, <, >
Account	conversionAction	String	!=, =
Account	conversionActionCategory	String	!=, =
Account	conversionActionName	String	!=, =, LIKE
Kontobudget	RessourcenNamen	String	!=, =
Kontobudget	Status	String	!=, =
Kontobudget	proposedEndTimeType	String	!=, =
Kontobudget	approvedEndTimeType	String	!=, =
Kontobudget	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kontobudget	billingSetup	String	!=, =
Kontobudget	Name	String	!=, =, LIKE
Kontobudget	approvedStartDateTime	DateTime	BETWEEN, =, <, >, <=, >=
Kontobudget	proposedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kontobudget	approvedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kontobudget	adjustedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kontobudget	amountServedMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	RessourcenNamen	String	!=, =, LIKE
Anzeigengruppe	Status	String	!=, =, LIKE
Anzeigengruppe	Typ	String	!=, =, LIKE
Anzeigengruppe	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	Name	String	!=, =, LIKE
Anzeigengruppe	Kampagne	String	!=, =
Anzeigengruppe	cpcBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	targetCpaMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	cpmBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	cpvBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	targetCpmMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	effectiveTargetCpaMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	date	Datum	BETWEEN, =, <, >, <=, >=
Anzeigengruppe	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	useAudienceGrouped	Boolesch	!=, =
Anzeigengruppe	effectiveCpcBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	allConversionsByConversionDate	Double	!=, =, <, >
Anzeigengruppe	allConversionsValueByConversionDate	Double	!=, =, <, >
Anzeigengruppe	conversionsByConversionDate	Double	!=, =, <, >
Anzeigengruppe	conversionsValueByConversionDate	Double	!=, =, <, >
Anzeigengruppe	valuePerAllConversionsByConversionDate	Double	!=, =, <, >
Anzeigengruppe	valuePerConversionsByConversionDate	Double	!=, =, <, >
Anzeigengruppe	averageCost	Double	!=, =, <, >
Anzeigengruppe	costPerAllConversions	Double	!=, =, <, >
Anzeigengruppe	costPerConversion	Double	!=, =, <, >
Anzeigengruppe	averagePageViews	Double	!=, =, <, >
Anzeigengruppe	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	allConversions	Double	!=, =, <, >
Anzeigengruppe	averageCpc	Double	!=, =, <, >
Anzeigengruppe	absoluteTopImpressionPercentage	Double	!=, =, <, >
Anzeigengruppe	impressions	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeigengruppe	topImpressionPercentage	Double	!=, =, <, >
Anzeigengruppe	activeViewCtr	Double	!=, =, <, >
Anzeigengruppe	ctr	Double	!=, =, <, >
Anzeigengruppe	searchTopImpressionShare	Double	!=, =, <, >
Anzeigengruppe	searchImpressionShare	Double	!=, =, <, >
Anzeigengruppe	searchAbsoluteTopImpressionShare	Double	!=, =, <, >
Anzeigengruppe	relativeCtr	Double	!=, =, <, >
Anzeigengruppe	conversionAction	String	!=, =
Anzeigengruppe	conversionActionCategory	String	!=, =
Anzeigengruppe	conversionActionName	String	!=, =, LIKE
Anzeigengruppe	updateMask	String
Anzeigengruppe	create	Struct
Anzeigengruppe	update	Struct
Anzeigengruppe	primaryStatus	String	!=, =
Anzeigengruppe	primaryStatusReasons	Auflisten
Anzeige der Anzeigengruppe	RessourcenNamen	String	!=, =
Anzeige der Anzeigengruppe	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeige der Anzeigengruppe	Status	String	!=, =
Anzeige der Anzeigengruppe	labels	Auflisten
Anzeige der Anzeigengruppe	adGroup	String	!=, =
Anzeige der Anzeigengruppe	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeige der Anzeigengruppe	approvalStatus	String	!=, =
Anzeige der Anzeigengruppe	reviewStatus	String	!=, =
Anzeige der Anzeigengruppe	adStrength	String	!=, =
Anzeige der Anzeigengruppe	Typ	String	!=, =
Anzeige der Anzeigengruppe	businessName	String	!=, =, LIKE
Anzeige der Anzeigengruppe	date	Datum	BETWEEN, =, <, >, <=, >=
Anzeige der Anzeigengruppe	allConversionsByConversionDate	Double	!=, =, <, >
Anzeige der Anzeigengruppe	allConversionsValueByConversionDate	Double	!=, =, <, >
Anzeige der Anzeigengruppe	conversionsByConversionDate	Double	!=, =, <, >
Anzeige der Anzeigengruppe	conversionsValueByConversionDate	Double	!=, =, <, >
Anzeige der Anzeigengruppe	valuePerAllConversionsByConversionDate	Double	!=, =, <, >
Anzeige der Anzeigengruppe	valuePerConversionsByConversionDate	Double	!=, =, <, >
Anzeige der Anzeigengruppe	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeige der Anzeigengruppe	averageCost	Double	!=, =, <, >
Anzeige der Anzeigengruppe	costPerAllConversions	Double	!=, =, <, >
Anzeige der Anzeigengruppe	costPerConversion	Double	!=, =, <, >
Anzeige der Anzeigengruppe	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeige der Anzeigengruppe	averagePageViews	Double	!=, =, <, >
Anzeige der Anzeigengruppe	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeige der Anzeigengruppe	allConversions	Double	!=, =, <, >
Anzeige der Anzeigengruppe	averageCpc	Double	!=, =, <, >
Anzeige der Anzeigengruppe	topImpressionPercentage	Double	!=, =, <, >
Anzeige der Anzeigengruppe	impressions	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Anzeige der Anzeigengruppe	absoluteTopImpressionPercentage	Double	!=, =, <, >
Anzeige der Anzeigengruppe	activeViewCtr	Double	!=, =, <, >
Anzeige der Anzeigengruppe	ctr	Double	!=, =, <, >
Anzeige der Anzeigengruppe	conversionAction	String	!=, =
Anzeige der Anzeigengruppe	conversionActionCategory	String	!=, =
Anzeige der Anzeigengruppe	conversionActionName	String	!=, =, LIKE
Anzeige der Anzeigengruppe	updateMask	String
Anzeige der Anzeigengruppe	create	Struct
Anzeige der Anzeigengruppe	update	Struct
Anzeige der Anzeigengruppe	policyValidationParameter	Struct
Anzeige der Anzeigengruppe	primaryStatus	String	!=, =
Anzeige der Anzeigengruppe	primaryStatusReasons	Auflisten
Kampagne	RessourcenNamen	String	!=, =
Kampagne	Status	String	!=, =
Kampagne	baseCampaign	String	!=, =
Kampagne	Name	String	!=, =, LIKE
Kampagne	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagne	campaignBudget	String	!=, =, LIKE
Kampagne	startDate	Datum	BETWEEN, =, <, >, <=, >=
Kampagne	endDate	Datum	BETWEEN, =, <, >, <=, >=
Kampagne	adServingOptimizationStatus	String	!=, =
Kampagne	advertisingChannelType	String	!=, =
Kampagne	advertisingChannelSubType	String	!=, =
Kampagne	experimentType	String	!=, =
Kampagne	servingStatus	String	!=, =
Kampagne	biddingStrategyType	String	!=, =
Kampagne	domainName	String	!=, =, LIKE
Kampagne	languageCode	String	!=, =, LIKE
Kampagne	useSuppliedUrlsOnly	Boolesch	!=, =
Kampagne	positiveGeoTargetType	String	!=, =
Kampagne	negativeGeoTargetType	String	!=, =
Kampagne	paymentMode	String	!=, =
Kampagne	optimizationGoalTypes	Auflisten
Kampagne	date	Datum	BETWEEN, =, <, >, <=, >=
Kampagne	averageCost	Double
Kampagne	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagne	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagne	impressions	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagne	useAudienceGrouped	Boolesch	!=, =
Kampagne	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagne	costPerAllConversions	Double	!=, =, <, >
Kampagne	costPerConversion	Double	!=, =, <, >
Kampagne	invalidClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagne	publisherPurchasedClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagne	averagePageViews	Double	!=, =, <, >
Kampagne	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagne	allConversionsByConversionDate	Double	!=, =, <, >
Kampagne	allConversionsValueByConversionDate	Double	!=, =, <, >
Kampagne	conversionsByConversionDate	Double	!=, =, <, >
Kampagne	conversionsValueByConversionDate	Double	!=, =, <, >
Kampagne	valuePerAllConversionsByConversionDate	Double	!=, =, <, >
Kampagne	valuePerConversionsByConversionDate	Double	!=, =, <, >
Kampagne	allConversions	Double	!=, =, <, >
Kampagne	absoluteTopImpressionPercentage	Double	!=, =, <, >
Kampagne	searchAbsoluteTopImpressionShare	Double	!=, =, <, >
Kampagne	averageCpc	Double	!=, =, <, >
Kampagne	searchImpressionShare	Double	!=, =, <, >
Kampagne	searchTopImpressionShare	Double	!=, =, <, >
Kampagne	activeViewCtr	Double	!=, =, <, >
Kampagne	ctr	Double	!=, =, <, >
Kampagne	relativeCtr	Double	!=, =, <, >
Kampagne	updateMask	String
Kampagne	create	Struct
Kampagne	update	Struct
Kampagnebudget	RessourcenNamen	String	!=, =
Kampagnebudget	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagnebudget	Status	String	!=, =
Kampagnebudget	deliveryMethod	String	!=, =
Kampagnebudget	Zeitraum	String	!=, =
Kampagnebudget	Typ	String	!=, =
Kampagnebudget	Name	String	!=, =, LIKE
Kampagnebudget	amountMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagnebudget	explicitlyShared	Boolesch	!=, =
Kampagnebudget	referenceCount	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagnebudget	hasRecommendedBudget	Boolesch	!=, =
Kampagnebudget	date	Datum	BETWEEN, =, <, >, <=, >=
Kampagnebudget	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagnebudget	startDate	Datum	BETWEEN, =, <, >, <=, >=
Kampagnebudget	endDate	Datum	BETWEEN, =, <, >, <=, >=
Kampagnebudget	maximizeConversionValueTargetRoas	Double	!=, =, <, >
Kampagnebudget	maximizeConversionsTargetCpaMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagnebudget	selectiveOptimizationConversionActions	String
Kampagnebudget	averageCost	Double	!=, =, <, >
Kampagnebudget	costPerAllConversions	Double	!=, =, <, >
Kampagnebudget	costPerConversion	Double	!=, =, <, >
Kampagnebudget	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagnebudget	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagnebudget	allConversions	Double	!=, =, <, >
Kampagnebudget	valuePerAllConversions	Double	!=, =, <, >
Kampagnebudget	averageCpc	Double	!=, =, <, >
Kampagnebudget	impressions	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Kampagnebudget	ctr	Double	!=, =, <, >
Kampagnebudget	updateMask	String
Kampagnebudget	create	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	Datum
Anzeigengruppe	date	Datum
Kampagne	date	Datum
Kampagnebudget	date	Datum

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

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Konfigurieren von Google-Ads-Verbindungen

Verbindungsoptionen für Google Ads