本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
先決條件
-
您想要讀取的 Google Ads 物件。請參閱以下支援的實體資料表,以檢查可用的實體。
支援的實體
實體 | 可以篩選 | 支援限制 | 支援 排序依據 | 支援選取 * | 支援分割 |
---|---|---|---|---|---|
廣告群組廣告 | 是 | 是 | 是 | 否 | 是 |
廣告群組 | 是 | 是 | 是 | 否 | 是 |
行銷活動預算 | 是 | 是 | 是 | 是 | 是 |
帳戶預算 | 是 | 否 | 是 | 是 | 否 |
Campaign | 是 | 是 | 是 | 是 | 是 |
帳戶 | 是 | 否 | 是 | 否 | 否 |
範例
googleAds_read = glueContext.create_dynamic_frame.from_options(
connection_type="googleads",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "campaign-3467***",
"API_VERSION": "v16"
}
Google Ads 實體和欄位詳細資訊
實體 | 欄位 | 資料類型 | 支援的運算子 |
---|---|---|---|
帳戶 | resourceName | 字串 | !=, = |
帳戶 | callReportingEnabled | Boolean | !=, = |
帳戶 | callConversionReportingEnabled | Boolean | !=, = |
帳戶 | callConversionAction | 字串 | !=, = |
帳戶 | conversionTrackingId | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶 | crossAccountConversionTrackingId | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶 | payPerConversionEligibilityFailureReasons | 清單 | |
帳戶 | id | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶 | currencyCode | 字串 | !=, =, LIKE |
帳戶 | timeZone | 字串 | !=, =, LIKE |
帳戶 | autoTaggingEnabled | Boolean | !=, = |
帳戶 | hasPartnersBadge | Boolean | !=, = |
帳戶 | manager | Boolean | !=, = |
帳戶 | testAccount | Boolean | !=, = |
帳戶 | date | 日期 | BETWEEN、=、<、>、<=、>= |
帳戶 | costMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶 | acceptedCustomerDataTerms | Boolean | |
帳戶 | conversionTrackingStatus | 字串 | !=, =, LIKE |
帳戶 | enhancedConversionsForLeadsEnabled | Boolean | |
帳戶 | googleAdsConversionCustomer | 字串 | |
帳戶 | status | 字串 | !=, = |
帳戶 | allConversionsByConversionDate | Double | !=, =, <, > |
帳戶 | allConversionsValueByConversionDate | Double | !=, =, <, > |
帳戶 | conversionsByConversionDate | Double | !=, =, <, > |
帳戶 | conversionsValueByConversionDate | Double | !=, =, <, > |
帳戶 | valuePerAllConversionsByConversionDate | Double | !=, =, <, > |
帳戶 | videoViews | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶 | 按一下 | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶 | invalidClicks | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶 | costPerAllConversions | Double | !=, =, <, > |
帳戶 | costPerConversion | Double | !=, =, <, > |
帳戶 | 轉換 | Double | !=, =, <, > |
帳戶 | absoluteTopImpressionPercentage | Double | !=, =, <, > |
帳戶 | 印模 | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶 | topImpressionPercentage | Double | !=, =, <, > |
帳戶 | averageCpc | Double | !=, =, <, > |
帳戶 | activeViewMeasurableCostMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶 | averageCost | Double | !=, =, <, > |
帳戶 | ctr | Double | !=, =, <, > |
帳戶 | activeViewCtr | Double | !=, =, <, > |
帳戶 | searchImpressionShare | Double | !=, =, <, > |
帳戶 | conversionAction | 字串 | !=, = |
帳戶 | conversionActionCategory | 字串 | !=, = |
帳戶 | conversionActionName | 字串 | !=, =, LIKE |
帳戶預算 | resourceName | 字串 | !=, = |
帳戶預算 | status | 字串 | !=, = |
帳戶預算 | proposedEndTimeType | 字串 | !=, = |
帳戶預算 | approvedEndTimeType | 字串 | !=, = |
帳戶預算 | id | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶預算 | billingSetup | 字串 | !=, = |
帳戶預算 | name | 字串 | !=, =, LIKE |
帳戶預算 | approvedStartDateTime | DateTime | BETWEEN、=、<、>、<=、>= |
帳戶預算 | proposedSpendingLimitMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶預算 | approvedSpendingLimitMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶預算 | adjustedSpendingLimitMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
帳戶預算 | amountServedMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | resourceName | 字串 | !=, =, LIKE |
廣告群組 | status | 字串 | !=, =, LIKE |
廣告群組 | type | 字串 | !=, =, LIKE |
廣告群組 | id | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | name | 字串 | !=, =, LIKE |
廣告群組 | 行銷活動 | 字串 | !=, = |
廣告群組 | cpcBidMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | targetCpaMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | cpmBidMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | cpvBidMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | targetCpmMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | effectiveTargetCpaMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | date | 日期 | BETWEEN、=、<、>、<=、>= |
廣告群組 | costMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | useAudienceGrouped | Boolean | !=, = |
廣告群組 | effectiveCpcBidMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | allConversionsByConversionDate | Double | !=, =, <, > |
廣告群組 | allConversionsValueByConversionDate | Double | !=, =, <, > |
廣告群組 | conversionsByConversionDate | Double | !=, =, <, > |
廣告群組 | conversionsValueByConversionDate | Double | !=, =, <, > |
廣告群組 | valuePerAllConversionsByConversionDate | Double | !=, =, <, > |
廣告群組 | valuePerConversionsByConversionDate | Double | !=, =, <, > |
廣告群組 | averageCost | Double | !=, =, <, > |
廣告群組 | costPerAllConversions | Double | !=, =, <, > |
廣告群組 | costPerConversion | Double | !=, =, <, > |
廣告群組 | averagePageViews | Double | !=, =, <, > |
廣告群組 | videoViews | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | 按一下 | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | allConversions | Double | !=, =, <, > |
廣告群組 | averageCpc | Double | !=, =, <, > |
廣告群組 | absoluteTopImpressionPercentage | Double | !=, =, <, > |
廣告群組 | 印模 | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組 | topImpressionPercentage | Double | !=, =, <, > |
廣告群組 | activeViewCtr | Double | !=, =, <, > |
廣告群組 | ctr | Double | !=, =, <, > |
廣告群組 | searchTopImpressionShare | Double | !=, =, <, > |
廣告群組 | searchImpressionShare | Double | !=, =, <, > |
廣告群組 | searchAbsoluteTopImpressionShare | Double | !=, =, <, > |
廣告群組 | relativeCtr | Double | !=, =, <, > |
廣告群組 | conversionAction | 字串 | !=, = |
廣告群組 | conversionActionCategory | 字串 | !=, = |
廣告群組 | conversionActionName | 字串 | !=, =, LIKE |
廣告群組 | updateMask | 字串 | |
廣告群組 | 建立 | Struct | |
廣告群組 | update | Struct | |
廣告群組 | primaryStatus | 字串 | !=, = |
廣告群組 | primaryStatusReasons | 清單 | |
廣告群組廣告 | resourceName | 字串 | !=, = |
廣告群組廣告 | id | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組廣告 | status | 字串 | !=, = |
廣告群組廣告 | labels | 清單 | |
廣告群組廣告 | adGroup | 字串 | !=, = |
廣告群組廣告 | costMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組廣告 | approvalStatus | 字串 | !=, = |
廣告群組廣告 | reviewStatus | 字串 | !=, = |
廣告群組廣告 | adStrength | 字串 | !=, = |
廣告群組廣告 | type | 字串 | !=, = |
廣告群組廣告 | businessName | 字串 | !=, =, LIKE |
廣告群組廣告 | date | 日期 | BETWEEN、=、<、>、<=、>= |
廣告群組廣告 | allConversionsByConversionDate | Double | !=, =, <, > |
廣告群組廣告 | allConversionsValueByConversionDate | Double | !=, =, <, > |
廣告群組廣告 | conversionsByConversionDate | Double | !=, =, <, > |
廣告群組廣告 | conversionsValueByConversionDate | Double | !=, =, <, > |
廣告群組廣告 | valuePerAllConversionsByConversionDate | Double | !=, =, <, > |
廣告群組廣告 | valuePerConversionsByConversionDate | Double | !=, =, <, > |
廣告群組廣告 | activeViewMeasurableCostMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組廣告 | averageCost | Double | !=, =, <, > |
廣告群組廣告 | costPerAllConversions | Double | !=, =, <, > |
廣告群組廣告 | costPerConversion | Double | !=, =, <, > |
廣告群組廣告 | 按一下 | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組廣告 | averagePageViews | Double | !=, =, <, > |
廣告群組廣告 | videoViews | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組廣告 | allConversions | Double | !=, =, <, > |
廣告群組廣告 | averageCpc | Double | !=, =, <, > |
廣告群組廣告 | topImpressionPercentage | Double | !=, =, <, > |
廣告群組廣告 | 印模 | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
廣告群組廣告 | absoluteTopImpressionPercentage | Double | !=, =, <, > |
廣告群組廣告 | activeViewCtr | Double | !=, =, <, > |
廣告群組廣告 | ctr | Double | !=, =, <, > |
廣告群組廣告 | conversionAction | 字串 | !=, = |
廣告群組廣告 | conversionActionCategory | 字串 | !=, = |
廣告群組廣告 | conversionActionName | 字串 | !=, =, LIKE |
廣告群組廣告 | updateMask | 字串 | |
廣告群組廣告 | 建立 | Struct | |
廣告群組廣告 | update | Struct | |
廣告群組廣告 | policyValidationParameter | Struct | |
廣告群組廣告 | primaryStatus | 字串 | !=, = |
廣告群組廣告 | primaryStatusReasons | 清單 | |
Campaign | resourceName | 字串 | !=, = |
Campaign | status | 字串 | !=, = |
Campaign | baseCampaign | 字串 | !=, = |
Campaign | name | 字串 | !=, =, LIKE |
Campaign | id | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
Campaign | campaignBudget | 字串 | !=, =, LIKE |
Campaign | startDate | 日期 | BETWEEN、=、<、>、<=、>= |
Campaign | endDate | 日期 | BETWEEN、=、<、>、<=、>= |
Campaign | adServingOptimizationStatus | 字串 | !=, = |
Campaign | advertisingChannelType | 字串 | !=, = |
Campaign | advertisingChannelSubType | 字串 | !=, = |
Campaign | experimentType | 字串 | !=, = |
Campaign | servingStatus | 字串 | !=, = |
Campaign | biddingStrategyType | 字串 | !=, = |
Campaign | domainName | 字串 | !=, =, LIKE |
Campaign | languageCode | 字串 | !=, =, LIKE |
Campaign | useSuppliedUrlsOnly | Boolean | !=, = |
Campaign | positiveGeoTargetType | 字串 | !=, = |
Campaign | negativeGeoTargetType | 字串 | !=, = |
Campaign | paymentMode | 字串 | !=, = |
Campaign | optimizationGoalTypes | 清單 | |
Campaign | date | 日期 | BETWEEN、=、<、>、<=、>= |
Campaign | averageCost | Double | |
Campaign | 按一下 | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
Campaign | costMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
Campaign | 印模 | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
Campaign | useAudienceGrouped | Boolean | !=, = |
Campaign | activeViewMeasurableCostMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
Campaign | costPerAllConversions | Double | !=, =, <, > |
Campaign | costPerConversion | Double | !=, =, <, > |
Campaign | invalidClicks | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
Campaign | publisherPurchasedClicks | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
Campaign | averagePageViews | Double | !=, =, <, > |
Campaign | videoViews | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
Campaign | allConversionsByConversionDate | Double | !=, =, <, > |
Campaign | allConversionsValueByConversionDate | Double | !=, =, <, > |
Campaign | conversionsByConversionDate | Double | !=, =, <, > |
Campaign | conversionsValueByConversionDate | Double | !=, =, <, > |
Campaign | valuePerAllConversionsByConversionDate | Double | !=, =, <, > |
Campaign | valuePerConversionsByConversionDate | Double | !=, =, <, > |
Campaign | allConversions | Double | !=, =, <, > |
Campaign | absoluteTopImpressionPercentage | Double | !=, =, <, > |
Campaign | searchAbsoluteTopImpressionShare | Double | !=, =, <, > |
Campaign | averageCpc | Double | !=, =, <, > |
Campaign | searchImpressionShare | Double | !=, =, <, > |
Campaign | searchTopImpressionShare | Double | !=, =, <, > |
Campaign | activeViewCtr | Double | !=, =, <, > |
Campaign | ctr | Double | !=, =, <, > |
Campaign | relativeCtr | Double | !=, =, <, > |
Campaign | updateMask | 字串 | |
Campaign | 建立 | Struct | |
Campaign | update | Struct | |
行銷活動預算 | resourceName | 字串 | !=, = |
行銷活動預算 | id | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
行銷活動預算 | status | 字串 | !=, = |
行銷活動預算 | deliveryMethod | 字串 | !=, = |
行銷活動預算 | period | 字串 | !=, = |
行銷活動預算 | type | 字串 | !=, = |
行銷活動預算 | name | 字串 | !=, =, LIKE |
行銷活動預算 | amountMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
行銷活動預算 | explicitlyShared | Boolean | !=, = |
行銷活動預算 | referenceCount | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
行銷活動預算 | hasRecommendedBudget | Boolean | !=, = |
行銷活動預算 | date | 日期 | BETWEEN、=、<、>、<=、>= |
行銷活動預算 | costMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
行銷活動預算 | startDate | 日期 | BETWEEN、=、<、>、<=、>= |
行銷活動預算 | endDate | 日期 | BETWEEN、=、<、>、<=、>= |
行銷活動預算 | maximizeConversionValueTargetRoas | Double | !=, =, <, > |
行銷活動預算 | maximizeConversionsTargetCpaMicros | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
行銷活動預算 | selectiveOptimizationConversionActions | 字串 | |
行銷活動預算 | averageCost | Double | !=, =, <, > |
行銷活動預算 | costPerAllConversions | Double | !=, =, <, > |
行銷活動預算 | costPerConversion | Double | !=, =, <, > |
行銷活動預算 | videoViews | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
行銷活動預算 | 按一下 | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
行銷活動預算 | allConversions | Double | !=, =, <, > |
行銷活動預算 | valuePerAllConversions | Double | !=, =, <, > |
行銷活動預算 | averageCpc | Double | !=, =, <, > |
行銷活動預算 | 印模 | BigInteger | 介於、=、!=、<、>、<=、>= 之間 |
行銷活動預算 | ctr | Double | !=, =, <, > |
行銷活動預算 | updateMask | 字串 | |
行銷活動預算 | 建立 | Struct | |
行銷活動預算 | update | Struct |
分割查詢
如果您想要在 Spark 中使用並行PARTITION_FIELD
,NUM_PARTITIONS
可以提供其他的 Spark LOWER_BOUND
選項 UPPER_BOUND
、、。透過這些參數,原始查詢會分割為可由 Spark 任務同時執行的子查詢NUM_PARTITIONS
數目。
-
PARTITION_FIELD
:用於分割查詢的欄位名稱。 -
LOWER_BOUND
:所選分割區欄位的包含下限值。對於日期,我們接受 Spark SQL 查詢中使用的 Spark 日期格式。有效值的範例:
"2024-02-06"
。 -
UPPER_BOUND
:所選分割區欄位的專屬上限值。 -
NUM_PARTITIONS
:分割區數量。
下表會擷取實體分割欄位支援詳細資訊。
實體名稱 | 分割欄位 | 資料類型 |
---|---|---|
廣告群組廣告 | date | 日期 |
廣告群組 | date | 日期 |
Campaign | date | 日期 |
行銷活動預算 | date | 日期 |
範例
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"
}
)