Exemples de script pour la gestion des budgets partagés

Les sections suivantes présentent des exemples de scripts qui effectuent diverses actions par rapport aux budgets partagés.

Ajouter des budgets partagés

Pour ajouter un budget partagé, vous devez utiliser l’application web Microsoft Advertising. Pour en savoir plus, consultez Comment faire partager un budget entre plusieurs campagnes ?

Associer une campagne à un budget partagé

Pour associer une campagne à un budget partagé, vous devez utiliser l’application web Microsoft Advertising. Pour en savoir plus, consultez Comment faire partager un budget entre plusieurs campagnes ?

Obtenir tous les budgets partagés

Pour obtenir tous les budgets partagés dans un compte, appelez d’abord la méthode de l’objet budgetsAdsApp pour obtenir le sélecteur. Ensuite, appelez la méthode du get sélecteur pour obtenir un itérateur que vous utiliserez pour itérer dans la liste des budgets partagés. Étant donné que l’exemple ne spécifie aucun filtre, le sélecteur renvoie tous les budgets partagés dans le compte. Pour déterminer le nombre de budgets partagés dans l’itérateur, appelez la méthode de l’itérateur totalNumEntities .

Remarque

Les budgets partagés n’incluent pas les budgets non partagés (campagnes individuelles).

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

Obtenir un budget partagé par nom

Pour obtenir un budget partagé par nom, appelez d’abord la méthode de l’objet budgetsAdsApp pour obtenir le sélecteur. Le sélecteur contient un certain nombre de méthodes de filtrage que vous utilisez pour filtrer la liste des budgets. Utilisez la withCondition méthode pour filtrer les budgets par nom. Par exemple, pour filtrer la liste pour un nom spécifique, utilisez : withCondition("BudgetName = '<budgetnamegoeshere>'"). Pour filtrer la liste avec un nom partiel, utilisez : withCondition("BudgetName CONTAINS_IGNORE_CASE '<partialnamegoeshere>'"). Notez que les opérandes et les opérateurs sont sensibles à la casse.

Ensuite, appelez la méthode du sélecteur pour obtenir l’itérateurget.

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

Obtenir des budgets partagés par ID

Si vous avez accès à l’ID du budget partagé, utilisez-le à la place. L’utilisation d’ID pour obtenir des entités offre de meilleures performances. Utilisez la withIds méthode au lieu d’utiliser la méthode de withCondition filtrage. Par exemple : withIds(['12345']).

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

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

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

Obtenir toutes les campagnes qui partagent le budget

Pour obtenir toutes les campagnes qui partagent le budget, appelez la méthode de campagnes du budget. Vous ne pouvez appeler cette méthode qu’à partir d’un objet Budget que vous obtenez de BudgetSelector ; vous ne pouvez pas l’appeler si la source du budget est la méthode getBudget de la campagne.

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

Obtenir les données de performances d’un budget partagé

Pour obtenir les métriques de performances d’un budget partagé, appelez la méthode getStats du budget. Lorsque vous obtenez la liste des budgets de partage, vous devez spécifier la plage de dates des données de métriques souhaitée. Vous pouvez spécifier la plage de dates à l’aide d’un littéral prédéfini, tel que LAST_MONTH ou AUJOURDHUI, ou de dates de début et de fin. Pour spécifier la plage de dates, utilisez l’une forDateRange des méthodes lorsque vous sélectionnez les budgets (voir Sélecteur de budget).

Pour obtenir la liste des mesures auxquelles vous pouvez accéder, consultez l’objet Statistiques . Les métriques sont l’agrégation de toutes les campagnes qui partagent le budget.

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.
    }
}
  • Last updated on