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

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

เพิ่มงบประมาณที่ใช้ร่วมกัน

หากต้องการเพิ่มงบประมาณที่ใช้ร่วมกัน คุณต้องใช้เว็บแอปพลิเคชัน 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 ของงบประมาณที่ใช้ร่วมกัน ให้ใช้รหัสนี้แทน การใช้รหัสเพื่อให้เอนทิตีมีประสิทธิภาพการทํางานที่ดีขึ้น แทนที่จะใช้ withCondition เมธอดตัวกรอง ให้ใช้ withIds เมธอด ตัวอย่างเช่น withIds(['12345'])

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

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

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

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

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

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 วิธีการเมื่อคุณเลือกงบประมาณ (ดู BudgetSelector)

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

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.
    }
}