包含篩選及排序廣告群組客群清單的方法。 如需選取器的相關資訊，請參閱 選取器。
使用範例：
// Gets the iterator that iterates all ad group audiences
// in the account.
var iterator = AdsApp.adGroups().get();
// Loops through all ad groups in the account.
while (iterator.hasNext()) {
var adGroup = iterator.next();
// Gets the iterator that iterates all ad group audiences
// in the ad group audience.
var audienceIterator = adGroup.targeting().audiences()
.withLimit(10)
.withIds("123456789")
.get();
// Loops through all ad group audiences in the ad group audience.
while (audienceIterator.hasNext()) {
var audience = iterator.next();
}
}
方法
| 方法名稱 | 傳回類型 | 描述 |
|---|---|---|
| forDateRange (Object dateFrom， Object dateTo) | AdGroupAudienceSelector | 套用選取效能指標的開始日期和結束日期。 |
| forDateRange (字串 dateRange) | AdGroupAudienceSelector | 套用預先定義的日期範圍以選取效能指標。 |
| get | AdGroupAudienceIterator | 取得用來逐一查看廣告群組客群清單的反覆運算器。 |
| orderBy (字串 orderBy) | AdGroupAudienceSelector | 將指定的順序套用至選取的廣告群組客群。 |
| withCondition (字串條件) | AdGroupAudienceSelector | 將篩選條件套用至廣告群組客群。 |
| withIds (string[] ids) | AdGroupAudienceSelector | 取得具有指定識別碼的廣告群組客群。 |
| withLimit (int limit) | AdGroupAudienceSelector | 取得符合選取準則的前 n 個廣告群組客群。 |
forDateRange (Object dateFrom， Object dateTo)
套用選取效能指標的開始日期和結束日期。
只有在下列情況下才指定日期範圍：
- 您套用參照效能計量欄位的條件或排序。
- 您想要取得所選取物件的效能資料。 例如，如果您打算呼叫
getStats()方法。
您可以使用字串或物件指定日期參數。 若要使用字串，請以 YYYYMMDD 的形式指定日期。 如果您使用物件，請建立具有下列欄位的物件：
- 年
- 月
- 天
例如：
var date = {year: 2018, month: 5, day: 13};
月份為以一為基礎，其中 1 是 1 月，12 為 12 月。
日期範圍包括周邊。 如果您指定多個日期範圍，則只會使用最後一個日期範圍。
引數
| 名稱 | 類型 | 描述 |
|---|---|---|
| dateFrom | 物件 | 指定要包含在選取器中的廣告成效資料的日期範圍的開始日期。 使用表單 YYYYMMDD 中的字串或表單 {year： 2020， month： 12， day： 31} 中的物件指定日期。 |
| dateTo | 物件 | 指定要包含在選取器中的廣告成效資料之日期範圍的結束日期。 使用表單 YYYYMMDD 中的字串或表單 {year： 2020， month： 12， day： 1} 中的物件指定日期。 |
傳回
| 類型 | 描述 |
|---|---|
| AdGroupAudienceSelector | 已套用日期範圍的選取器。 |
forDateRange (字串 dateRange)
套用預先定義的日期範圍以選取效能指標。
只有在下列情況下才指定日期範圍：
- 您套用參照效能計量欄位的條件或排序。
- 您想要取得所選取物件的效能資料。 例如，如果您打算呼叫
getStats()方法。
如果您指定多個日期範圍，則只會使用最後一個日期範圍。
支援的日期範圍值：
- 今天
- 昨天
- LAST_WEEK
- LAST_BUSINESS_WEEK
- LAST_7_DAYS
- THIS_WEEK_SUN_TODAY
- LAST_14_DAYS
- LAST_30_DAYS
- LAST_WEEK_SUN_SAT
- THIS_MONTH
- LAST_MONTH
- ALL_TIME
引數
| 名稱 | 類型 | 描述 |
|---|---|---|
| dateRange | 字串 | 預先定義的日期範圍字串，指定要包含在選取器中的廣告成效資料。 預先定義的日期範圍字串會區分大小寫。 可能區分大小寫的值有：TODAY、YESTERDAY、LAST_WEEK、LAST_BUSINESS_WEEK、LAST_7_DAYS、THIS_WEEK_SUN_TODAY、LAST_14_DAYS、LAST_30_DAYS、LAST_WEEK_SUN_SAT、THIS_MONTH、LAST_MONTH、ALL_TIME。 |
傳回
| 類型 | 描述 |
|---|---|
| AdGroupAudienceSelector | 已套用日期範圍的選取器。 |
取得
取得用來逐一查看廣告群組客群清單的 反覆運算器 。
傳回
| 類型 | 描述 |
|---|---|
| AdGroupAudienceIterator | 用來逐一查看所選廣告群組客群的反覆運算器。 |
orderBy (字串 orderBy)
將指定的順序套用至選取的廣告群組客群。
在 “columnName orderDirection” 表單中指定 orderBy 參數，其中：
- columnName 是支援的其中一個 欄位。
- orderDirection 是要針對結果排序的順序。 設定為 ASC 以遞增順序排序結果，或設定為 DESC 以遞減順序排序結果。 預設值為 ASC。
例如，下列呼叫會依 AverageCPC 遞增順序傳回廣告群組客群。
selector = selector.orderBy("AverageCpc");
選取器僅支援依一個欄位來排序實體。 您不得依欄位 x、在 x 內依欄位 y 排序實體清單，依此類推。 如果您在鏈結或單獨的選擇器呼叫中指定多個 orderBy() 呼叫，則指令碼會使用上次 orderBy() 呼叫中指定的欄位對實體清單進行排序。
引數
| 名稱 | 類型 | 描述 |
|---|---|---|
| orderBy | 字串 | 要申請的順序。 |
傳回
| 類型 | 描述 |
|---|---|
| AdGroupAudienceSelector | 已套用排序的選擇器。 |
withCondition (字串條件)
將篩選條件套用至廣告群組客群。
在「columnName operator value」表單中指定 條件 參數，其中：
- columnName 是 支援的資料行之一。 如果 columName 設定為效能計量資料行名稱，您必須使用 forDateRange (字串 dateRange) 或 forDateRange (Object dateFrom， Object dateTo) 指定日期範圍。
- 運算子 是支援的 運算子之一。
運算子
您使用的運算子取決於資料欄位的類型。 運算子會區分大小寫。 例如，使用 STARTS_WITH 而非 starts_with。
包含整數和長值之欄的運算子：
<
<=
>
>=
=
!=
包含雙精度值之欄位的運算子：
<
>
包含字串值之欄位的運算子：
=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE
包含列舉值之欄位的運算子：
=
!=
IN []
NOT_IN []
包含字串陣列之欄位的運算子：
CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE
支援的資料欄位
廣告群組客群篩選支援的資料欄位。 名稱區分大小寫。
以下是您可以指定的效能計量資料欄位。
| 欄位 | 類型 | 範例 |
|---|---|---|
| AbsoluteTopImpressionRate | double | withCondition("AbsoluteTopImpressionRate > 0.25") |
| AverageCpc | double | withCondition("AverageCpc < 2.75") |
| AverageCpm | double | withCondition("AverageCpm > 0.65") |
| ClickConversionRate | double | withCondition("ClickConversionRate > 0.25") |
| 點選次數 | long | withCondition("Clicks >= 33") |
| ConvertedClicks | long | withCondition("ConvertedClicks >= 10") |
| 成本 | double | withCondition("Cost > 3.25")費用以帳戶貨幣表示。 |
| Ctr | double | withCondition("Ctr > 0.05")點選率在 0..1 的範圍內，因此使用 0.05 表示 5% 的點選率。 |
| 閱聽 | long | withCondition("Impressions > 10") |
| TopImpressionRate | double | withCondition("TopImpressionRate > 0.25") |
以下是您可以指定的實體屬性。
| 欄位 | 類型 | 範例 |
|---|---|---|
| AdGroupName | 字串 | 關聯廣告群組的名稱。withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'") |
| AdGroupStatus | 列舉 | 關聯廣告群組的狀態。 可能會區分大小寫的值如下：
withCondition("AdGroupStatus = PAUSED") |
| AudienceId | long | 相關聯客群的 ID。withCondition("AudienceId = 123456789") |
| CampaignName | 字串 | 包含關聯廣告群組之廣告活動的名稱。withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'") |
| CampaignStatus | 列舉 | 包含關聯廣告群組的廣告活動狀態。 可能會區分大小寫的值如下：
withCondition("CampaignStatus = PAUSED") |
| 狀態 | 列舉 | 關聯的狀態。 可能會區分大小寫的值如下：
withCondition("Status = ENABLED") |
| UserListName | 字串 | 相關聯客群的名稱。withCondition("UserListName = 'foo'") |
引數
| 名稱 | 類型 | 描述 |
|---|---|---|
| 條件 | 字串 | 要套用至選取器的條件。 |
傳回
| 類型 | 描述 |
|---|---|
| AdGroupAudienceSelector | 具有套用條件的選擇器。 |
withIds (string[] ids)
取得具有指定識別碼的廣告群組客群。
您可以將一或多個條件套用至選取器。 條件鏈會被視為 AND 運算。 例如，只有在條件 A 為 True 且條件 B 為 True 時，才會選取實體。 例如，下列呼叫只會選取廣告群組客群 33333。
var selector = AdsApp.adGroups()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
引數
| 名稱 | 類型 | 描述 |
|---|---|---|
| IDS | string[] | 廣告群組客群 ID 的陣列。 如需限制，請參閱 指令碼執行限制。 |
傳回
| 類型 | 描述 |
|---|---|
| AdGroupAudienceSelector | 具有套用識別碼的選擇器。 |
withLimit (int limit)
取得符合選取準則的前 n 個廣告群組客群。
引數
| 名稱 | 類型 | 描述 |
|---|---|---|
| 限制 | int | 要返回的廣告群組客群數目。 實際數字可能會更少。 |
傳回
| 類型 | 描述 |
|---|---|
| AdGroupAudienceSelector | 已套用限制的選取器。 |