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 s'agit de l'enfant SEULEMENT d'un flux iOS, qui ne peut en contenir qu'un seul sous un flux iOS. Format: Properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Obligatoire. Paramètres de valeur de conversion pour la première période de postback. Elles diffèrent des valeurs des fenêtres de postback 2 et 3, car elles contiennent la mention "Fine" (Fine). valeur de conversion précise (valeur numérique).

Les valeurs de conversion pour cette période de postback doivent être définies. Les autres fenêtres sont facultatives et peuvent hériter des paramètres de cette fenêtre si elle n'est pas configurée ou si elle est désactivée.

postbackWindowTwo

object (PostbackWindow)

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

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

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

postbackWindowThree

object (PostbackWindow)

Paramètres de 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 période de postback. Vous pouvez configurer la fenêtre 3 sans définir la fenêtre 2. Dans le cas des fenêtres 1 et Deux paramètres sont définis et enable_postback_window_settings est défini sur "false" pour cette fenêtre de postback. 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 moins indexées sont prioritaires. Le premier paramètre de valeur de conversion qui prend la valeur "true" est sélectionné. Il doit comporter 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", les valeurs de conversion doivent être renseignées. Elles seront utilisées pour déterminer quand et comment définir la valeur de conversion sur un appareil client, et pour 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 à l'avenir. Cela doit toujours être vrai pour postbackWindowOne.

ConversionValues

Paramètres de 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 pour le 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 de l'événement qui doivent être remplies pour que cette valeur de conversion soit atteinte. Les conditions de cette liste sont reliées par l'opérateur AND. Elle doit comporter entre 1 et 3 entrées si la période de postback est activée.

lockEnabled

boolean

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

fineValue

integer

Valeur de conversion précise Cela ne s'applique qu'à la première période de postback. Ses valeurs valides sont [0,63], toutes deux incluses. Il doit être défini pour la période de postback 1, et non pour la période de postback 2 et 3. Il n'est pas garanti que cette valeur soit unique.

Si la configuration de la première période de postback est réutilisée pour la deuxième ou la troisième période de postback, ce champ n'a aucun effet.

CoarseValue

Valeur de conversion approximative définie dans l'appel du SDK updatePostbackConversionValue lorsqu'une condition ConversionValues.event_mappings est remplie. Pour en savoir plus, consultez SKAdNetwork.CoarseConversionValue.

Enums
COARSE_VALUE_UNSPECIFIED Valeur approximative non spécifiée.
COARSE_VALUE_LOW Valeur approximative ou faible.
COARSE_VALUE_MEDIUM Valeur approximative du support.
COARSE_VALUE_HIGH Valeur approximative ou élevée.

EventMapping

Conditions de définition d'un événement pour une correspondance avec 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 GA4. 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 minimale/maximale suivantes doit être définie. Les valeurs définies seront reliées par l'opérateur AND pour qualifier un événement. Nombre minimal de fois où l'événement s'est produit. Si cette règle n'est pas configurée, 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 cette règle n'est pas configurée, 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 la propriété. Si cette règle n'est pas configurée, 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 la propriété. Si cette règle n'est pas configurée, 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.