แชร์ผ่าน

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(string orderBy) AdGroupExcludedAudienceSelector นําการเรียงลําดับที่ระบุไปใช้กับกลุ่มโฆษณาที่เลือกซึ่งไม่รวมผู้ชม
withCondition(เงื่อนไขสตริง) AdGroupExcludedAudienceSelector ใช้เกณฑ์การกรองกับกลุ่มโฆษณาที่ไม่รวมผู้ชม
withIds(string[] ids) AdGroupExcludedAudienceSelector รับกลุ่มโฆษณาที่ไม่รวมผู้ชมด้วยรหัสที่ระบุ
withLimit(ขีดจํากัด Int) AdGroupExcludedAudienceSelector รับกลุ่มผู้ชมที่ไม่รวม กลุ่มโฆษณา n อันดับแรกที่ตรงกับเกณฑ์การเลือก

รับ

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

กลับ

ชนิด คำอธิบาย
AdGroupExcludedAudienceIterator ตัวทําซ้ําที่ใช้ในการทําซ้ําผ่านกลุ่มโฆษณาที่เลือกไม่รวมผู้ชม

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

นําการเรียงลําดับที่ระบุไปใช้กับกลุ่มโฆษณาที่เลือกซึ่งไม่รวมผู้ชม

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

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

ตัวอย่างเช่น การเรียกใช้ต่อไปนี้จะส่งกลับกลุ่มโฆษณาที่ไม่รวมผู้ชมตามลําดับจากน้อยไปหามากตาม AverageCpc

selector = selector.orderBy("AverageCpc");

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

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

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

กลับ

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

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

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

ระบุพารามิเตอร์ เงื่อนไข ในแบบฟอร์ม "ค่าตัวดําเนินการ 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

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

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

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

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

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

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

withCondition("AudienceId = 123456789")
CampaignName สาย อักขระ ชื่อของแคมเปญที่ประกอบด้วยกลุ่มโฆษณาของความสัมพันธ์

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

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

withCondition("Status = ENABLED")
UserListName สาย อักขระ ชื่อของผู้ชมที่เกี่ยวข้อง

withCondition("UserListName = 'foo'")

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

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

กลับ

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

withIds(string[] ids)

รับกลุ่มโฆษณาที่ไม่รวมผู้ชมด้วยรหัสที่ระบุ

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

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

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

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

กลับ

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

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

รับกลุ่มผู้ชมที่ไม่รวม กลุ่มโฆษณา n อันดับแรกที่ตรงกับเกณฑ์การเลือก

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

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

กลับ

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