管理行銷活動的腳本範例

文章
12/21/2023

下列各節顯示針對行銷活動執行各種動作的腳本範例。

取得所有活動

若要取得帳戶中的所有活動，請先呼叫 AdsApp 物件的 campaigns 方法來取得選取器。然後，呼叫選取器 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();
    }
}

依名稱取得行銷活動

若要依名稱取得行銷活動，請先呼叫 AdsApp 物件的 campaigns 方法來取得選取器。選取器包含一些您用來篩選活動清單的篩選方法。 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();
    }
}

依識別碼取得行銷活動

如果您有活動識別碼的存取權，請改用它。使用識別碼取得實體可提供更好的效能。請使用方法， withIds 而不是使用 withCondition 篩選方法。例如，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 方法。若要判斷行銷活動的狀態，請呼叫行銷活動的 isEnabled 、 isPaused 和 isRemoved 方法。

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

分享方式：