REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Ressource : SKAdNetworkConversionValueSchema

Schéma de la valeur de conversion SKAdNetwork d'un flux iOS.

Représentation JSON
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Champs
name

string

Identifiant. Nom de ressource du schéma. Il s'agit de l'enfant d'UN SEUL flux iOS, et il ne peut y avoir qu'un seul enfant de ce type sous un flux iOS. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Obligatoire. Paramètres de la valeur de conversion pour la première fenêtre de postback. Ils diffèrent des valeurs des deuxième et troisième fenêtres de postback, car ils contiennent une valeur de conversion précise (valeur numérique).

Les valeurs de conversion de cette fenêtre de postback doivent être définies. Les autres fenêtres sont facultatives et peuvent hériter des paramètres de cette fenêtre si elles ne sont pas définies ou désactivées.

postbackWindowTwo

object (PostbackWindow)

Paramètres de la valeur de conversion pour la deuxième fenêtre de postback.

Ce champ ne doit être configuré que s'il est nécessaire de définir différentes valeurs de conversion pour cette fenêtre de postback.

Si enable_postback_window_settings est défini sur "false" pour cette fenêtre de postback, les valeurs de postbackWindowOne sont utilisées.

postbackWindowThree

object (PostbackWindow)

Paramètres de la valeur de conversion pour la troisième fenêtre de postback.

Ce champ ne doit être défini que si l'utilisateur a choisi de définir différentes valeurs de conversion pour cette fenêtre de postback. Il est possible de configurer la fenêtre 3 sans définir la fenêtre 2. Si les paramètres des fenêtres 1 et 2 sont définis et que enable_postback_window_settings pour cette fenêtre de postback est défini sur "false", le schéma hérite des paramètres de postbackWindowTwo.

applyConversionValues

boolean

Si cette option est activée, le SDK GA définit les valeurs de conversion à l'aide de cette définition de schéma, et le schéma est exporté vers tous les comptes Google Ads associés à cette propriété. Si cette option est désactivée, le SDK GA ne définit pas automatiquement les valeurs de conversion, et le schéma n'est pas exporté vers Ads.

PostbackWindow

Paramètres d'une fenêtre de postback de conversion SKAdNetwork.

Représentation JSON
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Champs
conversionValues[]

object (ConversionValues)

L'ordre du champ répété est utilisé pour hiérarchiser les paramètres de la valeur de conversion. Les entrées indexées inférieures sont prioritaires. Le premier paramètre de valeur de conversion qui renvoie "true" est sélectionné. Il doit comporter au moins une entrée si enable_postback_window_settings est défini sur "true". Il peut comporter au maximum 128 entrées.

postbackWindowSettingsEnabled

boolean

Si enable_postback_window_settings est défini sur "true", conversionValues doit être renseigné et sera utilisé pour déterminer quand et comment définir la valeur de conversion sur un appareil client et exporter le schéma vers les comptes Ads associés. Si cette option est définie sur "false", les paramètres ne sont pas utilisés, mais sont conservés au cas où ils seraient utilisés à l'avenir. Cette option doit toujours être définie sur "true" pour postbackWindowOne.

ConversionValues

Paramètres de la valeur de conversion pour une fenêtre de postback pour le schéma de la valeur de conversion SKAdNetwork.

Représentation JSON
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
Champs
displayName

string

Nom à afficher de la valeur de conversion SKAdNetwork. La longueur maximale autorisée pour le nom à afficher est de 50 unités de code UTF-16.

coarseValue

enum (CoarseValue)

Obligatoire. Valeur de conversion sommaire.

Cette valeur n'est pas garantie d'être unique.

eventMappings[]

object (EventMapping)

Conditions d'événement qui doivent être remplies pour atteindre cette valeur de conversion. Les conditions de cette liste sont combinées par un opérateur ET. Elle doit comporter au minimum une entrée et au maximum trois entrées si la fenêtre de postback est activée.

lockEnabled

boolean

Si cette option est définie sur "true", le SDK doit se verrouiller sur cette valeur de conversion pour la fenêtre de postback actuelle.

fineValue

integer

Valeur de conversion précise. Cela ne s'applique qu'à la première fenêtre de postback. Les valeurs valides sont comprises entre 0 et 63 inclus. Elle doit être définie pour la fenêtre de postback 1 et ne doit pas l'être pour les fenêtres de postback 2 et 3. Cette valeur n'est pas garantie d'être unique.

Si la configuration de la première fenêtre de postback est réutilisée pour les deuxième ou troisième fenêtres de postback, ce champ n'a aucun effet.

CoarseValue

Valeur de conversion sommaire définie dans l'appel SDK updatePostbackConversionValue lorsque les conditions ConversionValues.event_mappings sont remplies. Pour en savoir plus, consultez SKAdNetwork.CoarseConversionValue.

Enums
COARSE_VALUE_UNSPECIFIED Valeur sommaire non spécifiée.
COARSE_VALUE_LOW Valeur sommaire faible.
COARSE_VALUE_MEDIUM Valeur sommaire moyenne.
COARSE_VALUE_HIGH Valeur sommaire élevée.

EventMapping

Conditions de paramétrage d'un événement à faire correspondre.

Représentation JSON
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Champs
eventName

string

Obligatoire. Nom de l'événement Google Analytics. Il doit toujours être défini. La longueur maximale autorisée pour le nom à afficher est de 40 unités de code UTF-16.

minEventCount

string (int64 format)

Au moins l'une des quatre valeurs minimales/maximales suivantes doit être définie. Les valeurs définies sont combinées par un opérateur ET pour qualifier un événement. Nombre minimal de fois où l'événement s'est produit. Si cette option n'est pas définie, le nombre minimal d'événements n'est pas vérifié.

maxEventCount

string (int64 format)

Nombre maximal de fois où l'événement s'est produit. Si cette option n'est pas définie, le nombre maximal d'événements n'est pas vérifié.

minEventValue

number

Revenus minimaux générés par l'événement. La devise des revenus est définie au niveau de la propriété. Si cette option n'est pas définie, la valeur minimale de l'événement n'est pas vérifiée.

maxEventValue

number

Revenus maximaux générés par l'événement. La devise des revenus est définie au niveau de la propriété. Si cette option n'est pas définie, la valeur maximale de l'événement n'est pas vérifiée.

Méthodes

create

Crée un SKAdNetworkConversionValueSchema.

delete

Supprime le SKAdNetworkConversionValueSchema cible.

get

Recherche un seul SKAdNetworkConversionValueSchema.

list

Liste les SKAdNetworkConversionValueSchema sur un flux.

patch

Met à jour un SKAdNetworkConversionValueSchema.