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

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

หมายเหตุ

การจัดการแคมเปญ Performance Max ด้วยสคริปต์ไม่ได้รับการสนับสนุน

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

หากต้องการรับแคมเปญทั้งหมดในบัญชี ก่อนอื่นให้เรียกใช้เมธอดของ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

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

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

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

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

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

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

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

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 แคมเปญ เมื่อต้องการระบุสถานะของแคมเปญ ให้เรียกใช้ , และisPausedisRemovedวิธีการของisEnabledแคมเปญ

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();
    }
}