Créer une audience de ciblage par liste de clients

Créez une audience de ciblage par liste de clients en envoyant un CreateUserListRequest.

Construire le corps de la requête

Créez une ressource UserList. Voici les champs courants à définir.

displayName

Obligatoire : nom à afficher de la liste. Le nom doit être unique parmi toutes les listes appartenant au compte.

description

Brève description de la liste.

integrationCode

ID provenant de votre système.

membershipDuration

Durée pendant laquelle un membre de l'audience reste dans la liste après y avoir été ajouté. La valeur doit correspondre à des jours entiers. Si ce champ n'est pas défini, la valeur par défaut est la valeur maximale.

Si vous utilisez JSON, calculez le nombre de secondes en multipliant le nombre de jours de la durée par 86400 (le nombre de secondes par jour). Définissez ensuite la valeur sur le résultat de la multiplication, suivi de s. Par exemple, si vous souhaitez une durée d'abonnement de 90 jours, utilisez la valeur 7776000s, car 90 * 86400 = 7776000.

Si vous utilisez le format de tampon de protocole, utilisez la méthode pratique pour construire un objet Duration en fonction du nombre de jours, si une telle méthode pratique existe. Par exemple, la bibliothèque protobuf-java-util pour Java dispose d'une méthode pratique fromDays(). Sinon, calculez le nombre de secondes en multipliant la durée en jours par 86400 (le nombre de secondes par jour), puis utilisez le résultat pour définir le champ seconds de l'objet Duration.

Champs obligatoires pour le ciblage par liste de clients

Le champ ingestedUserListInfo est obligatoire pour une audience de ciblage par liste de clients.

Voici les champs à définir sur IngestedUserListInfo en fonction du type de données que vous souhaitez utiliser pour ajouter des membres à la liste d'audience.

Liste des coordonnées

Définissez les champs suivants si vous souhaitez utiliser des coordonnées (adresses e-mail, numéros de téléphone ou adresses hachées) pour définir les membres de votre audience :

uploadKeyTypes

Définissez sur une liste contenant le type de clé d'importation CONTACT_ID.

La liste uploadKeyTypes ne doit contenir qu'une seule entrée.

contactIdInfo

Définissez sur un message ContactIdInfo avec dataSourceType défini sur la valeur appropriée de l'énumération DataSourceType.

Liste des ID mobiles

Définissez les champs suivants si vous souhaitez utiliser des ID mobiles pour définir les membres de votre audience :

uploadKeyTypes

Définissez sur une liste contenant le type de clé d'importation MOBILE_ID.

La liste uploadKeyTypes ne doit contenir qu'une seule entrée.

mobileIdInfo

Définissez un message : MobileIdInfo

• Définissez dataSourceType sur la valeur appropriée de l'énumération DataSourceType.

• Définissez keySpace sur IOS ou ANDROID.

• Définissez appId sur la chaîne qui identifie de manière unique l'application mobile à partir de laquelle les données ont été collectées.

  • Pour iOS, la chaîne d'ID est la chaîne à neuf chiffres qui apparaît à la fin de l'URL de l'App Store. Par exemple, 476943146 pour l'application "Flood-It!" avec le lien de l'App Store https://apps.apple.com/us/app/flood-it/id476943146.

  • Pour Android, la chaîne d'ID correspond au nom du package de l'application. Par exemple, com.labpixies.flood pour l'application "Flood-It!" avec le lien Google Play https://play.google.com/store/apps/details?id=com.labpixies.flood.

Créer la requête

Pour créer une audience de ciblage des clients, créez une requête create pour la ressource UserList.

1. Définissez le champ parent sur le nom de ressource du compte. Le nom de la ressource doit respecter le format accountTypes/{accountType}/accounts/{account_id}.

2. Utilisez le UserList que vous avez créé pour le corps de la requête.

3. Si vos identifiants ne correspondent pas à un compte Google qui est un utilisateur sur le parent, définissez les en-têtes comme décrit dans Configurer les destinations et les en-têtes.

Voici des exemples de requêtes au format JSON pour les différents types d'informations utilisateur. Chaque requête définit membershipDuration sur 2592000s, où 2592000 correspond au nombre de secondes dans 30 jours. Cliquez sur le bouton Ouvrir dans APIs Explorer pour essayer une requête.

Coordonnées

Ouvrir dans APIs Explorer

{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

ID mobiles

Ouvrir dans APIs Explorer

{
    "description": "Customer Match for mobile IDs",
    "displayName": "Mobile ID audience",
    "ingestedUserListInfo": {
        "mobileIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY",
            "keySpace": "ANDROID",
            "appId": "com.labpixies.flood"
        },
        "uploadKeyTypes": [
            "MOBILE_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Envoyer la requête

Envoyez la requête et, si nécessaire, incluez les en-têtes de requête.

Si la requête aboutit, la réponse contient le UserList créé avec les champs id et name renseignés. Notez les valeurs de ces champs, car vous en aurez besoin dans les demandes d'ajout de membres à l'audience.

Si la requête échoue, examinez les erreurs pour déterminer la cause de l'échec, mettez à jour la requête et les en-têtes pour résoudre les problèmes, puis envoyez la requête et les en-têtes mis à jour.