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