Guide du développeur sur les audiences de remarketing

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Ce document explique comment gérer les audiences de remarketing Google Analytics à l'aide de l'API Management.

Introduction

L'API Management vous permet d'effectuer les create, get, delete, list, update et patch des audiences de remarketing pour une propriété Google Analytics. Pour en savoir plus sur le fonctionnement des audiences de remarketing, consultez l'article À propos des audiences de remarketing dans Analytics.

Cas d'utilisation

La ressource d'audience de remarketing est compatible avec les méthodes get, delete, list, patch et update, mais les principaux cas d'utilisation sont les suivants:

Lister les audiences de remarketing

Pour répertorier toutes les audiences de remarketing pour une propriété, procédez comme suit:

  1. Utilisez l'API Management ou l'explorateur de comptes pour récupérer accountId et webPropertyId.
  2. Exécutez la méthode list de la ressource Audiences de remarketing.

Consultez la documentation de référence de l'API pour en savoir plus sur la méthode list associée à la ressource Audience de remarketing.

Créer une audience de remarketing

Pour créer une audience de remarketing pour une propriété:

  1. Utilisez l'API Management ou l'explorateur de comptes pour récupérer accountId et webPropertyId.
  2. Utilisez l'API Management ou l'explorateur de comptes pour récupérer l'ID de la vue (profil) de la propriété linkedViews [].
  3. La collection Associations Google Ads permet de récupérer un ID de compte Google Ads pour linkedAdAccounts.linkedAccountId.
    • La propriété linkedAdAccounts[] est actuellement limitée à un seul linkedForeignAccount.
    • linkedAdAccounts[].type peut être défini sur ADWORDS_LINKS, DBM_LINKS, MCC_LINKS ou OPTIMIZE.
  4. Utilisez la collection Segments pour définir les options de la propriété segment de includeConditions. Si vous créez une audience basée sur l'état, faites de même pour excludeConditions. Consultez également la documentation de référence sur les segments pour savoir comment définir un segment.
    • includeConditions peut éventuellement contenir des valeurs pour membershipDurationDays et daysToLookBack.
    • excludeConditions.exclusionDuration peut éventuellement être défini sur PERMANENT.
  5. Exécutez la méthode insert de la ressource d'audience de remarketing.

L'API vous permet de créer deux types d'audiences: SIMPLE et STATE_BASED. Pour les audiences SIMPLE, il vous suffit de créer la audienceDefinition avec un segment positif, sans opérateur NOT (le caractère !). Si vous souhaitez inclure une condition d'exclusion, vous devez définir un statebasedDefinition. Pour en savoir plus, consultez la section Audiences basées sur l'état. Pour en savoir plus, consultez l'exemple de référence.

Mettre à jour une audience de remarketing

Pour mettre à jour une audience de remarketing existante pour une propriété:

  1. Si vous disposez déjà de l'ID d'audience de remarketing, vous pouvez appeler get. Sinon, vous pouvez appeler list et sélectionner l'audience que vous souhaitez mettre à jour.
  2. Mettez à jour les champs accessibles en écriture et appelez update en transmettant l'objet d'audience mis à jour.