AdGroupAudienceSelector

ประกอบด้วยวิธีการกรองและการเรียงลําดับรายการผู้ชมกลุ่มโฆษณา สําหรับข้อมูลเกี่ยวกับ ตัวเลือก ให้ดูตัวเลือก

ตัวอย่างการใช้งาน:

    // 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(วัตถุ dateFrom, วัตถุ dateTo)	AdGroupAudienceSelector	ใช้วันที่เริ่มต้นและสิ้นสุดสําหรับการเลือกเมตริกประสิทธิภาพ
forDateRange(สตริง dateRange)	AdGroupAudienceSelector	ใช้ช่วงวันที่ที่กําหนดไว้ล่วงหน้าสําหรับการเลือกเมตริกประสิทธิภาพ
รับ	AdGroupAudienceIterator	รับตัวทําซ้ําที่ใช้ในการคํานวณซ้ําผ่านรายการของผู้ชมกลุ่มโฆษณา
orderBy(สตริง orderBy)	AdGroupAudienceSelector	นําการเรียงลําดับที่ระบุไปใช้กับผู้ชมกลุ่มโฆษณาที่เลือก
withCondition(เงื่อนไขสตริง)	AdGroupAudienceSelector	ใช้เกณฑ์การกรองกับผู้ชมกลุ่มโฆษณา
withIds(string[], ids)	AdGroupAudienceSelector	รับผู้ชมกลุ่มโฆษณาด้วย ID ที่ระบุ
withLimit(int limit)	AdGroupAudienceSelector	รับผู้ชมกลุ่มโฆษณา n อันดับแรกที่ตรงกับเกณฑ์การเลือก

forDateRange(วัตถุ dateFrom, วัตถุ dateTo)

ใช้วันที่เริ่มต้นและสิ้นสุดสําหรับการเลือกเมตริกประสิทธิภาพ

ระบุช่วงวันที่ก็ต่อเมื่อ:

• คุณนําเงื่อนไขหรือลําดับที่อ้างอิงเขตข้อมูลเมตริกประสิทธิภาพไปใช้
• คุณต้องการรับข้อมูลประสิทธิภาพการทํางานสําหรับวัตถุที่คุณกําลังเลือก ตัวอย่างเช่น ถ้าคุณวางแผนที่จะเรียกใช้เม getStats() ธอด

คุณสามารถระบุพารามิเตอร์วันที่โดยใช้สตริงหรือวัตถุ เมื่อต้องการใช้สตริง ให้ระบุวันที่ในรูปแบบ YYYYMMDD ถ้าคุณใช้วัตถุ ให้สร้างวัตถุที่มีเขตข้อมูลต่อไปนี้:

• ปี
• เดือน
• วัน

ตัวอย่างเช่น:

var date = {year: 2018, month: 5, day: 13};

เดือนเป็นฐานหนึ่ง โดยที่ 1 คือเดือนมกราคม และ 12 คือธันวาคม

ช่วงวันที่นี้รวมอยู่แล้ว ถ้าคุณระบุช่วงวันที่หลายช่วง ระบบจะใช้เฉพาะช่วงวันที่ล่าสุดเท่านั้น

อาร์กิวเมนต์

ชื่อ	พิมพ์	คำอธิบาย
วันที่จาก	วัตถุ	วันที่เริ่มต้นของช่วงวันที่ที่ระบุข้อมูลประสิทธิภาพที่จะรวมอยู่ในตัวเลือก ระบุวันที่โดยใช้สตริงในรูปแบบ YYYYMMDD หรือวัตถุในฟอร์ม {year: 2020, month: 12, day: 31}
dateTo	วัตถุ	วันที่สิ้นสุดของช่วงวันที่ที่ระบุข้อมูลประสิทธิภาพที่จะรวมอยู่ในตัวเลือก ระบุวันที่โดยใช้สตริงในรูปแบบ YYYYMMDD หรือวัตถุในแบบฟอร์ม {year: 2020, month: 12, day: 1}

ส่งกลับ

พิมพ์	คำอธิบาย
AdGroupAudienceSelector	ตัวเลือกที่ใช้ช่วงวันที่

forDateRange(String 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

อาร์กิวเมนต์

ชื่อ	พิมพ์	คำอธิบาย
ช่วงวันที่:	สตริง	สตริงช่วงวันที่ที่กําหนดไว้ล่วงหน้าที่ระบุข้อมูลประสิทธิภาพการทํางานเพื่อรวมไว้ในตัวเลือก สตริงช่วงวันที่ที่กําหนดไว้ล่วงหน้าจะเป็นแบบตรงตามตัวพิมพ์ใหญ่-เล็ก ค่าตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้: 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	iterator ที่ใช้เพื่อวนซ้ําผ่านผู้ชมกลุ่มโฆษณาที่เลือก

orderBy(สตริง orderBy)

นําการเรียงลําดับที่ระบุไปใช้กับผู้ชมกลุ่มโฆษณาที่เลือก

ระบุพารามิเตอร์ orderBy ในฟอร์ม "columnName orderDirection" โดยที่:

• columnName เป็นหนึ่งในคอลัมน์ที่ได้รับการสนับสนุน
• orderDirection คือลําดับในการเรียงลําดับผลลัพธ์ ตั้งค่าเป็น ASC เพื่อเรียงลําดับผลลัพธ์จากน้อยไปหามาก หรือ DESC เพื่อเรียงลําดับผลลัพธ์จากมากไปหาน้อย ค่าเริ่มต้นคือ ASC

ตัวอย่างเช่น การโทรต่อไปนี้จะส่งกลับกลุ่มเป้าหมายกลุ่มโฆษณาจากน้อยไปหามากตาม AverageCpc

selector = selector.orderBy("AverageCpc");

ตัวเลือกสนับสนุนการจัดลําดับเอนทิตีตามหนึ่งเขตข้อมูลเท่านั้น คุณไม่สามารถจัดลําดับรายการของเอนทิตีตามเขตข้อมูล x และภายใน x ตามเขตข้อมูล y และอื่นๆ ถ้าคุณระบุการโทรมากกว่าหนึ่งครั้งorderBy()ในสายโซ่หรือในสายตัวเลือกที่แยกต่างหาก สคริปต์จะเรียงลําดับรายการของเอนทิตีโดยใช้เขตข้อมูลที่ระบุในการโทรล่าสุดorderBy() 

อาร์กิวเมนต์

ชื่อ	พิมพ์	คำอธิบาย
orderBy	สตริง	ลําดับที่จะนําไปใช้

ส่งกลับ

พิมพ์	คำอธิบาย
AdGroupAudienceSelector	ตัวเลือกที่มีการเรียงลําดับ

withCondition(String condition)

ใช้เกณฑ์การกรองกับผู้ชมกลุ่มโฆษณา

ระบุพารามิเตอร์ เงื่อนไข ในรูปแบบ "columnName operator value" โดยที่:

• columnName เป็นหนึ่งในคอลัมน์ที่ได้รับการสนับสนุน ถ้า columName ถูกตั้งค่าเป็นชื่อคอลัมน์ของเมตริกประสิทธิภาพ คุณต้องระบุช่วงวันที่โดยใช้ forDateRange(String dateRange) หรือ forDateRange(Object dateFrom, Object dateTo)
• เป็นหนึ่งในตัวดําเนินการที่ได้รับการสนับสนุน

ตัวดําเนินการ

ตัวดําเนินการที่คุณใช้จะขึ้นอยู่กับชนิดของคอลัมน์ ตัวดําเนินการต้องตรงตามตัวพิมพ์ใหญ่-เล็ก ตัวอย่างเช่น ใช้ STARTS_WITH แทน starts_with

ตัวดําเนินการสําหรับคอลัมน์ที่มีจํานวนเต็มและค่าแบบยาว:

<
<=
>
>=
=
!=

ตัวดําเนินการสําหรับคอลัมน์ที่มีค่า double:

<
>

ตัวดําเนินการสําหรับคอลัมน์ที่มีค่าสตริง มีดังนี้

=
!=
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	สองเท่า	withCondition("AbsoluteTopImpressionRate > 0.25")
AverageCpc	สองเท่า	withCondition("AverageCpc < 2.75")
AverageCpm	สองเท่า	withCondition("AverageCpm > 0.65")
ClickConversionRate	สองเท่า	withCondition("ClickConversionRate > 0.25")
คลิก	แบบยาว	withCondition("Clicks >= 33")
ConvertedClicks	แบบยาว	withCondition("ConvertedClicks >= 10")
ต้นทุน	สองเท่า	withCondition("Cost > 3.25") ค่าใช้จ่ายเป็นสกุลเงินของบัญชี
Ctr	สองเท่า	withCondition("Ctr > 0.05") CTR อยู่ในช่วง 0..1 ดังนั้นใช้ 0.05 สําหรับ CTR 5%
ความประทับใจ	แบบยาว	withCondition("Impressions > 10")
อัตราการแสดงผลสูงสุด	สองเท่า	withCondition("TopImpressionRate > 0.25")

ต่อไปนี้คือคุณสมบัติของเอนทิตีที่คุณอาจระบุ

คอลัมน์	พิมพ์	ตัวอย่าง
AdGroupName	สตริง	ชื่อกลุ่มโฆษณาของสมาคม withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus	การแจงนับ	สถานะของกลุ่มโฆษณาของสมาคม ค่าตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้ ได้แก่ เปิดใช้งาน หยุดชั่วคราว เอาออก ตัวอย่างนี้จะส่งกลับเฉพาะกลุ่มเป้าหมายกลุ่มโฆษณาที่กลุ่มโฆษณาหลักหยุดชั่วคราว withCondition("AdGroupStatus = PAUSED")
AudienceId	แบบยาว	ID ของผู้ชมที่เกี่ยวข้อง withCondition("AudienceId = 123456789")
ชื่อแคมเปญ	สตริง	ชื่อของแคมเปญที่มีกลุ่มโฆษณาของสมาคม withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus	การแจงนับ	สถานะของแคมเปญที่มีกลุ่มโฆษณาของสมาคม ค่าตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้ ได้แก่ เปิดใช้งาน หยุดชั่วคราว เอาออก ตัวอย่างนี้จะส่งกลับเฉพาะกลุ่มเป้าหมายกลุ่มโฆษณาที่แคมเปญหลักหยุดชั่วคราว withCondition("CampaignStatus = PAUSED")
สถานะ	การแจงนับ	สถานะของความสัมพันธ์ ค่าตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้ ได้แก่ เปิดใช้งาน หยุดชั่วคราว เอาออก ตัวอย่างนี้จะส่งกลับเฉพาะผู้ชมกลุ่มโฆษณาที่เปิดใช้งานเท่านั้น withCondition("Status = ENABLED")
UserListName	สตริง	ชื่อของผู้ชมที่เชื่อมโยง withCondition("UserListName = 'foo'")

อาร์กิวเมนต์

ชื่อ	พิมพ์	คำอธิบาย
เงื่อนไข	สตริง	เงื่อนไขที่จะนําไปใช้กับตัวเลือก

ส่งกลับ

พิมพ์	คำอธิบาย
AdGroupAudienceSelector	ตัวเลือกที่มีเงื่อนไขที่ใช้

withIds(string[], ids)

รับผู้ชมกลุ่มโฆษณาด้วย ID ที่ระบุ

คุณสามารถใช้เงื่อนไขอย่างน้อยหนึ่งข้อกับตัวเลือกได้ ห่วงโซ่ของเงื่อนไขจะถือว่าเป็นการดําเนินการ AND ตัวอย่างเช่น เอนทิตีจะถูกเลือกก็ต่อเมื่อเงื่อนไข A เป็นจริง และเงื่อนไข B เป็นจริง ตัวอย่างเช่น การโทรต่อไปนี้จะเลือกเฉพาะกลุ่มเป้าหมายกลุ่มโฆษณา 33333

var selector = AdsApp.adGroups()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

อาร์กิวเมนต์

ชื่อ	พิมพ์	คำอธิบาย
รหัส	สตริง[]	อาร์เรย์ของรหัสผู้ชมกลุ่มโฆษณา สําหรับขีดจํากัด โปรดดูขีดจํากัดการดําเนินการสคริปต์

ส่งกลับ

พิมพ์	คำอธิบาย
AdGroupAudienceSelector	ตัวเลือกที่มี ID ที่นําไปใช้

withLimit(int limit)

รับผู้ชมกลุ่มโฆษณา n อันดับแรกที่ตรงกับเกณฑ์การเลือก

อาร์กิวเมนต์

ชื่อ	พิมพ์	คำอธิบาย
ขีดจํากัด	int	จํานวนผู้ชมกลุ่มโฆษณาที่จะกลับมา จํานวนจริงอาจน้อยกว่า

ส่งกลับ

พิมพ์	คำอธิบาย
AdGroupAudienceSelector	ตัวเลือกที่มีการใช้ขีดจํากัด