REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Ressource: SKAdNetworkConversionValueSchema

Schéma de 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

Uniquement en sortie. Nom de ressource du schéma. Il ne peut s'agir que d'un 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 période de postback. Elles diffèrent des valeurs de la fenêtre de postback 2 et 3 en ce sens qu'elles contiennent une valeur de conversion "précise" (une valeur numérique).

Les valeurs de conversion pour cette période de suivi 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 période de postback.

Ce champ ne doit être configuré que si vous devez 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 période de postback, les valeurs de postbackWindowOne seront utilisées.

postbackWindowThree

object (PostbackWindow)

Paramètres de la valeur de conversion pour la troisième période de postback.

Ce champ ne doit être défini que si l'utilisateur a choisi de définir des valeurs de conversion différentes pour cette fenêtre de postback. Il est autorisé à 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éritera des paramètres de postbackWindowTwo.

applyConversionValues

boolean

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

PostbackWindow

Paramètres d'une période de postback de conversion SKAdNetwork.

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

object (ConversionValues)

L'ordre du champ répété sera utilisé pour hiérarchiser les paramètres de valeur de conversion. Les entrées dont l'indice est inférieur sont prioritaires. Le premier paramètre de valeur de conversion qui renvoie "true" est sélectionné. Il doit contenir au moins une entrée si enable_postback_window_settings est défini sur "true". Il peut contenir jusqu'à 128 entrées.

postbackWindowSettingsEnabled

boolean

Si enable_postback_window_settings est défini sur "true", conversionValues doit être renseigné. Il servira à 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 la valeur est "false", les paramètres ne sont pas utilisés, mais sont conservés au cas où ils pourraient être utilisés plus tard. Cette valeur doit toujours être définie sur "true" pour postbackWindowOne.

ConversionValues

Paramètres de la valeur de conversion pour une période de postback pour le schéma de 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 du nom à afficher est de 50 unités de code UTF-16.

coarseValue

enum (CoarseValue)

Obligatoire. Valeur de conversion sommaire.

Il n'est pas garanti que cette valeur soit unique.

eventMappings[]

object (EventMapping)

Conditions d'événement qui doivent être remplies pour que cette valeur de conversion soit atteinte. Les conditions de cette liste sont combinées avec l'opérateur AND. Il doit contenir au moins une entrée et au maximum trois entrées si la fenêtre de postback est activée.

lockEnabled

boolean

Si cette valeur est définie sur "true", le SDK doit verrouiller cette valeur de conversion pour la période de postback actuelle.

fineValue

integer

Valeur de conversion détaillée. Cela ne s'applique qu'à la première période de postback. Les valeurs valides sont [0,63], les deux valeurs inclusives. Il doit être défini pour la période de postback 1, et ne doit pas l'être pour les périodes de postback 2 et 3. Il n'est pas garanti que cette valeur soit unique.

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

CoarseValue

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

Enums
COARSE_VALUE_UNSPECIFIED Valeur "coarse" non spécifiée.
COARSE_VALUE_LOW Valeur basse approximative.
COARSE_VALUE_MEDIUM Valeur approximative de "moyen".
COARSE_VALUE_HIGH Valeur approximative de haute.

EventMapping

Conditions de configuration d'événement correspondant à un événement.

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 du nom à afficher est de 40 unités de code UTF-16.

minEventCount

string (int64 format)

Vous devez définir au moins l'une des quatre valeurs minimales/maximales suivantes. Les valeurs définies seront combinées avec l'opérateur AND pour qualifier un événement. Nombre minimal de fois où l'événement s'est produit. Si ce n'est pas le cas, le nombre minimal d'événements ne sera pas vérifié.

maxEventCount

string (int64 format)

Nombre maximal de fois où l'événement s'est produit. Si ce nombre n'est pas défini, le nombre maximal d'événements ne sera pas vérifié.

minEventValue

number

Revenus minimaux générés par l'événement. La devise des revenus sera définie au niveau de l'établissement. Si elle n'est pas définie, la valeur minimale de l'événement ne sera pas vérifiée.

maxEventValue

number

Revenu maximal généré par l'événement. La devise des revenus sera définie au niveau de l'établissement. Si elle n'est pas définie, la valeur maximale de l'événement ne sera pas vérifiée.

Méthodes

create

Crée un SKAdNetworkConversionValueSchema.

delete

Supprime le SKAdNetworkConversionValueSchema cible.

get

Recherche un seul SKAdNetworkConversionValueSchema.

list

Répertorie SKAdNetworkConversionValueSchema sur un flux.

patch

Met à jour un SKAdNetworkConversionValueSchema.