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	callConversionReportingAbilitato	Booleano	!=, =
Account	callConversionAction	Stringa	!=, =
Account	conversionTrackingId	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	crossAccountConversionTrackingId	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	payPerConversionEligibilityFailureReasons	List
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	Double	!=, =, <, >
Account	allConversionsValueByConversionDate	Double	!=, =, <, >
Account	conversionsByConversionData	Double	!=, =, <, >
Account	conversionsValueByConversionDate	Double	!=, =, <, >
Account	valuePerAllConversionsByConversionDate	Double	!=, =, <, >
Account	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	clic	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	invalidClicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Account	costPerAllConversioni	Double	!=, =, <, >
Account	costPerConversion	Double	!=, =, <, >
Account	conversions	Double	!=, =, <, >
Account	absoluteTopImpressionPercentuale	Double	!=, =, <, >
Account	impression	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	proposedEndTimeTipo	Stringa	!=, =
Budget account	approvedEndTimeTipo	Stringa	!=, =
Budget account	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget account	billingSetup	Stringa	!=, =
Budget account	nome	Stringa	!=, =, LIKE
Budget account	approvedStartDateOra	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	conversionsByConversionData	Double	!=, =, <, >
Gruppo di annunci	conversionsValueByConversionDate	Double	!=, =, <, >
Gruppo di annunci	valuePerAllConversionsByConversionDate	Double	!=, =, <, >
Gruppo di annunci	valuePerConversionsByConversionDate	Double	!=, =, <, >
Gruppo di annunci	averageCost	Double	!=, =, <, >
Gruppo di annunci	costPerAllConversioni	Double	!=, =, <, >
Gruppo di annunci	costPerConversion	Double	!=, =, <, >
Gruppo di annunci	averagePageViews	Double	!=, =, <, >
Gruppo di annunci	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	clic	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	allConversions	Double	!=, =, <, >
Gruppo di annunci	averageCpc	Double	!=, =, <, >
Gruppo di annunci	absoluteTopImpressionPercentuale	Double	!=, =, <, >
Gruppo di annunci	impression	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Gruppo di annunci	topImpressionPercentage	Double	!=, =, <, >
Gruppo di annunci	activeViewCtr	Double	!=, =, <, >
Gruppo di annunci	ctr	Double	!=, =, <, >
Gruppo di annunci	searchTopImpressionCondividere	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	creazione	Struct
Gruppo di annunci	aggiorna	Struct
Gruppo di annunci	primaryStatus	Stringa	!=, =
Gruppo di annunci	primaryStatusReasons	List
Annuncio gruppo di annunci	resourceName	Stringa	!=, =
Annuncio gruppo di annunci	id	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio gruppo di annunci	status	Stringa	!=, =
Annuncio gruppo di annunci	labels	List
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	conversionsByConversionData	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	costPerAllConversioni	Double	!=, =, <, >
Annuncio gruppo di annunci	costPerConversion	Double	!=, =, <, >
Annuncio gruppo di annunci	clic	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	impression	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Annuncio gruppo di annunci	absoluteTopImpressionPercentuale	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	creazione	Struct
Annuncio gruppo di annunci	aggiorna	Struct
Annuncio gruppo di annunci	policyValidationParameter	Struct
Annuncio gruppo di annunci	primaryStatus	Stringa	!=, =
Annuncio gruppo di annunci	primaryStatusReasons	List
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	List
Campagna	data	Data	BETWEEN, =, <, >, <=, >=
Campagna	averageCost	Double
Campagna	clic	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	costMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	impression	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	useAudienceGrouped	Booleano	!=, =
Campagna	activeViewMeasurableCostMicros	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Campagna	costPerAllConversioni	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	conversionsByConversionData	Double	!=, =, <, >
Campagna	conversionsValueByConversionDate	Double	!=, =, <, >
Campagna	valuePerAllConversionsByConversionDate	Double	!=, =, <, >
Campagna	valuePerConversionsByConversionDate	Double	!=, =, <, >
Campagna	allConversions	Double	!=, =, <, >
Campagna	absoluteTopImpressionPercentuale	Double	!=, =, <, >
Campagna	searchAbsoluteTopImpressionShare	Double	!=, =, <, >
Campagna	averageCpc	Double	!=, =, <, >
Campagna	searchImpressionShare	Double	!=, =, <, >
Campagna	searchTopImpressionCondividere	Double	!=, =, <, >
Campagna	activeViewCtr	Double	!=, =, <, >
Campagna	ctr	Double	!=, =, <, >
Campagna	relativeCtr	Double	!=, =, <, >
Campagna	updateMask	Stringa
Campagna	creazione	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	selectiveOptimizationConversionAzioni	Stringa
Budget campagna	averageCost	Double	!=, =, <, >
Budget campagna	costPerAllConversioni	Double	!=, =, <, >
Budget campagna	costPerConversion	Double	!=, =, <, >
Budget campagna	videoViews	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	clicks	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	allConversions	Double	!=, =, <, >
Budget campagna	valuePerAllConversioni	Double	!=, =, <, >
Budget campagna	averageCpc	Double	!=, =, <, >
Budget campagna	impressions	BigInteger	BETWEEN, =, !=, <, >, <=, >=
Budget campagna	ctr	Double	!=, =, <, >
Budget campagna	updateMask	Stringa
Budget campagna	creazione	Struct
Budget campagna	aggiorna	Struct

Query di partizionamento

Se si desidera utilizzare la simultaneità in Spark, possono essere fornite opzioni Spark PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND, NUM_PARTITIONS aggiuntive. 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