Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Crée ou met à jour le CustomerSkAdNetworkConversionValueSchema.

Liste des erreurs générées: AuthenticationError AuthorizationError FieldError InternalError MutateError

Requête HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Identifiant du client dont les ensembles partagés sont en cours de modification.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean
}
Champs
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

Opération à effectuer.
validateOnly

boolean

Si la valeur est "true", la requête est validée, mais pas exécutée. Seules les erreurs sont renvoyées, pas les résultats.

Corps de la réponse

Message de réponse pour customerSkAdNetworkConversionValueSchemas.mutate.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  }
}
Champs
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Tous les résultats pour la méthode mutate.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/adwords

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

CustomerSkAdNetworkConversionValueSchemaOperation

Opération de mise à jour unique pour CustomerSkAdNetworkConversionValueSchema.

Représentation JSON 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
Champs
update

object (CustomerSkAdNetworkConversionValueSchema)

Opération de mise à jour: le schéma doit avoir un nom de ressource valide.

CustomerSkAdNetworkConversionValueSchema

CustomerSkAdNetworkConversionValueSchema.

Représentation JSON 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
Champs
resourceName

string

Uniquement en sortie. Nom de ressource du schéma. Les noms des ressources CustomerSkAdNetworkConversionValueSchema sont au format suivant: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

Uniquement en sortie. Schéma de la ressource spécifiée.

SkAdNetworkConversionValueSchema

Le SkAdNetworkConversionValueSchema spécifique à CustomerLink.

Représentation JSON 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ]
}
Champs
appId

string

Obligatoire. Uniquement en sortie. ID d'application App Store d'Apple.
measurementWindowHours

integer

Uniquement en sortie. Période (mesurée en heures) après l'installation, au terme de laquelle le partenaire du programme App Attribution Partner ou l'annonceur cesse d'appeler updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Uniquement en sortie. Mappages précis des valeurs de conversion.

FineGrainedConversionValueMappings

Mappages pour une valeur de conversion plus précise

Représentation JSON 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Champs
fineGrainedConversionValue

integer

Uniquement en sortie. Valeur de conversion précise. Les valeurs valides sont comprises dans la plage inclusive [0,63].
conversionValueMapping

object (ConversionValueMapping)

Uniquement en sortie. Événements de conversion auxquels la valeur de conversion précise est mappée

ConversionValueMapping

Représente le mappage d'une valeur de conversion vers un ou plusieurs événements de conversion.

Représentation JSON 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
Champs
minTimePostInstallHours

string (int64 format)

Uniquement en sortie. Valeur minimale de la période pendant laquelle un utilisateur a été actif pour la dernière fois au cours de la période de mesure.
maxTimePostInstallHours

string (int64 format)

Uniquement en sortie. Période maximale pendant laquelle un utilisateur a été actif pour la dernière fois au cours de la période de mesure.
mappedEvents[]

object (Event)

Uniquement en sortie. La valeur de conversion peut être associée à plusieurs événements avec divers attributs.

Événement

Définit un événement de conversion Google auquel la valeur de conversion est mappée.

Représentation JSON 
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
Champs
mappedEventName

string

Uniquement en sortie. Nom de l'événement Google représenté par cette valeur de conversion.
currencyCode

string

Uniquement en sortie. Devise indiquée pour event_revenue. Code de devise ISO 4217 à trois lettres, par exemple "EUR"
Champ d'union revenue_rate. Plage ou valeur spécifique des revenus issus des événements. revenue_rate ne peut être qu'un des éléments suivants :
eventRevenueRange

object (RevenueRange)

Uniquement en sortie. Plage de revenus de l'événement.
eventRevenueValue

number

Uniquement en sortie. Valeur des revenus spécifiques à l'événement.
Champ d'union event_rate. Plage ou valeur spécifique pour le compteur d'événements. event_rate ne peut être qu'un des éléments suivants :
eventOccurrenceRange

object (EventOccurrenceRange)

Uniquement en sortie. Plage de compteurs d'événements.
eventCounter

string (int64 format)

Uniquement en sortie. Pour des valeurs de compteur d'événements spécifiques.

RevenueRange

Définit une plage pour les valeurs des revenus.

Représentation JSON 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
Champs
minEventRevenue

number

Uniquement en sortie. Pour les plages de revenus, il s'agit de la valeur minimale (en currencyCode) pour laquelle cette valeur de conversion serait mise à jour. Une valeur de 0 est considérée comme non définie.
maxEventRevenue

number

Uniquement en sortie. Pour les plages de revenus, il s'agit de la valeur maximale (en currencyCode) pour laquelle cette valeur de conversion serait mise à jour. Une valeur de 0 est considérée comme non définie.

EventOccurrenceRange

Définit une plage pour les valeurs du compteur d'événements.

Représentation JSON 
{
  "minEventCount": string,
  "maxEventCount": string
}
Champs
minEventCount

string (int64 format)

Uniquement en sortie. Pour les plages de compteurs d'événements, il s'agit de la valeur minimale de la plage définie. Une valeur de 0 est considérée comme non définie.
maxEventCount

string (int64 format)

Uniquement en sortie. Pour les plages de compteurs d'événements, il s'agit du maximum de la plage définie. Une valeur de 0 est considérée comme non définie.

MutateCustomerSkAdNetworkConversionValueSchemaResult

Résultat de la mutation CustomerSkAdNetworkConversionValueSchema.

Représentation JSON 
{
  "resourceName": string,
  "appId": string
}
Champs
resourceName

string

Nom de ressource du client qui a été modifié.
appId

string

ID d'application de SkanConversionValue modifié.