Exemples de script pour la gestion des campagnes

Les sections suivantes présentent des exemples de scripts qui effectuent diverses actions sur des campagnes.

Remarque

La gestion des campagnes Performance Max à l’aide de scripts n’est pas prise en charge.

Obtenir toutes les campagnes

Pour obtenir toutes les campagnes d’un compte, appelez d’abord la méthode de campaigns l’objet AdsApp pour obtenir le sélecteur. Ensuite, appelez la méthode du get sélecteur pour obtenir un itérateur que vous utilisez pour itérer dans la liste des campagnes. Étant donné que l’exemple ne spécifie aucun filtre, le sélecteur renvoie toutes les campagnes du compte. Pour déterminer le nombre de campagnes dans l’itérateur, appelez la méthode de l’itérateur 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();
    }
}

Obtenir une campagne par nom

Pour obtenir une campagne par son nom, appelez d’abord la méthode de l’objet campaignsAdsApp pour obtenir le sélecteur. Le sélecteur contient plusieurs méthodes de filtrage permettant de filtrer la liste des campagnes. Utilisez la withCondition méthode pour filtrer les campagnes d’un nom de campagne spécifique. 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. Les noms de campagne étant uniques, vous n’en recevrez qu’un seul, le cas échéant.

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

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

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

Obtenir la campagne par ID

Si vous avez accès à l’ID de la campagne, 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 campaignId = '12345';

    var iterator = AdsApp.campaigns()
        .withIds([campaignId])
        .get();

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

Obtenir les données de performances d’une campagne

Pour obtenir les métriques de performances d’une campagne, appelez la méthode getStats de la campagne. Lorsque vous obtenez la campagne, vous devez spécifier la plage de dates des données métriques souhaitées. 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 la campagne (voir CampaignSelector).

Pour obtenir la liste des mesures auxquelles vous pouvez accéder, consultez l’objet Statistiques .

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

Suspendre une campagne

Pour suspendre une campagne, appelez la méthode de pause la campagne. Pour la réactiver, appelez la méthode de enable la campagne. Pour déterminer le status de la campagne, appelez les méthodes , isPausedet de isRemoved la campagneisEnabled.

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