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. Ce flux s'applique SEULEMENT à un enfant d'un flux iOS, et il ne peut y avoir qu'un seul enfant de ce type dans un flux iOS. Format: propriétés/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Obligatoire. Paramètres de valeur de conversion pour la première fenêtre de postback. Elles diffèrent des valeurs des deux et trois périodes de postback, dans la mesure où elles contiennent une valeur de conversion détaillée "Fine" (valeur numérique).

Vous devez définir des valeurs de conversion pour cette période de postback. 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 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 des valeurs de conversion différentes 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 seront utilisées.

postbackWindowThree

object (PostbackWindow)

Paramètres de 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 des valeurs de conversion différentes pour cette période de postback. Il est autorisé 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 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 des 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 n'est pas exporté vers Ads.

PostbackWindow

Paramètres pour une période de postback des conversions 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 indexées les plus faibles ont une priorité plus élevée. Le premier paramètre de valeur de conversion évalué sur "true" sera sélectionné. Elle 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 ultérieurement. La valeur doit toujours être "true" 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. Le nom à afficher ne doit pas dépasser 50 unités de code UTF-16.

coarseValue

enum (CoarseValue)

Obligatoire. Valeur de conversion sommaire.

Le caractère unique de cette valeur n'est pas garanti.

eventMappings[]

object (EventMapping)

Conditions d'événement devant être remplies pour que cette valeur de conversion soit atteinte. Les conditions de cette liste sont associées à 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

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

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 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 la page 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 de la valeur élevée.

EventMapping

Conditions du paramètre 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 GA4. Il doit toujours être défini. Le nom à afficher ne doit pas dépasser 40 unités de code UTF-16.

minEventCount

string (int64 format)

Vous devez définir au moins l'une des quatre valeurs minimale/maximale 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 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

Revenu minimal généré par l'événement. La devise des revenus est 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

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 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 schéma SKAdNetworkConversionValueSchema cible.

get

Recherche un seul SKAdNetworkConversionValueSchema.

list

Répertorie SKAdNetworkConversionValueSchema dans un flux.

patch

Met à jour un SKAdNetworkConversionValueSchema.