Lettura da entità Google Ads

Prerequisiti

• Un oggetto Google Ads da cui desideri leggere. Consulta la tabella delle entità supportate riportata di seguito per verificare le entità disponibili.

Entità supportate

Entità	Può essere filtrato	Supporta Limit	Supporta Order By	Supporta Select *	Supporta il partizionamento
Annuncio di gruppo di annunci	Sì	Sì	Sì	No	Sì
Gruppo di annunci	Sì	Sì	Sì	No	Sì
Budget della campagna	Sì	Sì	Sì	Sì	Sì
Budget dell'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 dell'entità e dei campi Google Ads

Entità	Campo	Tipo di dati	Operatori supportati
Account	resourceName	Stringa	!=, =
Account	callReportingEnabled	Booleano	!=, =
Account	callConversionReportingAttivato	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	acceptedCustomerDataTermini	Booleano
Account	conversionTrackingStatus	Stringa	!=, =, LIKE
Account	enhancedConversionsForLeadsEnabled	Booleano
Account	googleAdsConversionCliente	Stringa
Account	status	Stringa	!=, =
Account	allConversionsByConversionDate	Doppio	!=, =, <, >
Account	allConversionsValueByConversionDate	Doppio	!=, =, <, >
Account	conversionsByConversionData	Doppio	!=, =, <, >
Account	conversionsValueByConversionDate	Doppio	!=, =, <, >
Account	valuePerAllConversionsByConversionDate	Doppio	!=, =, <, >
Account	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	click	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	invalidClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	costPerAllconversioni	Doppio	!=, =, <, >
Account	costPerConversion	Doppio	!=, =, <, >
Account	conversioni	Doppio	!=, =, <, >
Account	absoluteTopImpressionPercentuale	Doppio	!=, =, <, >
Account	impressioni	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	topImpressionPercentage	Doppio	!=, =, <, >
Account	averageCpc	Doppio	!=, =, <, >
Account	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	averageCost	Doppio	!=, =, <, >
Account	ctr	Doppio	!=, =, <, >
Account	activeViewCtr	Doppio	!=, =, <, >
Account	searchImpressionShare	Doppio	!=, =, <, >
Account	conversionAction	Stringa	!=, =
Account	conversionActionCategory	Stringa	!=, =
Account	conversionActionName	Stringa	!=, =, LIKE
Budget del conto	resourceName	Stringa	!=, =
Budget del conto	status	Stringa	!=, =
Budget del conto	proposedEndTimeTipo	Stringa	!=, =
Budget del conto	approvedEndTimeTipo	Stringa	!=, =
Budget del conto	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget del conto	billingSetup	Stringa	!=, =
Budget del conto	nome	Stringa	!=, =, LIKE
Budget del conto	approvedStartDateOra	DateTime	BETWEEN, =, <, >, <=, >=
Budget del conto	proposedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget del conto	approvedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget del conto	adjustedSpendingLimitMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget del conto	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	Doppio	!=, =, <, >
Gruppo di annunci	allConversionsValueByConversionDate	Doppio	!=, =, <, >
Gruppo di annunci	conversionsByConversionData	Doppio	!=, =, <, >
Gruppo di annunci	conversionsValueByConversionDate	Doppio	!=, =, <, >
Gruppo di annunci	valuePerAllConversionsByConversionDate	Doppio	!=, =, <, >
Gruppo di annunci	valuePerConversionsByConversionDate	Doppio	!=, =, <, >
Gruppo di annunci	averageCost	Doppio	!=, =, <, >
Gruppo di annunci	costPerAllConversioni	Doppio	!=, =, <, >
Gruppo di annunci	costPerConversion	Doppio	!=, =, <, >
Gruppo di annunci	averagePageViews	Doppio	!=, =, <, >
Gruppo di annunci	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	click	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	allConversions	Doppio	!=, =, <, >
Gruppo di annunci	averageCpc	Doppio	!=, =, <, >
Gruppo di annunci	absoluteTopImpressionPercentuale	Doppio	!=, =, <, >
Gruppo di annunci	impressioni	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	topImpressionPercentage	Doppio	!=, =, <, >
Gruppo di annunci	activeViewCtr	Doppio	!=, =, <, >
Gruppo di annunci	ctr	Doppio	!=, =, <, >
Gruppo di annunci	searchTopImpressionCondividi	Doppio	!=, =, <, >
Gruppo di annunci	searchImpressionShare	Doppio	!=, =, <, >
Gruppo di annunci	searchAbsoluteTopImpressionShare	Doppio	!=, =, <, >
Gruppo di annunci	relativeCtr	Doppio	!=, =, <, >
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 di gruppo di annunci	resourceName	Stringa	!=, =
Annuncio di gruppo di annunci	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio di gruppo di annunci	status	Stringa	!=, =
Annuncio di gruppo di annunci	labels	Elenco
Annuncio di gruppo di annunci	adGroup	Stringa	!=, =
Annuncio di gruppo di annunci	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio di gruppo di annunci	approvalStatus	Stringa	!=, =
Annuncio di gruppo di annunci	reviewStatus	Stringa	!=, =
Annuncio di gruppo di annunci	adStrength	Stringa	!=, =
Annuncio di gruppo di annunci	tipo	Stringa	!=, =
Annuncio di gruppo di annunci	businessName	Stringa	!=, =, LIKE
Annuncio di gruppo di annunci	data	Data	BETWEEN, =, <, >, <=, >=
Annuncio di gruppo di annunci	allConversionsByConversionDate	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	allConversionsValueByConversionDate	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	conversionsByConversionData	Doppio	!=, =, <, >
Annuncio, gruppo di annunci	conversionsValueByConversionDate	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	valuePerAllConversionsByConversionDate	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	valuePerConversionsByConversionDate	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio di gruppo di annunci	averageCost	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	costPerAllConversioni	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	costPerConversion	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	click	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio di gruppo di annunci	averagePageViews	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio di gruppo di annunci	allConversions	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	averageCpc	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	topImpressionPercentage	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	impressioni	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annunci, gruppo, Annuncio	absoluteTopImpressionPercentuale	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	activeViewCtr	Doppio	!=, =, <, >
Annuncio di gruppo di annunci	ctr	Doppio	!=, =, <, >
Annunci, gruppo, Annuncio	conversionAction	Stringa	!=, =
Annuncio di gruppo di annunci	conversionActionCategory	Stringa	!=, =
Annuncio di gruppo di annunci	conversionActionName	Stringa	!=, =, LIKE
Annuncio di gruppo di annunci	updateMask	Stringa
Annuncio di gruppo di annunci	Crea	Struct
Annuncio di gruppo di annunci	aggiorna	Struct
Annuncio di gruppo di annunci	policyValidationParameter	Struct
Annuncio di gruppo di annunci	primaryStatus	Stringa	!=, =
Annuncio di 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	adServingOptimizationStato	Stringa	!=, =
Campagna	advertisingChannelType	Stringa	!=, =
Campagna	advertisingChannelSubTipo	Stringa	!=, =
Campagna	experimentType	Stringa	!=, =
Campagna	servingStatus	Stringa	!=, =
Campagna	biddingStrategyType	Stringa	!=, =
Campagna	domainName	Stringa	!=, =, LIKE
Campagna	languageCode	Stringa	!=, =, LIKE
Campagna	useSuppliedUrlsSolo	Booleano	!=, =
Campagna	positiveGeoTargetTipo	Stringa	!=, =
Campagna	negativeGeoTargetTipo	Stringa	!=, =
Campagna	paymentMode	Stringa	!=, =
Campagna	optimizationGoalTypes	Elenco
Campagna	data	Data	BETWEEN, =, <, >, <=, >=
Campagna	averageCost	Doppio
Campagna	click	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	impressioni	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	useAudienceGrouped	Booleano	!=, =
Campagna	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	costPerAllconversioni	Doppio	!=, =, <, >
Campagna	costPerConversion	Doppio	!=, =, <, >
Campagna	invalidClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	publisherPurchasedClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	averagePageViews	Doppio	!=, =, <, >
Campagna	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	allConversionsByConversionDate	Doppio	!=, =, <, >
Campagna	allConversionsValueByConversionDate	Doppio	!=, =, <, >
Campagna	conversionsByConversionData	Doppio	!=, =, <, >
Campagna	conversionsValueByConversionDate	Doppio	!=, =, <, >
Campagna	valuePerAllConversionsByConversionDate	Doppio	!=, =, <, >
Campagna	valuePerConversionsByConversionDate	Doppio	!=, =, <, >
Campagna	allConversions	Doppio	!=, =, <, >
Campagna	absoluteTopImpressionPercentuale	Doppio	!=, =, <, >
Campagna	searchAbsoluteTopImpressionShare	Doppio	!=, =, <, >
Campagna	averageCpc	Doppio	!=, =, <, >
Campagna	searchImpressionShare	Doppio	!=, =, <, >
Campagna	searchTopImpressionCondividere	Doppio	!=, =, <, >
Campagna	activeViewCtr	Doppio	!=, =, <, >
Campagna	ctr	Doppio	!=, =, <, >
Campagna	relativeCtr	Doppio	!=, =, <, >
Campagna	updateMask	Stringa
Campagna	Crea	Struct
Campagna	aggiorna	Struct
Budget della campagna	resourceName	Stringa	!=, =
Budget della campagna	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget della campagna	status	Stringa	!=, =
Budget della campagna	deliveryMethod	Stringa	!=, =
Budget della campagna	punto	Stringa	!=, =
Budget della campagna	tipo	Stringa	!=, =
Budget della campagna	nome	Stringa	!=, =, LIKE
Budget della campagna	amountMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget della campagna	explicitlyShared	Booleano	!=, =
Budget della campagna	referenceCount	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget della campagna	hasRecommendedBudget	Booleano	!=, =
Budget della campagna	data	Data	BETWEEN, =, <, >, <=, >=
Budget della campagna	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget della campagna	startDate	Data	BETWEEN, =, <, >, <=, >=
Budget della campagna	endDate	Data	BETWEEN, =, <, >, <=, >=
Budget della campagna	maximizeConversionValueTargetRoas	Doppio	!=, =, <, >
Budget della campagna	maximizeConversionsTargetCpaMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget della campagna	selectiveOptimizationConversionAzioni	Stringa
Budget della campagna	averageCost	Doppio	!=, =, <, >
Budget della campagna	costPerAllConversioni	Doppio	!=, =, <, >
Budget della campagna	costPerConversion	Doppio	!=, =, <, >
Budget della campagna	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget della campagna	click	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget della campagna	allConversions	Doppio	!=, =, <, >
Budget della campagna	valuePerAllConversioni	Doppio	!=, =, <, >
Budget della campagna	averageCpc	Doppio	!=, =, <, >
Budget della campagna	impressioni	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget della campagna	ctr	Doppio	!=, =, <, >
Budget della campagna	updateMask	Stringa
Budget della campagna	Crea	Struct
Budget della campagna	aggiorna	Struct

Interrogazioni di partizionamento

Se desideri utilizzare la concorrenza in Spark PARTITION_FIELD LOWER_BOUNDUPPER_BOUND, NUM_PARTITIONS possono essere fornite opzioni Spark aggiuntive,,. Con questi parametri, la query originale verrebbe suddivisa in un NUM_PARTITIONS numero di sottoquery che possono essere eseguite contemporaneamente dalle attività di 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 Spark utilizzato nelle query SQL Spark. 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 del supporto del campo di partizionamento per entità sono riportati nella tabella seguente.

Nome entità	Campo di partizionamento	Tipo di dati
Annuncio di gruppo di annunci	data	Data
Gruppo di annunci	data	Data
Campagna	data	Data
Budget della 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"
    }
)