หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ประกอบด้วยวิธีการสําหรับการกรองและการจัดลําดับรายการของตําแหน่งที่ตั้งเป้าหมาย สําหรับข้อมูลเกี่ยวกับตัวเลือก ดูตัวเลือก
การใช้งานตัวอย่าง:
var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();
var iterator = shoppingCampaign.targeting().targetedLocations()
.withLimit(10)
.withIds("123456789")
.get();
while (iterator.hasNext()) {
var targetedLocation = iterator.next();
}
วิธี
| ชื่อเมธอด | ชนิดการส่งกลับ | คำอธิบาย |
|---|---|---|
| forDateRange(Object dateFrom, Object dateTo) | TargetedLocationSelector | ใช้วันที่เริ่มต้นและวันที่สิ้นสุดสําหรับการเลือกเมตริกประสิทธิภาพการทํางาน |
| forDateRange(สตริง dateRange) | TargetedLocationSelector | ใช้ช่วงวันที่ที่กําหนดไว้ล่วงหน้าสําหรับการเลือกเมตริกประสิทธิภาพการทํางาน |
| รับ | TargetedLocationIterator | รับตัวทําซ้ําที่ใช้ในการทําซ้ําผ่านรายการของตําแหน่งที่ตั้งเป้าหมาย |
| orderBy(string orderBy) | TargetedLocationSelector | นําการเรียงลําดับที่ระบุไปใช้กับตําแหน่งที่ตั้งเป้าหมายที่เลือก |
| withCondition(เงื่อนไขสตริง) | TargetedLocationSelector | ใช้เกณฑ์การกรองกับตําแหน่งที่ตั้งเป้าหมาย |
| withIds(string[] ids) | TargetedLocationSelector | รับตําแหน่งที่ตั้งที่กําหนดเป้าหมายด้วยรหัสที่ระบุ |
| withLimit(ขีดจํากัด Int) | TargetedLocationSelector | รับที่ตั้งเป้าหมาย n อันดับแรกที่ตรงกับเกณฑ์การเลือก |
forDateRange(Object dateFrom, Object dateTo)
ใช้วันที่เริ่มต้นและวันที่สิ้นสุดสําหรับการเลือกเมตริกประสิทธิภาพการทํางาน
ระบุช่วงวันที่เฉพาะเมื่อ:
- คุณใช้เงื่อนไขหรือการจัดลําดับที่อ้างอิงเขตข้อมูลเมตริกประสิทธิภาพการทํางาน
- คุณต้องการรับข้อมูลประสิทธิภาพการทํางานสําหรับวัตถุที่คุณกําลังเลือก ตัวอย่างเช่น หากคุณวางแผนที่จะเรียกใช้
getStats()วิธีการ
คุณสามารถระบุพารามิเตอร์วันที่โดยใช้สตริงหรือวัตถุได้ เมื่อต้องการใช้สตริง ให้ระบุวันที่ในแบบฟอร์ม YYYYMMDD ถ้าคุณใช้วัตถุ ให้สร้างวัตถุที่มีเขตข้อมูลต่อไปนี้:
- ปี
- เดือน
- วัน
ตัวอย่างเช่น:
var date = {year: 2018, month: 5, day: 13};
เดือนจะเป็นแบบหนึ่งโดยที่ 1 คือมกราคมและ 12 คือธันวาคม
ช่วงวันที่รวมอยู่ด้วย ถ้าคุณระบุช่วงวันที่หลายช่วง จะใช้ช่วงวันที่ล่าสุดเท่านั้น
อาร์กิวเมนต์
| ชื่อ | ชนิด | คำอธิบาย |
|---|---|---|
| dateFrom | วัตถุ | วันที่เริ่มต้นของช่วงวันที่ที่ระบุข้อมูลประสิทธิภาพการทํางานที่จะรวมไว้ในตัวเลือก |
| dateTo | วัตถุ | วันที่สิ้นสุดของช่วงวันที่ที่ระบุข้อมูลประสิทธิภาพการทํางานที่จะรวมไว้ในตัวเลือก |
กลับ
| ชนิด | คำอธิบาย |
|---|---|
| TargetedLocationSelector | ตัวเลือกที่มีการใช้ช่วงวันที่ |
forDateRange(String dateRange)
ใช้ช่วงวันที่ที่กําหนดไว้ล่วงหน้าสําหรับการเลือกเมตริกประสิทธิภาพการทํางาน
ค่าช่วงวันที่ที่สนับสนุน:
- วันนี้
- เมื่อวานนี้
- 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
ระบุช่วงวันที่เฉพาะเมื่อ:
- คุณใช้เงื่อนไขหรือการจัดลําดับที่อ้างอิงเขตข้อมูลเมตริกประสิทธิภาพการทํางาน
- คุณต้องการรับข้อมูลประสิทธิภาพการทํางานสําหรับวัตถุที่คุณกําลังเลือก ตัวอย่างเช่น หากคุณวางแผนที่จะเรียกใช้
getStats()วิธีการ
ถ้าคุณระบุช่วงวันที่หลายช่วง จะใช้ช่วงวันที่ล่าสุดเท่านั้น
อาร์กิวเมนต์
| ชื่อ | ชนิด | คำอธิบาย |
|---|---|---|
| dateRange | สตริง | สตริงช่วงวันที่ที่กําหนดไว้ล่วงหน้าที่ระบุข้อมูลประสิทธิภาพการทํางานที่จะรวมไว้ในตัวเลือก สตริงช่วงวันที่ที่กําหนดไว้ล่วงหน้าต้องตรงตามตัวพิมพ์ใหญ่-เล็ก |
กลับ
| ชนิด | คำอธิบาย |
|---|---|
| TargetedLocationSelector | ตัวเลือกที่มีการใช้ช่วงวันที่ |
รับ
รับ ตัวทําซ้ํา ที่ใช้ในการทําซ้ําผ่านรายการของตําแหน่งที่ตั้งเป้าหมาย
กลับ
| ชนิด | คำอธิบาย |
|---|---|
| TargetedLocationIterator | ตัวทําซ้ําที่ใช้ในการทําซ้ําผ่านตําแหน่งที่ตั้งเป้าหมายที่เลือก |
orderBy(string orderBy)
นําการเรียงลําดับที่ระบุไปใช้กับตําแหน่งที่ตั้งเป้าหมายที่เลือก
ระบุพารามิเตอร์ orderBy ในแบบฟอร์ม "columnName orderDirection" ที่:
- columnName เป็นหนึ่งในคอลัมน์ที่ได้รับการสนับสนุน
- orderDirection คือลําดับการเรียงลําดับผลลัพธ์ ตั้งค่าเป็น ASC เพื่อเรียงลําดับผลลัพธ์จากน้อยไปหามากหรือ DESC เพื่อเรียงลําดับผลลัพธ์จากมากไปหาน้อย ค่าเริ่มต้นคือ ASC
ตัวอย่างเช่น การเรียกต่อไปนี้จะส่งกลับผลลัพธ์จากน้อยไปหามากตาม AverageCpc
selector = selector.orderBy("AverageCpc");
ตัวเลือกสนับสนุนการจัดลําดับเอนทิตีตามเขตข้อมูลเดียวเท่านั้น คุณไม่สามารถจัดลําดับรายการของเอนทิตีตามเขตข้อมูล x และภายใน x ตามเขตข้อมูล y และอื่น ๆ ถ้าคุณระบุการเรียกมากกว่าหนึ่งorderBy()ครั้งในสายโซ่ หรือในการเรียกตัวเลือกที่แยกต่างหาก Scripts จะจัดลําดับรายการของเอนทิตีโดยใช้เขตข้อมูลที่ระบุในการเรียกใช้ครั้งล่าสุดorderBy()
อาร์กิวเมนต์
| ชื่อ | ชนิด | คำอธิบาย |
|---|---|---|
| orderBy | สาย อักขระ | การเรียงลําดับที่จะนําไปใช้ |
กลับ
| ชนิด | คำอธิบาย |
|---|---|
| TargetedLocationSelector | ตัวเลือกที่มีการใช้การจัดลําดับ |
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
คอลัมน์ที่สนับสนุนสําหรับการกรองตําแหน่งที่ตั้งเป้าหมาย ชื่อคอลัมน์ต้องตรงตามตัวพิมพ์ใหญ่-เล็ก
ต่อไปนี้คือคอลัมน์เมตริกประสิทธิภาพการทํางานที่คุณอาจระบุ
| คอลัมน์ | ชนิด | ตัว อย่าง เช่น | ตัวกรอง UI เว็บโฆษณาของ Microsoft |
|---|---|---|---|
| AbsoluteTopImpressionRate | คู่ | withCondition("AbsoluteTopImpressionRate > 0.25") |
Abs. Top Impr. อัตรา |
| AverageCpc | คู่ | withCondition("AverageCpc < 2.75") |
CPC โดยเฉลี่ย |
| AverageCpm | คู่ | withCondition("AverageCpm > 0.65") |
CPM โดยเฉลี่ย |
| 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 |
Ctr |
| อิมเพรสชัน | ยาว | withCondition("Impressions > 10") |
Impr. |
| TopImpressionRate | คู่ | withCondition("TopImpressionRate > 0.25") |
Top Impr. อัตรา |
อาร์กิวเมนต์
| ชื่อ | ชนิด | คำอธิบาย |
|---|---|---|
| เงื่อนไข | สาย อักขระ | เงื่อนไขที่จะเพิ่มลงในตัวเลือก |
กลับ
| ชนิด | คำอธิบาย |
|---|---|
| TargetedLocationSelector | ตัวเลือกที่มีการใช้เงื่อนไข |
withIds(string[] ids)
รับตําแหน่งที่ตั้งที่กําหนดเป้าหมายด้วยรหัสที่ระบุ
คุณอาจใช้เงื่อนไขอย่างน้อยหนึ่งข้อกับตัวเลือก ห่วงโซ่ของเงื่อนไขถือว่าเป็นการดําเนินการ AND ตัวอย่างเช่น เอนทิตีจะถูกเลือกเฉพาะเมื่อเงื่อนไข A เป็นจริงและเงื่อนไข B เป็นจริง ตัวอย่างเช่น การเรียกต่อไปนี้จะเลือกเฉพาะตําแหน่งที่ตั้งเป้าหมาย 72
var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();
var iterator = shoppingCampaign.targeting().targetedLocations()
.withIds(["32", "72"])
.withIds(["72", "190"]);
อาร์กิวเมนต์
| ชื่อ | ชนิด | คำอธิบาย |
|---|---|---|
| รหัส | string[] | อาร์เรย์ของรหัสตําแหน่งที่ตั้งเป้าหมาย สําหรับขีดจํากัด ดูขีดจํากัดการดําเนินการสคริปต์ |
กลับ
| ชนิด | คำอธิบาย |
|---|---|
| TargetedLocationSelector | ตัวเลือกที่มีการใช้รหัส |
withLimit(ขีดจํากัด Int)
รับที่ตั้งเป้าหมาย n อันดับแรกที่ตรงกับเกณฑ์การเลือก
อาร์กิวเมนต์
| ชื่อ | ชนิด | คำอธิบาย |
|---|---|---|
| จำกัด | Int | จํานวนของตําแหน่งที่ตั้งเป้าหมายที่จะส่งกลับ ตัวเลขจริงอาจน้อยกว่า |
กลับ
| ชนิด | คำอธิบาย |
|---|---|
| TargetedLocationSelector | ตัวเลือกที่มีการใช้ขีดจํากัด |