AssetGroupSelector

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

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

    var iterator = Campaign.assetGroups()
        .withCondition("ClickConversionRate > 0.3")
        .forDateRange("LAST_WEEK")
        .orderBy("Clicks DESC")
        .get();

    while (iterator.hasNext()) {
        var assetGroup = iterator.next();
        var metrics = assetGroup.getStats();
    }

วิธี

ชื่อเมธอด	ชนิดการส่งกลับ	คำอธิบาย
รับ	AssetGroupIterator	รับตัวทําซ้ําที่ใช้ในการทําซ้ําผ่านรายการกลุ่มแอสเซท
orderBy(string orderBy)	AssetGroupSelector	ใช้การเรียงลําดับที่ระบุกับกลุ่มสินทรัพย์ที่เลือก
withCondition(เงื่อนไขสตริง)	AssetGroupSelector	ใช้เงื่อนไขการกรองกับกลุ่มสินทรัพย์
withIds(string[] ids)	AssetGroupSelector	รับกลุ่มสินทรัพย์ที่มีรหัสที่ระบุ
withLimit(ขีดจํากัด Int)	AssetGroupSelector	รับกลุ่มสินทรัพย์ n อันดับแรกที่ตรงกับเกณฑ์การเลือก

รับ

รับ ตัวทําซ้ํา ที่ใช้ในการทําซ้ําผ่านรายการกลุ่มแอสเซท

กลับ

ประเภท	คำอธิบาย
AssetGroupIterator	ตัวทําซ้ําที่ใช้เพื่อทําซ้ําผ่านกลุ่มสินทรัพย์ที่เลือก

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

ใช้การเรียงลําดับที่ระบุกับกลุ่มสินทรัพย์ที่เลือก

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

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

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

selector = selector.orderBy("AverageCpc");

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

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

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

กลับ

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

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

ใช้เงื่อนไขการกรองกับกลุ่มสินทรัพย์

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

• columnName เป็นหนึ่งในคอลัมน์ที่ได้รับการสนับสนุน
• ตัวดําเนินการ เป็นหนึ่งใน ตัวดําเนินการที่ได้รับการสนับสนุน

ผู้ ประกอบการ

ตัวดําเนินการที่คุณใช้ขึ้นอยู่กับชนิดของคอลัมน์ ตัวดําเนินการต้องตรงตามตัวพิมพ์ใหญ่-เล็ก ตัวอย่างเช่น ใช้ 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")
ชื่อ	เชือก	ชื่อของกลุ่มสินทรัพย์ withCondition("Name CONTAINS_IGNORE_CASE 'sport'")
CampaignName	เชือก	ชื่อของแคมเปญ withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
KeywordMaxCpc	คู่	การเสนอราคา CPC ของกลุ่มสินทรัพย์ การประมูลอยู่ในสกุลเงินของบัญชี withCondition("KeywordMaxCpc > 5.0")
สถานะของแคมเปญ	การแจงนับ	สถานะของแคมเปญ ค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้คือ: เปิด หยุดชั่วขณะ ถูก เอา ออก ตัวอย่างนี้จะแสดงเฉพาะกลุ่มสินทรัพย์ที่แคมเปญหลักหยุดชั่วคราว withCondition("CampaignStatus = PAUSED")
LabelNames	ชุดสตริง	รายการของชื่อป้ายชื่อแบบตรงตามตัวพิมพ์ใหญ่-เล็กอย่างน้อยหนึ่งชื่อ ใช้ เพื่อรับกลุ่มสินทรัพย์ที่เชื่อมโยงกับป้ายชื่อที่มีชื่อ withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
CampaignType	การแจงนับ	ชนิดของแคมเปญ ค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้คือ: SEARCH_AND_CONTENT ชอปปิ้ง DYNAMIC_SEARCH_ADS ตัวอย่างนี้ส่งกลับเฉพาะกลุ่มสินทรัพย์ที่มีชนิดของแคมเปญหลักคือ Shopping withCondition("CampaignType = SHOPPING")

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

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

กลับ

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

withIds(string[] ids)

รับกลุ่มสินทรัพย์ที่มีรหัสที่ระบุ

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

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

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

ชื่อ	ประเภท	คำอธิบาย
รหัส	string[]	อาร์เรย์ของรหัสกลุ่มสินทรัพย์ สําหรับขีดจํากัด ดูขีดจํากัดการดําเนินการสคริปต์

กลับ

ประเภท	คำอธิบาย
AssetGroupSelector	ตัวเลือกที่มีการใช้รหัส

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

รับกลุ่มสินทรัพย์ n อันดับแรกที่ตรงกับเกณฑ์การเลือก

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

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

กลับ

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

ดูเพิ่มเติม

Campaign.assetGroups()