Lettura da entità di Google Ads

Prerequisiti

Un oggetto di Google Ads da cui si desidera leggere. Consulta la tabella delle entità supportate qui di seguito per verificare le entità disponibili.

Entità supportate

Entità	Può essere filtrato	Supporta limite	Supporta Ordina per	Supporta Seleziona *	Supporta il partizionamento
Annuncio gruppo di annunci	Sì	Sì	Sì	No	Sì
Gruppo di annunci	Sì	Sì	Sì	No	Sì
Budget campagna	Sì	Sì	Sì	Sì	Sì
Budget account	Sì	No	Sì	Sì	No
Campagna	Sì	Sì	Sì	Sì	Sì
Account	Sì	No	Sì	No	No

Esempio


googleAds_read = glueContext.create_dynamic_frame.from_options(
    connection_type="googleads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "campaign-3467***",
        "API_VERSION": "v16"
    }

Dettagli sull'entità e sul campo di Google Ads

Entità	Campo	Tipo di dati	Operatori supportati
Account	resourceName	Stringa	!=, =
Account	callReportingEnabled	Booleano	!=, =
Account	callConversionReportingEnabled	Booleano	!=, =
Account	callConversionAction	Stringa	!=, =
Account	conversionTrackingId	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	crossAccountConversionTrackingId	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	payPerConversionEligibilityFailureReasons	Elenco
Account	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	currencyCode	Stringa	!=, =, LIKE
Account	timezone	Stringa	!=, =, LIKE
Account	autoTaggingEnabled	Booleano	!=, =
Account	hasPartnersBadge	Booleano	!=, =
Account	manager	Booleano	!=, =
Account	testAccount	Booleano	!=, =
Account	data	Data	BETWEEN, =, <, >, <=, >=
Account	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	acceptedCustomerDataTerms	Booleano
Account	conversionTrackingStatus	Stringa	!=, =, LIKE
Account	enhancedConversionsForLeadsEnabled	Booleano
Account	googleAdsConversionCustomer	Stringa
Account	status	Stringa	!=, =
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	Stringa	!=, =
Account	conversionActionCategory	Stringa	!=, =
Account	conversionActionName	Stringa	!=, =, LIKE
Budget account	resourceName	Stringa	!=, =
Budget account	status	Stringa	!=, =
Budget account	proposedEndTimeType	Stringa	!=, =
Budget account	approvedEndTimeType	Stringa	!=, =
Budget account	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget account	billingSetup	Stringa	!=, =
Budget account	nome	Stringa	!=, =, LIKE
Budget account	approvedStartDateTime	DateTime	BETWEEN, =, <, >, <=, >=
Budget account	proposedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget account	approvedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget account	adjustedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget account	amountServedMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	resourceName	Stringa	!=, =, LIKE
Gruppo di annunci	status	Stringa	!=, =, LIKE
Gruppo di annunci	tipo	Stringa	!=, =, LIKE
Gruppo di annunci	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	nome	Stringa	!=, =, LIKE
Gruppo di annunci	campaign	Stringa	!=, =
Gruppo di annunci	cpcBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	targetCpaMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	cpmBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	cpvBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	targetCpmMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	effectiveTargetCpaMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	data	Data	BETWEEN, =, <, >, <=, >=
Gruppo di annunci	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	useAudienceGrouped	Booleano	!=, =
Gruppo di annunci	effectiveCpcBidMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	allConversionsByConversionDate	Double	!=, =, <, >
Gruppo di annunci	allConversionsValueByConversionDate	Double	!=, =, <, >
Gruppo di annunci	conversionsByConversionDate	Double	!=, =, <, >
Gruppo di annunci	conversionsValueByConversionDate	Double	!=, =, <, >
Gruppo di annunci	valuePerAllConversionsByConversionDate	Double	!=, =, <, >
Gruppo di annunci	valuePerConversionsByConversionDate	Double	!=, =, <, >
Gruppo di annunci	averageCost	Double	!=, =, <, >
Gruppo di annunci	costPerAllConversions	Double	!=, =, <, >
Gruppo di annunci	costPerConversion	Double	!=, =, <, >
Gruppo di annunci	averagePageViews	Double	!=, =, <, >
Gruppo di annunci	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	allConversions	Double	!=, =, <, >
Gruppo di annunci	averageCpc	Double	!=, =, <, >
Gruppo di annunci	absoluteTopImpressionPercentage	Double	!=, =, <, >
Gruppo di annunci	impressions	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	topImpressionPercentage	Double	!=, =, <, >
Gruppo di annunci	activeViewCtr	Double	!=, =, <, >
Gruppo di annunci	ctr	Double	!=, =, <, >
Gruppo di annunci	searchTopImpressionShare	Double	!=, =, <, >
Gruppo di annunci	searchImpressionShare	Double	!=, =, <, >
Gruppo di annunci	searchAbsoluteTopImpressionShare	Double	!=, =, <, >
Gruppo di annunci	relativeCtr	Double	!=, =, <, >
Gruppo di annunci	conversionAction	Stringa	!=, =
Gruppo di annunci	conversionActionCategory	Stringa	!=, =
Gruppo di annunci	conversionActionName	Stringa	!=, =, LIKE
Gruppo di annunci	updateMask	Stringa
Gruppo di annunci	Crea	Struct
Gruppo di annunci	aggiorna	Struct
Gruppo di annunci	primaryStatus	Stringa	!=, =
Gruppo di annunci	primaryStatusReasons	Elenco
Annuncio gruppo di annunci	resourceName	Stringa	!=, =
Annuncio gruppo di annunci	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio gruppo di annunci	status	Stringa	!=, =
Annuncio gruppo di annunci	labels	Elenco
Annuncio gruppo di annunci	adGroup	Stringa	!=, =
Annuncio gruppo di annunci	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio gruppo di annunci	approvalStatus	Stringa	!=, =
Annuncio gruppo di annunci	reviewStatus	Stringa	!=, =
Annuncio gruppo di annunci	adStrength	Stringa	!=, =
Annuncio gruppo di annunci	tipo	Stringa	!=, =
Annuncio gruppo di annunci	businessName	Stringa	!=, =, LIKE
Annuncio gruppo di annunci	data	Data	BETWEEN, =, <, >, <=, >=
Annuncio gruppo di annunci	allConversionsByConversionDate	Double	!=, =, <, >
Annuncio gruppo di annunci	allConversionsValueByConversionDate	Double	!=, =, <, >
Annuncio gruppo di annunci	conversionsByConversionDate	Double	!=, =, <, >
Annuncio gruppo di annunci	conversionsValueByConversionDate	Double	!=, =, <, >
Annuncio gruppo di annunci	valuePerAllConversionsByConversionDate	Double	!=, =, <, >
Annuncio gruppo di annunci	valuePerConversionsByConversionDate	Double	!=, =, <, >
Annuncio gruppo di annunci	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio gruppo di annunci	averageCost	Double	!=, =, <, >
Annuncio gruppo di annunci	costPerAllConversions	Double	!=, =, <, >
Annuncio gruppo di annunci	costPerConversion	Double	!=, =, <, >
Annuncio gruppo di annunci	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio gruppo di annunci	averagePageViews	Double	!=, =, <, >
Annuncio gruppo di annunci	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio gruppo di annunci	allConversions	Double	!=, =, <, >
Annuncio gruppo di annunci	averageCpc	Double	!=, =, <, >
Annuncio gruppo di annunci	topImpressionPercentage	Double	!=, =, <, >
Annuncio gruppo di annunci	impressions	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio gruppo di annunci	absoluteTopImpressionPercentage	Double	!=, =, <, >
Annuncio gruppo di annunci	activeViewCtr	Double	!=, =, <, >
Annuncio gruppo di annunci	ctr	Double	!=, =, <, >
Annuncio gruppo di annunci	conversionAction	Stringa	!=, =
Annuncio gruppo di annunci	conversionActionCategory	Stringa	!=, =
Annuncio gruppo di annunci	conversionActionName	Stringa	!=, =, LIKE
Annuncio gruppo di annunci	updateMask	Stringa
Annuncio gruppo di annunci	Crea	Struct
Annuncio gruppo di annunci	aggiorna	Struct
Annuncio gruppo di annunci	policyValidationParameter	Struct
Annuncio gruppo di annunci	primaryStatus	Stringa	!=, =
Annuncio gruppo di annunci	primaryStatusReasons	Elenco
Campagna	resourceName	Stringa	!=, =
Campagna	status	Stringa	!=, =
Campagna	baseCampaign	Stringa	!=, =
Campagna	nome	Stringa	!=, =, LIKE
Campagna	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	campaignBudget	Stringa	!=, =, LIKE
Campagna	startDate	Data	BETWEEN, =, <, >, <=, >=
Campagna	endDate	Data	BETWEEN, =, <, >, <=, >=
Campagna	adServingOptimizationStatus	Stringa	!=, =
Campagna	advertisingChannelType	Stringa	!=, =
Campagna	advertisingChannelSubType	Stringa	!=, =
Campagna	experimentType	Stringa	!=, =
Campagna	servingStatus	Stringa	!=, =
Campagna	biddingStrategyType	Stringa	!=, =
Campagna	domainName	Stringa	!=, =, LIKE
Campagna	languageCode	Stringa	!=, =, LIKE
Campagna	useSuppliedUrlsOnly	Booleano	!=, =
Campagna	positiveGeoTargetType	Stringa	!=, =
Campagna	negativeGeoTargetType	Stringa	!=, =
Campagna	paymentMode	Stringa	!=, =
Campagna	optimizationGoalTypes	Elenco
Campagna	data	Data	BETWEEN, =, <, >, <=, >=
Campagna	averageCost	Double
Campagna	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	impressions	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	useAudienceGrouped	Booleano	!=, =
Campagna	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	costPerAllConversions	Double	!=, =, <, >
Campagna	costPerConversion	Double	!=, =, <, >
Campagna	invalidClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	publisherPurchasedClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	averagePageViews	Double	!=, =, <, >
Campagna	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	allConversionsByConversionDate	Double	!=, =, <, >
Campagna	allConversionsValueByConversionDate	Double	!=, =, <, >
Campagna	conversionsByConversionDate	Double	!=, =, <, >
Campagna	conversionsValueByConversionDate	Double	!=, =, <, >
Campagna	valuePerAllConversionsByConversionDate	Double	!=, =, <, >
Campagna	valuePerConversionsByConversionDate	Double	!=, =, <, >
Campagna	allConversions	Double	!=, =, <, >
Campagna	absoluteTopImpressionPercentage	Double	!=, =, <, >
Campagna	searchAbsoluteTopImpressionShare	Double	!=, =, <, >
Campagna	averageCpc	Double	!=, =, <, >
Campagna	searchImpressionShare	Double	!=, =, <, >
Campagna	searchTopImpressionShare	Double	!=, =, <, >
Campagna	activeViewCtr	Double	!=, =, <, >
Campagna	ctr	Double	!=, =, <, >
Campagna	relativeCtr	Double	!=, =, <, >
Campagna	updateMask	Stringa
Campagna	Crea	Struct
Campagna	aggiorna	Struct
Budget campagna	resourceName	Stringa	!=, =
Budget campagna	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	status	Stringa	!=, =
Budget campagna	deliveryMethod	Stringa	!=, =
Budget campagna	punto	Stringa	!=, =
Budget campagna	tipo	Stringa	!=, =
Budget campagna	nome	Stringa	!=, =, LIKE
Budget campagna	amountMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	explicitlyShared	Booleano	!=, =
Budget campagna	referenceCount	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	hasRecommendedBudget	Booleano	!=, =
Budget campagna	data	Data	BETWEEN, =, <, >, <=, >=
Budget campagna	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	startDate	Data	BETWEEN, =, <, >, <=, >=
Budget campagna	endDate	Data	BETWEEN, =, <, >, <=, >=
Budget campagna	maximizeConversionValueTargetRoas	Double	!=, =, <, >
Budget campagna	maximizeConversionsTargetCpaMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	selectiveOptimizationConversionActions	Stringa
Budget campagna	averageCost	Double	!=, =, <, >
Budget campagna	costPerAllConversions	Double	!=, =, <, >
Budget campagna	costPerConversion	Double	!=, =, <, >
Budget campagna	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	allConversions	Double	!=, =, <, >
Budget campagna	valuePerAllConversions	Double	!=, =, <, >
Budget campagna	averageCpc	Double	!=, =, <, >
Budget campagna	impressions	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	ctr	Double	!=, =, <, >
Budget campagna	updateMask	Stringa
Budget campagna	Crea	Struct
Budget campagna	aggiorna	Struct

Query di partizionamento

Se desideri utilizzare la concorrenza in Spark, possono essere fornite le opzioni aggiuntive PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND e NUM_PARTITIONS. Con questi parametri, la query originale viene suddivisa in NUM_PARTITIONS query secondarie che possono essere eseguite contemporaneamente dalle attività Spark.

PARTITION_FIELD: il nome del campo da utilizzare per partizionare la query.
LOWER_BOUND: un valore limite inferiore inclusivo del campo di partizione scelto.

Per la data, accettiamo il formato di data di Spark utilizzato nelle query di Spark SQL. Esempio di valori validi: "2024-02-06".
UPPER_BOUND: un valore limite superiore esclusivo del campo di partizione scelto.
NUM_PARTITIONS: numero di partizioni.

I dettagli di supporto del campo di partizionamento per entità sono riportati nella tabella seguente.

Nome entità	Campo di partizionamento	Tipo di dati
Annuncio gruppo di annunci	data	Data
Gruppo di annunci	data	Data
Campagna	data	Data
Budget campagna	data	Data

Esempio


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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Configurazione delle connessioni Google Ads

Opzioni di connessione Google Ads