Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Crée ou met à jour le schéma CustomerSkAdNetworkConversionValueSchema.

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

Requête HTTP

POST https://googleads.googleapis.com/v16/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,
  "enableWarnings": 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.
enableWarnings

boolean

Facultatif. Si la valeur est "true", active l'affichage d'avertissements. Les avertissements renvoient des messages d'erreur et des codes d'erreur sans bloquer l'exécution de l'opération de mutation.

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)
  },
  "warning": {
    object (Status)
  }
}
Champs
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

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

object (Status)

Erreurs non bloquantes qui fournissent des détails sur l'échec de la validation du schéma. Renvoyée uniquement lorsque enableAvertissements = true.

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 ont le format suivant: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}.
schema

object (SkAdNetworkConversionValueSchema)

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

SkAdNetworkConversionValueSchema

Le schéma SkAdNetworkConversionValueSchema spécifique à CustomerLink.

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

string

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

integer

Uniquement en sortie. Période (mesurée en heures) après l'installation, après 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. Pour les versions 4.0 ou ultérieures de SkAdNetwork acceptant plusieurs périodes de suivi des conversions, les mappages plus précis des valeurs de conversion ne s'appliquent qu'au premier postback.
postbackMappings[]

object (PostbackMapping)

Uniquement en sortie. Mappages de la valeur de conversion par postback pour les postbacks dans plusieurs périodes de suivi des conversions. S'applique uniquement aux versions 4.0 ou ultérieures de SkAdNetwork.

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 détaillée est mappée

ConversionValueMapping

Représente le mappage entre une valeur de conversion et 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. Durée 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. Durée maximale de la période 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 ayant divers attributs.

Événement

Définit un événement de conversion Google auquel la valeur de conversion est associé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 enregistré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 de l'événement. 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. Il s'agit soit d'une plage, soit d'une 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 du compteur 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 traité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 traité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, valeur minimale de la plage définie. Une valeur de 0 est traitée comme non définie.
maxEventCount

string (int64 format)

Uniquement en sortie. Plage maximale de la plage définie pour les compteurs d'événements. Une valeur de 0 est traitée comme non définie.

PostbackMapping

Mappages pour chaque postback dans plusieurs périodes de suivi des conversions.

Représentation JSON 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
Champs
postbackSequenceIndex

integer

Uniquement en sortie. Index basé sur 0 indiquant l'ordre du postback. Les valeurs valides sont comprises dans la plage inclusive [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

Uniquement en sortie. Mappages des valeurs de conversion pour toutes les valeurs de conversion sommaires.
Champ d'union lock_window_trigger. Valeur d'événement ou de conversion utilisée pour verrouiller la période de suivi des conversions. lock_window_trigger ne peut être qu'un des éléments suivants :
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Uniquement en sortie. Valeur de conversion sommaire qui déclenche le verrouillage de la période de suivi des conversions.
lockWindowFineConversionValue

integer

Uniquement en sortie. Valeur de conversion détaillée qui déclenche le verrouillage de la période de suivi des conversions.
lockWindowEvent

string

Uniquement en sortie. Nom de l'événement qui déclenche le verrouillage de la période de suivi des conversions.

CoarseGrainedConversionValueMappings

Mappages pour des valeurs de conversion sommaires.

Représentation JSON 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Champs
lowConversionValueMapping

object (ConversionValueMapping)

Uniquement en sortie. Mise en correspondance pour une valeur de conversion approximative "faible".
mediumConversionValueMapping

object (ConversionValueMapping)

Uniquement en sortie. Mise en correspondance pour la valeur de conversion approximative "moyenne".
highConversionValueMapping

object (ConversionValueMapping)

Uniquement en sortie. Mappage pour une valeur de conversion approximative "élevée".

MutateCustomerSkAdNetworkConversionValueSchemaResult

Résultat de la modification du schéma de conversion CustomerSkAdNetworkConversionValueSchema.

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

string

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

string

ID de l'application SkanConversionValue modifié.