ตัวอย่างสคริปต์สําหรับการจัดการแคมเปญ

ส่วนต่อไปนี้แสดงตัวอย่างของสคริปต์ที่ดําเนินการต่าง ๆ กับแคมเปญ

รับแคมเปญทั้งหมด

หากต้องการรับแคมเปญทั้งหมดในบัญชี ก่อนอื่นให้เรียกใช้วิธีการของcampaignsออบเจ็กต์ AdsApp เพื่อรับตัวเลือก จากนั้น เรียกใช้วิธีการของ get ตัวเลือกเพื่อรับ ตัวทําซ้ํา ที่คุณใช้เพื่อทําซ้ําผ่านรายการแคมเปญ เนื่องจากตัวอย่างไม่ได้ระบุตัวกรองใด ๆ ตัวเลือกจึงส่งกลับแคมเปญทั้งหมดในบัญชี หากต้องการกําหนดจํานวนแคมเปญในตัวทําซ้ํา ให้เรียกใช้วิธีการของ totalNumEntities ตัวทําซ้ํา

function main() {
    // Gets all campaigns in the account.
    var iterator = AdsApp.campaigns().get();

    // Iterates through the list of campaigns and logs 
    // each campaign's name.
    while (iterator.hasNext()) {
        var campaign = iterator.next();
    }
}

รับแคมเปญตามชื่อ

หากต้องการรับแคมเปญตามชื่อ ก่อนอื่นให้เรียกใช้วิธีการของcampaignsออบเจ็กต์ AdsApp เพื่อรับตัวเลือก ตัวเลือกประกอบด้วยวิธีการกรองหลายวิธีที่คุณใช้เพื่อกรองรายการของแคมเปญ withConditionใช้วิธีการ ในการกรองการส่งเสริมการขายสําหรับชื่อการส่งเสริมการขายเฉพาะ โปรดทราบว่าตัวถูกดําเนินการและตัวดําเนินการต้องตรงตามตัวพิมพ์ใหญ่-เล็ก

ถัดไป เรียกใช้วิธีการของgetตัวเลือกเพื่อรับตัวทําซ้ํา ชื่อแคมเปญไม่ซ้ํากัน ดังนั้นคุณจะกลับมาได้เพียงชื่อเดียวถ้ามีอยู่

function main() {
    var campaignName = 'CAMPAIGN NAME GOES HERE';

    var iterator = AdsApp.campaigns()
        .withCondition(`Name = '${campaignName}'`)
        .get();

    while (iterator.hasNext()) {
        var campaign = iterator.next();
    }
}

รับแคมเปญตาม ID

หากคุณมีสิทธิ์เข้าถึงรหัสของแคมเปญ ให้ใช้รหัสนี้แทน การใช้รหัสเพื่อให้เอนทิตีมีประสิทธิภาพการทํางานที่ดีขึ้น แทนที่จะใช้ withCondition เมธอดตัวกรอง ให้ใช้ withIds เมธอด ตัวอย่างเช่น withIds(['12345'])

function main() {
    var campaignId = '12345';

    var iterator = AdsApp.campaigns()
        .withIds([campaignId])
        .get();

    while (iterator.hasNext()) {
        var campaign = iterator.next();
    }
}

รับข้อมูลประสิทธิภาพของแคมเปญ

หากต้องการรับเมตริกประสิทธิภาพของแคมเปญ ให้เรียกใช้วิธีการ รับสถิติ ของแคมเปญ เมื่อคุณได้รับแคมเปญ คุณจะต้องระบุช่วงวันที่ของข้อมูลเมตริกที่คุณต้องการ คุณสามารถระบุช่วงวันที่โดยใช้สัญพจน์ที่กําหนดไว้ล่วงหน้า เช่น LAST_MONTH หรือ TODAY หรือวันที่เริ่มต้นและวันที่สิ้นสุด เมื่อต้องการระบุช่วงวันที่ ให้ใช้หนึ่งใน forDateRange วิธีการเมื่อคุณเลือกการส่งเสริมการขาย (ดู ผู้ดําเนินการส่งเสริมการขาย)

สําหรับรายการของเมตริกที่คุณสามารถเข้าถึงได้ ดูวัตถุสถิติ

function main() {
    var campaignId = '12345';

    // Get the campaign. You need to specify the date range of the
    // performance data you want to get.
    var iterator = AdsApp.campaigns()
        .withIds([campaignId])
        .forDateRange('LAST_WEEK')
        .get();

    // If the campaign is found, log some metrics.
    while (iterator.hasNext()) {
        var campaign = iterator.next();
        var metrics = campaign.getStats(); // Gets the performance metrics.
    }
}

หยุดแคมเปญชั่วคราว

หากต้องการหยุดแคมเปญชั่วคราว ให้เรียกใช้วิธีการของ pause แคมเปญ หากต้องการเปิดใช้งานอีกครั้ง ให้เรียกใช้วิธีการของ enable แคมเปญ เมื่อต้องการกําหนดสถานะของการส่งเสริมการขาย ให้เรียกใช้วิธีการ , และ isRemoved ของการisEnabledisPausedส่งเสริมการขาย

function main() {
    var campaignId = '12345';

    var iterator = AdsApp.campaigns()
        .withIds([campaignId])
        .get();

    // If the campaign is found, pause it.
    while (iterator.hasNext()) {
        var campaign = iterator.next();
        campaign.pause();
    }
}