AdGroupExcludedAudienceSelector

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

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

    // Gets the iterator that iterates all ad group excluded audiences
    // in the account.
    var iterator = AdsApp.adGroups().get();

    // Loops through all ad groups in the account.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();

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

วิธีการ

ชื่อวิธี ชนิดการส่งคืน คำอธิบาย
รับ AdGroupExcludedAudienceIterator รับตัวทําซ้ําที่ใช้ในการคํานวณซ้ําผ่านรายการของผู้ชมที่แยกกลุ่มโฆษณาออก
orderBy(สตริง orderBy) AdGroupExcludedAudienceSelector นําลําดับที่ระบุไปใช้กับกลุ่มเป้าหมายที่แยกกลุ่มโฆษณาออก
withCondition(เงื่อนไขสตริง) AdGroupExcludedAudienceSelector ใช้เกณฑ์การกรองกับผู้ชมที่แยกกลุ่มโฆษณาออก
withIds(string[], ids) AdGroupExcludedAudienceSelector รับกลุ่มเป้าหมายที่แยกกลุ่มโฆษณาออกด้วย ID ที่ระบุ
withLimit(int limit) AdGroupExcludedAudienceSelector รับกลุ่มเป้าหมายที่ถูกแยกกลุ่มโฆษณา n อันดับแรก ที่ตรงกับเกณฑ์การเลือก

รับ

รับตัว ทําซ้ํา ที่ใช้ในการคํานวณซ้ําผ่านรายการของผู้ชมที่แยกกลุ่มโฆษณาออก

ส่งกลับ

พิมพ์ คำอธิบาย
AdGroupExcludedAudienceIterator iterator ที่ใช้เพื่อวนซ้ําผ่านกลุ่มโฆษณาที่เลือกกลุ่มที่แยกผู้ชมออก

orderBy(สตริง orderBy)

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

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

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

ตัวอย่างเช่น การส่งคืนการเรียกต่อไปนี้คือกลุ่มโฆษณาที่กลุ่มเป้าหมายที่ถูกแยกออกจากน้อยไปหามากโดยค่าเฉลี่ย Cpc

selector = selector.orderBy("AverageCpc");

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

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

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

ส่งกลับ

พิมพ์ คำอธิบาย
AdGroupExcludedAudienceSelector ตัวเลือกที่มีการเรียงลําดับ

withCondition(String condition)

ใช้เกณฑ์การกรองกับผู้ชมที่แยกกลุ่มโฆษณาออก

ระบุพารามิเตอร์ เงื่อนไข ในรูปแบบ "columnName operator value" โดยที่:

ตัวดําเนินการ

ตัวดําเนินการที่คุณใช้จะขึ้นอยู่กับชนิดของคอลัมน์ ตัวดําเนินการต้องตรงตามตัวพิมพ์ใหญ่-เล็ก ตัวอย่างเช่น ใช้ 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

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

คอลัมน์ที่สนับสนุนสําหรับการกรองกลุ่มเป้าหมายที่ไม่รวมกลุ่มโฆษณา ชื่อต้องตรงตามตัวพิมพ์ใหญ่-เล็ก

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

คอลัมน์ พิมพ์ ตัวอย่าง
AdGroupName สตริง ชื่อกลุ่มโฆษณาของสมาคม

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus การแจงนับ สถานะของกลุ่มโฆษณาของสมาคม ค่าตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้ ได้แก่
  • เปิดใช้งาน
  • หยุดชั่วคราว
  • เอาออก
ตัวอย่างนี้จะส่งกลับเฉพาะกลุ่มเป้าหมายที่แยกกลุ่มโฆษณาออกเท่านั้นที่มีการหยุดกลุ่มโฆษณาหลักชั่วคราว

withCondition("AdGroupStatus = PAUSED")
AudienceId แบบยาว ID ของผู้ชมที่เกี่ยวข้อง

withCondition("AudienceId = 123456789")
ชื่อแคมเปญ สตริง ชื่อของแคมเปญที่มีกลุ่มโฆษณาของสมาคม

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus การแจงนับ สถานะของแคมเปญที่มีกลุ่มโฆษณาของสมาคม ค่าตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้ ได้แก่
  • เปิดใช้งาน
  • หยุดชั่วคราว
  • เอาออก
ตัวอย่างนี้จะส่งกลับเฉพาะกลุ่มเป้าหมายที่แยกกลุ่มโฆษณาซึ่งมีแคมเปญหลักหยุดชั่วคราว

withCondition("CampaignStatus = PAUSED")
สถานะ การแจงนับ สถานะของความสัมพันธ์ ค่าตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้ ได้แก่
  • เปิดใช้งาน
  • หยุดชั่วคราว
  • เอาออก
ตัวอย่างนี้จะส่งกลับเฉพาะผู้ชมที่แยกกลุ่มโฆษณาที่เปิดใช้งานเท่านั้น

withCondition("Status = ENABLED")
UserListName สตริง ชื่อของผู้ชมที่เชื่อมโยง

withCondition("UserListName = 'foo'")

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

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

ส่งกลับ

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

withIds(string[], ids)

รับกลุ่มเป้าหมายที่แยกกลุ่มโฆษณาออกด้วย ID ที่ระบุ

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

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

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

ชื่อ พิมพ์ คำอธิบาย
รหัส สตริง[] อาร์เรย์ของรหัสผู้ชมที่แยกกลุ่มโฆษณาออก สําหรับขีดจํากัด โปรดดูขีดจํากัดการดําเนินการสคริปต์

ส่งกลับ

พิมพ์ คำอธิบาย
AdGroupExcludedAudienceSelector ตัวเลือกที่มี ID ที่นําไปใช้

withLimit(int limit)

รับกลุ่มเป้าหมายที่ถูกแยกกลุ่มโฆษณา n อันดับแรก ที่ตรงกับเกณฑ์การเลือก

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

ชื่อ พิมพ์ คำอธิบาย
ขีดจํากัด int จํานวนกลุ่มโฆษณาที่ถูกแยกกลุ่มเป้าหมายที่แยกออกที่จะกลับมา จํานวนจริงอาจน้อยกว่า

ส่งกลับ

พิมพ์ คำอธิบาย
AdGroupExcludedAudienceSelector ตัวเลือกที่มีการใช้ขีดจํากัด
  • อัปเดตล่าสุดเมื่อ