Attention:Vous consultez la documentation de l'interface REST de l'API. La plupart de nos bibliothèques clientes officielles utilisent gRPC. Pour en savoir plus, consultez la présentation de REST.

Cette page a été traduite par l'API Cloud Translation.

OfflineUserDataJob

Représentation JSON
OfflineUserDataJobType
OfflineUserDataJobStatus
OfflineUserDataJobFailureReason
OfflineUserDataJobMetadata
- Représentation JSON
OfflineUserDataJobMatchRateRange
StoreSalesMetadata
- Représentation JSON
StoreSalesThirdPartyMetadata
- Représentation JSON

Job contenant des données utilisateur hors connexion des visiteurs du magasin ou des membres de la liste d'utilisateurs, qui seront traitées de manière asynchrone. Les données importées ne sont pas lisibles, et les résultats du traitement de la tâche ne peuvent être lus qu'à l'aide de GoogleAdsService.Search/SearchStream.

Représentation JSON

Représentation JSON
{ "resourceName": string, "type": enum (`OfflineUserDataJobType`), "status": enum (`OfflineUserDataJobStatus`), "failureReason": enum (`OfflineUserDataJobFailureReason`), "operationMetadata": { object (`OfflineUserDataJobMetadata`) }, "id": string, "externalId": string, // Union field `metadata` can be only one of the following: "customerMatchUserListMetadata": { object (`CustomerMatchUserListMetadata`) }, "storeSalesMetadata": { object (`StoreSalesMetadata`) } // End of list of possible types for union field `metadata`. }

{
  "resourceName": string,
  "type": enum (OfflineUserDataJobType),
  "status": enum (OfflineUserDataJobStatus),
  "failureReason": enum (OfflineUserDataJobFailureReason),
  "operationMetadata": {
    object (OfflineUserDataJobMetadata)
  },
  "id": string,
  "externalId": string,

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  },
  "storeSalesMetadata": {
    object (StoreSalesMetadata)
  }
  // End of list of possible types for union field metadata.
}

Champs
`resourceName`	`string` Immuable. Nom de ressource du job de données utilisateur hors connexion. Les noms des ressources de jobs de données utilisateur hors connexion se présentent sous la forme suivante: `customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}`
`type`	`enum (OfflineUserDataJobType)` Immuable. Type de la tâche.
`status`	`enum (OfflineUserDataJobStatus)` Uniquement en sortie. État de la tâche.
`failureReason`	`enum (OfflineUserDataJobFailureReason)` Uniquement en sortie. Motif de l'échec du traitement, si l'état est "ÉCHEC".
`operationMetadata`	`object (OfflineUserDataJobMetadata)` Uniquement en sortie. Métadonnées du job de données utilisateur hors connexion représentant la plage de taux de correspondance.
`id`	`string (int64 format)` Uniquement en sortie. ID de ce job de données utilisateur hors connexion.
`externalId`	`string (int64 format)` Immuable. ID de job spécifié par l'utilisateur.
Champ d'union `metadata`. Métadonnées de la tâche. `metadata` ne peut être qu'un des éléments suivants :
`customerMatchUserListMetadata`	`object (CustomerMatchUserListMetadata)` Immuable. Métadonnées pour les mises à jour de données dans une liste d'utilisateurs basée sur un CRM.
`storeSalesMetadata`	`object (StoreSalesMetadata)` Immuable. Métadonnées de mise à jour des données de ventes en magasin.

OfflineUserDataJobType

Type de job de données utilisateur hors connexion.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
`STORE_SALES_UPLOAD_FIRST_PARTY`	des données de ventes en magasin (directes) en libre-service.
`STORE_SALES_UPLOAD_THIRD_PARTY`	Données de ventes en magasin directes pour un tiers.
`CUSTOMER_MATCH_USER_LIST`	Données des listes d'utilisateurs du ciblage par liste de clients.
`CUSTOMER_MATCH_WITH_ATTRIBUTES`	Ciblage par liste de clients avec les données d'attribut.

OfflineUserDataJobStatus

État d'un job de données utilisateur hors connexion.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
`PENDING`	Le job a bien été créé et est en attente d'importation.
`RUNNING`	Les importations ont été acceptées et les données sont en cours de traitement.
`SUCCESS`	Les données importées ont bien été traitées.
`FAILED`	Échec du traitement des données importées.

OfflineUserDataJobFailureReason

Motif d'échec d'un job de données utilisateur hors connexion.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
`INSUFFICIENT_MATCHED_TRANSACTIONS`	Le nombre de transactions correspondantes est insuffisant.
`INSUFFICIENT_TRANSACTIONS`	Le nombre de transactions importées est insuffisant.
`HIGH_AVERAGE_TRANSACTION_VALUE`	La valeur moyenne des transactions sur votre compte est inhabituellement élevée. Si c'est intentionnel, contactez l'assistance pour demander une exception. Pour en savoir plus, consultez la page https://support.google.com/google-ads/answer/10018944#transaction_value.
`LOW_AVERAGE_TRANSACTION_VALUE`	La valeur moyenne des transactions est inhabituellement faible pour votre compte. Si c'est intentionnel, contactez l'assistance pour demander une exception. Pour en savoir plus, consultez la page https://support.google.com/google-ads/answer/10018944#transaction_value.
`NEWLY_OBSERVED_CURRENCY_CODE`	Il y a un code de devise que vous n'avez encore jamais utilisé dans vos importations. Si c'est intentionnel, contactez l'assistance pour demander une exception. Pour en savoir plus, consultez la page https://support.google.com/google-ads/answer/10018944#Unrecognized_currency.

OfflineUserDataJobMetadata

Métadonnées du job de données utilisateur hors connexion.

Représentation JSON
{ "matchRateRange": enum (`OfflineUserDataJobMatchRateRange`) }

Champs

matchRateRange

enum (OfflineUserDataJobMatchRateRange)

Uniquement en sortie. Taux de correspondance de la liste d'utilisateurs de ciblage par liste de clients importée. Décrit le taux de correspondance estimé lorsque l'état de la tâche est "RUNNING" (En cours d'exécution) et le taux de correspondance final lorsque le taux de correspondance final est disponible une fois que l'état du job est "SUCCÈS/ÉCHEC".

OfflineUserDataJobMatchRateRange

Plage de taux de correspondance d'un job de données utilisateur hors connexion.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Valeur par défaut pour la plage de taux de correspondance.
`MATCH_RANGE_LESS_THAN_20`	La plage du taux de correspondance pour l'entité d'importation de données hors ligne est comprise entre 0% et 19%.
`MATCH_RANGE_20_TO_30`	La plage du taux de correspondance pour l'entité d'importation de données hors ligne est comprise entre 20% et 30%.
`MATCH_RANGE_31_TO_40`	La plage du taux de correspondance pour l'entité d'importation de données hors ligne est comprise entre 31% et 40%.
`MATCH_RANGE_41_TO_50`	La plage du taux de correspondance pour l'entité d'importation de données hors ligne est comprise entre 41% et 50%.
`MATCH_RANGE_51_TO_60`	La plage du taux de correspondance pour l'entité d'importation de données hors ligne est comprise entre 51% et 60%.
`MATCH_RANGE_61_TO_70`	La plage du taux de correspondance pour l'entité d'importation de données hors ligne est comprise entre 61% et 70%.
`MATCH_RANGE_71_TO_80`	La plage du taux de correspondance pour l'entité d'importation de données hors ligne est comprise entre 71% et 80%.
`MATCH_RANGE_81_TO_90`	La plage du taux de correspondance pour l'entité d'importation de données hors ligne est comprise entre 81% et 90%.
`MATCH_RANGE_91_TO_100`	La plage de taux de correspondance pour l'entité d'importation de données hors ligne est supérieure ou égale à 91%.

StoreSalesMetadata

Métadonnées pour "Store Sales Direct".

Représentation JSON
{ "thirdPartyMetadata": { object (`StoreSalesThirdPartyMetadata`) }, "loyaltyFraction": number, "transactionUploadFraction": number, "customKey": string }

Champs
`thirdPartyMetadata`	`object (StoreSalesThirdPartyMetadata)` Métadonnées pour une importation tierce de ventes en magasin.
`loyaltyFraction`	`number` Il s'agit de la fraction de toutes les transactions identifiables (par exemple, associées à toute forme d'informations sur le client). Obligatoire. Cette part doit être comprise entre 0 (non inclus) et 1.
`transactionUploadFraction`	`number` Il s'agit du ratio des ventes importées par rapport aux ventes globales pouvant être associées à un client. Obligatoire. Cette part doit être comprise entre 0 (non inclus) et 1. Par exemple, si vous importez la moitié des ventes que vous pouvez associer à un client, il s'agit de 0,5.
`customKey`	`string` Nom de la clé de variable personnalisée des ventes en magasin. Clé prédéfinie qui peut être appliquée à la transaction, puis utilisée pour la segmentation personnalisée dans les rapports. Accessible uniquement aux clients figurant sur la liste d'autorisation

StoreSalesThirdPartyMetadata

Métadonnées pour un service tiers de ventes en magasin. Ce produit est réservé aux clients figurant sur la liste d'autorisation. Contactez votre représentant Google Business Development pour en savoir plus sur la configuration de l'importation.

Représentation JSON
{ "advertiserUploadDateTime": string, "validTransactionFraction": number, "partnerMatchFraction": number, "partnerUploadFraction": number, "bridgeMapVersionId": string, "partnerId": string }

Champs
`advertiserUploadDateTime`	`string` Heure à laquelle l'annonceur a importé les données auprès du partenaire. Obligatoire. Le format est "AAAA-MM-JJ HH:MM:SS". Exemples: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
`validTransactionFraction`	`number` Fraction des transactions valides. Les transactions non valides peuvent inclure des formats ou des valeurs non valides. Obligatoire. Cette part doit être comprise entre 0 (non inclus) et 1.
`partnerMatchFraction`	`number` Fraction des transactions valides mises en correspondance avec un ID utilisateur attribué par un tiers côté partenaire. Obligatoire. Cette part doit être comprise entre 0 (non inclus) et 1.
`partnerUploadFraction`	`number` Fraction des transactions valides importées par le partenaire sur Google. Obligatoire. Cette part doit être comprise entre 0 (non inclus) et 1.
`bridgeMapVersionId`	`string` Version des ID de partenaire à utiliser pour les importations. Obligatoire.
`partnerId`	`string (int64 format)` ID du partenaire tiers qui met à jour le flux de transactions.