Guide du développeur pour les audiences de remarketing

Ce document explique comment utiliser l'API Management pour gérer des audiences de remarketing Google Analytics.

Introduction

L'API Management vous permet d'create, de get, de delete, de list, de update et d'audiences de remarketing patch 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 du centre d'aide.

Cas d'utilisation

La ressource Audience de remarketing est compatible avec 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 d'une propriété:

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

Pour en savoir plus sur la méthode list pour la ressource d'audience de remarketing, consultez la documentation de référence de l'API.

Créer une audience de remarketing

Pour créer une audience de remarketing pour une propriété, procédez comme suit:

  1. Utilisez l'API Management ou l'explorateur de compte pour récupérer accountId et webPropertyId.
  2. Utilisez l'API Management ou l'explorateur de compte pour récupérer l'ID de la vue (profil) pour la propriété linkedViews [].
  3. Utilisez la collection Associations à Google Ads afin de récupérer un ID de compte Google Ads pour le 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 la propriété segment du 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 avoir 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 construire 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 une statebasedDefinition. Pour en savoir plus, consultez Audiences basées sur l'état. Pour en savoir plus, consultez l'exemple de référence.

Mettre à jour une audience de remarketing existante

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 l'un des champs accessibles en écriture et appelez update en transmettant l'objet d'audience mis à jour.