ตัวอย่างสคริปต์สําหรับการจัดการกลุ่มโฆษณา

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

เพิ่มกลุ่มโฆษณา

หากต้องการเพิ่มกลุ่มโฆษณา ขั้นแรกให้รับแคมเปญเพื่อเพิ่มกลุ่มโฆษณา ใช้ออบเจ็กต์ CampaignSelector เพื่อเลือกการส่งเสริมการขาย การใช้วิธีการ นี้ withIds มีประสิทธิภาพดีกว่าการส่งผ่านชื่อของแคมเปญใน withCondition วิธีการ

ถัดไป เรียกใช้เมธอด AdGroupBuilder ใหม่ ของแคมเปญเพื่อรับตัวสร้างที่คุณใช้เพื่อระบุคุณสมบัติของกลุ่มโฆษณา พร็อพเพอร์ตี้ที่จําเป็นต้องระบุเท่านั้นคือชื่อของกลุ่มโฆษณา (ดู withName วิธีการ) ซึ่งต้องไม่ซ้ํากันภายในแคมเปญ ถ้าคุณไม่ได้ระบุค่า CPC จะมีค่าเริ่มต้นเป็นจํานวนการเสนอราคาต่ําสุดสําหรับสกุลเงินของบัญชีของคุณ คุณจําเป็นต้องระบุภาษาถ้าแคมเปญไม่ได้ระบุไว้เท่านั้น มิฉะนั้น ระบบจะใช้ค่าภาษาของแคมเปญ ตามค่าเริ่มต้น สถานะของกลุ่มโฆษณาจะหยุดชั่วคราว

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

function main() {
    // The ID of the campaign to add the ad groups to.
    // IDs in Scripts are string integers.
    var campaignId = 'CAMPAIGN ID GOES HERE';  
    var campaign = getCampaign(campaignId);

    // Ad groups to add.
    var adGroups = [];
    adGroups.push({
        name : 'AD GROUP NAME GOES HERE',
        cpc : 2.25,
        language : 'English' // Required if the campaign doesn't specify a language
    });
    adGroups.push({
        name : 'AD GROUP NAME GOES HERE',
        cpc : 1.25,
        language : 'English' // Required if the campaign doesn't specify a language
    });

    var operations = [];

    if (campaign != null)
    {
        for (var adGroup of adGroups) {
            var operation = addAdGroup(
                campaign, 
                adGroup.name, 
                adGroup.cpc, 
                adGroup.language);
            operations.push(operation);
        }
    }
    else {
        Logger.log("Unable to retrieve campaign, " + campaignId);
    }

    checkBuildStatus(operations, adGroups);
}

// Get the campaign using its ID.
function getCampaign(id) {
    var iterator = AdsApp.campaigns()
        .withIds([id])
        .get();

    // Return the campaign if it exists; otherwise, null.
    if (iterator.hasNext()) {
        return iterator.next();
    }
    else {
        return null;
    }
}

// Add the ad group to the specified campaign.
// Returns the builder's operation object, which you use to 
// check the status of the add operation.
function addAdGroup(campaign, name, cpc, language) {

    return campaign.newAdGroupBuilder()
        .withName(name)
        .withCpc(cpc)
        .withLanguage(language)
        .build();
}

// Check the ad group's build status.
function checkBuildStatus(operations, adGroups) {

    for (var i = 0; i < operations.length; i++) {
        if (!operations[i].isSuccessful()) {
            for (var error of operations[i].getErrors()) {
                Logger.log(`Failed to add, ${adGroups[i].name}. Error: ${error}`);
            }
        }
    }
}

รับกลุ่มโฆษณาทั้งหมด

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

function main() {
    // Gets all ad groups in the account.
    var iterator = AdsApp.adGroups().get();
    
    // Iterates through the list of ad groups and logs 
    // each ad group's name.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();
    }
}

รับกลุ่มโฆษณาตามชื่อ

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

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

หากคุณต้องการรับกลุ่มโฆษณาตามชื่อจากแคมเปญเฉพาะ ให้ใส่ withCondition วิธีการที่ระบุชื่อแคมเปญ (CampaignName = '<campaignnamegoeshere>')

function main() {
    // The name of the ad group to get.
    var adGroupName = 'AD GROUP NAME GOES HERE';

    // Get the ad groups with the specified name.
    var iterator = AdsApp.adGroups()
          .withCondition(`Name = '${adGroupName}'`)
          .get();

    // Need a loop because multiple campaigns can have 
    // an ad group with the same name.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();
    }
}

รับกลุ่มโฆษณาตาม ID

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

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

    var iterator = AdsApp.adGroups()
        .withIds([adGroupId])
        .get();

    if (iterator.hasNext()) {
        var adGroup = iterator.next();
    }
}

รับกลุ่มโฆษณาตามชื่อจากแคมเปญที่ระบุ

function main() {
    var adGroupName = 'AD GROUP NAME GOES HERE';
    var campaignName = "CAMPAIGN NAME GOES HERE";

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

    if (iterator.hasNext()) {
        var adGroup = iterator.next();
    }
}

รับข้อมูลประสิทธิภาพการทํางานของกลุ่มโฆษณา

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

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

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

    // Get the ad group. You need to specify the date range of the
    // performance data you want to get.
    var iterator = AdsApp.adGroups()
        .forDateRange('LAST_WEEK')
        .withCondition(`Name = '${adGroupName}'`)
        .withCondition(`CampaignName = '${campaignName}'`)
        .get();
    
    // If the ad group is found, log some metrics.
    if (iterator.hasNext()) {
        var adGroup = iterator.next();
        var metrics = adGroup.getStats(); // Gets the performance metrics.
    }
}

หยุดกลุ่มโฆษณาชั่วคราว

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

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

    // Get the ad group. 
    var iterator = AdsApp.adGroups()
        .withCondition(`Name = '${adGroupName}'`)
        .withCondition(`CampaignName = '${campaignName}'`)
        .get();

    if (iterator.hasNext()) {
        var adGroup = iterator.next();
        adGroup.pause();
    }
}