Importer dans des listes d'utilisateurs

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

Vous pouvez utiliser l'outil d'importation groupée décrit ci-dessous pour importer différents ID d'annonces vers des listes d'utilisateurs Google pour le ciblage. Vous pouvez également importer des listes d'utilisateurs comme celles associées aux accords de programmatique garanti.

Importation groupée

Les listes d'utilisateurs Google peuvent être utilisées pour le ciblage, et Authorized Buyers permet aux acheteurs de mettre à jour ces listes d'utilisateurs via des requêtes HTTPS POST. Ils doivent indiquer les ID des annonces, les listes d'utilisateurs et le type de mise à jour (ajout ou suppression). La taille maximale d'une telle requête est de 100 Ko, et son URL est la suivante:

https://cm.g.doubleclick.net/upload?nid=GoogleNetworkId

GoogleNetworkId est un ID Authorized Buyers qui peut être récupéré via le champ cookieMatchingNid de la ressource "Accounts" de l'API pour les acheteurs.

Pour la charge utile de la requête POST HTTPS, les acheteurs fournissent un tampon de protocole encodé, qui décrit les listes ou les cookies à modifier.

Authorized Buyers permet d'importer les identifiants suivants sur les serveurs Google:

  • ID utilisateur Google
  • IDFA iOS
  • Identifiant publicitaire Android
  • ID Roku
  • ID Amazon Fire TV
  • ID Xbox/Microsoft

comme indiqué par les champs enum et message ci-dessous dans le fichier cookie-bulk-upload-proto.txt.

Exemple: Ajouter des IDFA à la liste d'utilisateurs

Pour ajouter des IDFA à une liste d'utilisateurs avec l'ID 123, créez le tampon de protocole UpdateUsersDataRequest suivant:

UpdateUsersDataRequest {
  ops {
    user_id: "2024D65F-EBBD-11FF-23AB-823FC255913A"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
  ops {
    user_id: "3024D65F-EBBD-11FF-23AB-823FC255913A"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
  ops {
    user_id: "4024D65F-EBBD-11FF-23AB-823FC255913A"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
  ops {
    user_id: "5024D65F-EBBD-11FF-23AB-823FC255913A"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
}

Envoyez ensuite une requête HTTPS POST avec le tampon de protocole UpdateUsersDataRequest comme charge utile à Authorized Buyers. Si la requête aboutit, vous obtiendrez la réponse suivante:

UpdateUsersDataResponse {
  status = NO_ERROR
}

Si la demande n'aboutit pas, vous obtiendrez la réponse suivante:

UpdateUsersDataRequest {
  ops {
    user_id: "2024D65F-EBBD-11FF-23AB-823FC255913A"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
  ops {
    user_id: "INVALID_FORMAT"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
}

Si le premier user_id est valide, mais que le second n'est pas valide, vous obtiendrez une réponse semblable à celle-ci:

UpdateUsersDataResponse {
{
  status: PARTIAL_SUCCESS
  errors: {
    user_id     : "INVALID_FORMAT"
    error_code  : BAD_COOKIE
    time_added_to_user_list: 2132132132
  }
}