AdSelector

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

วิธี

ชื่อเมธอด	ชนิดการส่งกลับ	คำอธิบาย
forDateRange(Object dateFrom, Object dateTo)	AdSelector	ใช้วันที่เริ่มต้นและวันที่สิ้นสุดสําหรับการเลือกเมตริกประสิทธิภาพการทํางาน
forDateRange(สตริง dateRange)	AdSelector	ใช้ช่วงวันที่ที่กําหนดไว้ล่วงหน้าสําหรับการเลือกเมตริกประสิทธิภาพการทํางาน
รับ	AdIterator	รับตัวทําซ้ําที่ใช้ในการทําซ้ําผ่านรายการโฆษณา
orderBy(string orderBy)	AdSelector	นําการเรียงลําดับที่ระบุไปใช้กับโฆษณาที่เลือก
withCondition(เงื่อนไขสตริง)	AdSelector	ใช้เกณฑ์การกรองกับโฆษณา
withIds(string[] ids)	AdSelector	รับโฆษณาด้วยรหัสที่ระบุ
withLimit(ขีดจํากัด Int)	AdSelector	รับโฆษณา n อันดับแรกที่ตรงกับเกณฑ์การเลือก

forDateRange(Object dateFrom, Object dateTo)

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

ระบุช่วงวันที่เฉพาะเมื่อ:

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

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

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

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

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

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

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

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

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

กลับ

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

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

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

ชื่อ	ชนิด	คำอธิบาย
dateRange	สตริง	สตริงช่วงวันที่ที่กําหนดไว้ล่วงหน้าที่ระบุข้อมูลประสิทธิภาพการทํางานที่จะรวมไว้ในตัวเลือก สตริงช่วงวันที่ที่กําหนดไว้ล่วงหน้าต้องตรงตามตัวพิมพ์ใหญ่-เล็ก

กลับ

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

รับ

รับ ตัวทําซ้ํา ที่ใช้ในการทําซ้ําผ่านรายการโฆษณา

กลับ

ชนิด	คำอธิบาย
AdIterator	ตัวทําซ้ําที่ใช้ในการทําซ้ําผ่านโฆษณาที่เลือก

orderBy(ลําดับสตริง By)

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

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

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

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

selector = selector.orderBy("AverageCpc");

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

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

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

กลับ

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

withCondition(เงื่อนไขสตริง)

ใช้เกณฑ์การกรองกับโฆษณา

ระบุพารามิเตอร์ เงื่อนไข ในแบบฟอร์ม "ค่าตัวดําเนินการ columnName" ที่:

• columnName เป็นหนึ่งในคอลัมน์ที่ได้รับการสนับสนุน ถ้า columName ถูกตั้งค่าเป็นชื่อคอลัมน์เมตริกประสิทธิภาพการทํางาน คุณต้องระบุช่วงวันที่โดยใช้ forDateRange(String 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	คู่	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 สําหรับ 5% CTR
อิมเพรสชัน	ยาว	withCondition("Impressions > 10")
TopImpressionRate	คู่	withCondition("TopImpressionRate > 0.25")

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

คอลัมน์	ชนิด	ตัว อย่าง เช่น
สถานะ	การแจงนับ	สถานะของโฆษณา ค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้คือ: เปิด หยุด ชั่ว คราว ถูก เอา ออก ตัวอย่างนี้จะแสดงเฉพาะโฆษณาที่เปิดใช้งานเท่านั้น withCondition("Status = ENABLED")
ชนิด	การแจงนับ	ประเภทที่สืบทอดมาของโฆษณา ค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้คือ: EXPANDED_TEXT_AD ตัวอย่างนี้จะแสดงเฉพาะโฆษณาแบบข้อความที่ขยายแล้วเท่านั้น withCondition("Type = EXPANDED_TEXT_AD")
CombinedApprovalStatus	สาย อักขระ	สถานะการอนุมัติของโฆษณา ค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้คือ: อนุมัติ APPROVED_LIMITED UNDER_REVIEW ไม่อนุมัติ สําหรับข้อมูลเกี่ยวกับค่าเหล่านี้ ให้ดู ค่าสถานะการอนุมัติของบรรณาธิการ ตัวอย่างนี้แสดงโฆษณาที่ต้องการความสนใจ withCondition("CombinedApprovalStatus IN ['APPROVED_LIMITED', 'DISAPPROVED']")
CreativeFinalUrls	สาย อักขระ	URL สุดท้ายของโฆษณา withCondition("CreativeFinalUrls CONTAINS_IGNORE_CASE 'contoso.com'")
AdGroupName	สาย อักขระ	ชื่อของกลุ่มโฆษณาที่มีโฆษณาอยู่ withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus	การแจงนับ	สถานะของกลุ่มโฆษณาที่มีโฆษณาอยู่ ค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้คือ: เปิด หยุด ชั่ว คราว ถูก เอา ออก ตัวอย่างนี้จะแสดงเฉพาะโฆษณาที่กลุ่มโฆษณาหลักหยุดชั่วคราว withCondition("AdGroupStatus = PAUSED")
CampaignName	สาย อักขระ	ชื่อของแคมเปญที่มีโฆษณาอยู่ withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
สถานะของแคมเปญ	การแจงนับ	สถานะของแคมเปญที่มีโฆษณาอยู่ ค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้คือ: เปิด หยุด ชั่ว คราว ถูก เอา ออก ตัวอย่างนี้จะแสดงเฉพาะโฆษณาที่แคมเปญหลักหยุดชั่วคราว withCondition("CampaignStatus = PAUSED")
LabelNames	ชุดสตริง	รายการของชื่อป้ายชื่อแบบตรงตามตัวพิมพ์ใหญ่-เล็กอย่างน้อยหนึ่งชื่อ ใช้เพื่อรับโฆษณาที่เชื่อมโยงกับป้ายชื่อที่มีชื่อ withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
Id	ยาว	ID ของโฆษณาที่จะทดสอบ ตัวอย่างเช่น คุณสามารถใช้คอลัมน์นี้เพื่อตรวจสอบโฆษณาที่มี ID มากกว่า ID ที่ระบุได้ withCondition('Id > 1234')

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

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

กลับ

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

withIds(string[] ids)

รับโฆษณาด้วยรหัสที่ระบุ

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

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

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

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

กลับ

ชนิด	คำอธิบาย
AdSelector	ตัวเลือกที่มีการใช้รหัส

withLimit(ขีดจํากัด Int)

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

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

ชื่อ	ชนิด	คำอธิบาย
จำกัด	Int	จํานวนโฆษณาที่จะแสดง ตัวเลขจริงอาจน้อยกว่า

กลับ

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

ดูเพิ่มเติม

AdsApp.ads()