ตัวอย่างสคริปต์สําหรับการจัดการงบประมาณที่ใช้ร่วมกัน

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

เพิ่มงบประมาณที่แชร์

เมื่อต้องการเพิ่มงบประมาณที่ใช้ร่วมกัน คุณต้องใช้แอปพลิเคชันบนเว็บ Microsoft Advertising สําหรับรายละเอียด โปรดดูที่ How do I แชร์งบประมาณในหลายแคมเปญได้อย่างไร

เชื่อมโยงแคมเปญกับงบประมาณที่ใช้ร่วมกัน

เมื่อต้องการเชื่อมโยงแคมเปญกับงบประมาณที่ใช้ร่วมกัน คุณต้องใช้เว็บแอปพลิเคชัน Microsoft Advertising สําหรับรายละเอียด โปรดดูที่ How do I แชร์งบประมาณในหลายแคมเปญได้อย่างไร

รับงบประมาณที่ใช้ร่วมกันทั้งหมด

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

หมายเหตุ

งบประมาณที่ใช้ร่วมกันไม่รวมงบประมาณที่ไม่ได้แชร์ (แคมเปญแต่ละรายการ)

function main() {
    // Gets all shared budgets in the account.
    var iterator = AdsApp.budgets().get();
    
    // Iterates through the list of shared budgets and logs 
    // each budgets's name and amount.
    while (iterator.hasNext()) {
        var budget = iterator.next();
    }
}

รับงบประมาณที่ใช้ร่วมกันตามชื่อ

หากต้องการรับงบประมาณที่ใช้ร่วมกันตามชื่อ ก่อนอื่นให้เรียกใช้เมธอดของbudgetsวัตถุ AdsApp เพื่อรับตัวเลือก ตัวเลือกมีวิธีการกรองจํานวนหนึ่งที่คุณใช้ในการกรองรายการงบประมาณ ใช้ withCondition วิธีการกรองงบประมาณตามชื่อ ตัวอย่างเช่น เมื่อต้องการกรองรายการสําหรับชื่อที่ระบุ ให้ใช้: withCondition("BudgetName = '<budgetnamegoeshere>'") เมื่อต้องการกรองรายการตามบางส่วนของชื่อ ให้ใช้: withCondition("BudgetName CONTAINS_IGNORE_CASE '<partialnamegoeshere>'") โปรดทราบว่าตัวถูกดําเนินการและตัวดําเนินการเป็นแบบตรงตามตัวพิมพ์ใหญ่-เล็ก

ถัดไป ให้เรียกใช้วิธีการของgetตัวเลือกเพื่อรับตัวทําซ้ํา

function main() {
    // Partial name of the shared budget to get.
    var budgetName = 'PARTIAL NAME GOES HERE';

    // Get the budgets that contain the partial name.
    var iterator = AdsApp.budgets()
          .withCondition(`BudgetName CONTAINS_IGNORE_CASE '${budgetName}'`)
          .get();

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

รับงบประมาณที่ใช้ร่วมกันตาม ID

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

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

    var iterator = AdsApp.budgets()
        .withIds([sharedBudgetId])
        .get();

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

รับแคมเปญทั้งหมดที่แชร์งบประมาณ

เมื่อต้องการรับแคมเปญทั้งหมดที่มีงบประมาณร่วมกัน ให้โทรหาวิธี แคมเปญของ งบประมาณ คุณสามารถเรียกใช้เมธอดนี้ได้จากวัตถุ Budget ที่คุณได้รับจาก BudgetSelector เท่านั้น คุณจะไม่สามารถเรียกได้ ถ้าแหล่งที่มาของงบประมาณคือเมธอด GetTBudget ของแคมเปญ

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

    var budgets = AdsApp.budgets()
        .withIds([sharedBudgetId])
        .get();

    while (budgets.hasNext()) {
        var budget = budgets.next();

        var campaigns = budget.campaigns().get();

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

รับข้อมูลประสิทธิภาพของงบประมาณที่ใช้ร่วมกัน

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

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

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

    // Get the shared budget. You need to specify the date range of the
    // performance data you want to get.
    var budgets = AdsApp.budgets()
        .forDateRange('LAST_WEEK')
        .withIds([sharedBudgetId])
        .get();
    
    // If the budget is found, log some metrics.
    while (budgets.hasNext()) {
        var budget = budgets.next();
        var metrics = budget.getStats(); // Gets the performance metrics.
    }
}