CampaignExcludedAudienceSelector

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

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

    // Gets the iterator that iterates all campaigns
    // in the account.
    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get();

    // Loops through all campaigns in the account.
    while (iterator.hasNext()) {
        var campaign = iterator.next();

        // Gets the iterator that iterates all campaign excluded audiences
        // in the campaign excluded audience.
        var audienceIterator = campaign.targeting().excludedAudiences()
            .withLimit(10)
            .withIds("123456789")
            .get();
    
        // Loops through all campaign excluded audiences in the campaign excluded audience.
        while (audienceIterator.hasNext()) {
            var audience = audienceIterator.next();
        }
    }

วิธี

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

รับ

รับ ตัวทําซ้ํา ที่ใช้ในการทําซ้ําผ่านรายการของผู้ชมที่แยกออกจากแคมเปญ

กลับ

ชนิด	คำอธิบาย
CampaignExcludedAudienceIterator	ตัวทําซ้ําที่ใช้ในการทําซ้ําผ่านกลุ่มเป้าหมายที่ไม่รวมแคมเปญที่เลือก

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

ใช้การเรียงลําดับที่ระบุกับผู้ชมที่ไม่รวมการส่งเสริมการขายที่เลือก

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

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

ตัวอย่างเช่น การเรียกใช้ต่อไปนี้จะส่งกลับแคมเปญที่แยกผู้ชมออกตามลําดับจากน้อยไปหามากตาม AverageCpc

selector = selector.orderBy("AverageCpc");

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

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

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

กลับ

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

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

คอลัมน์ที่สนับสนุน

คอลัมน์ที่สนับสนุนสําหรับการกรองผู้ชมที่แยกออกจากแคมเปญ ชื่อต้องตรงตามตัวพิมพ์ใหญ่-เล็ก

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

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

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

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

กลับ

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

withIds(string[] ids)

รับแคมเปญที่ไม่รวมผู้ชมที่มีรหัสที่ระบุ

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

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

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

ชื่อ	ชนิด	คำอธิบาย
รหัส	string[]	อาร์เรย์ของรหัสผู้ชมที่แยกออกจากแคมเปญ สําหรับขีดจํากัด ดูขีดจํากัดการดําเนินการสคริปต์

กลับ

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

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

รับผู้ชมที่ไม่รวมการส่งเสริมการขาย n อันดับแรกที่ตรงกับเกณฑ์การเลือก

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

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

กลับ

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