Liens d'attribution directe pour les plateformes CTV, PC et consoles

En bref :  Découvrez la structure et les paramètres des liens d'attribution AppsFlyer pour les plateformes CTV, PC et consoles. Remarque : Pour les applications Android et iOS, y compris les jeux PC Android, utilisez les instructions relatives aux liens d'attribution mobile.

Aperçu

Les liens d'attribution directe pour les plateformes CTV, PC et consoles permettent aux annonceurs de rediriger les utilisateurs et de collecter des données après les clics. Ces liens d'attribution directe sont des liens AppsFlyer qui prennent en charge la redirection et l'attribution pour une seule application de destination sur une seule plateforme à la fois. La destination de la redirection est la valeur du paramètre af_r inclus dans le lien.

Remarque : Pour les applications Android et iOS, y compris les jeux PC Android, utilisez les instructions relatives aux liens d'attribution mobile.

Les liens d'attribution peuvent être directement créés par vous-même et placés derrière les publicités. Pour créer de tels liens, suivez les instructions de cet article.

Alternativement, des liens peuvent être créés via S2S en utilisant l'API Engagements. Cela nécessite un certain travail de développement. Remarque : Les liens créés via S2S peuvent également collecter des données d'impression.

Lien d'attribution

Structure du lien d'attribution
URL de base engagements.appsflyer.com/v1.0/c2s/click/app/
Paramètres de chemin obligatoires
  • plateforme
    Exemple : steam
  • identifiant_application
    Exemple : 123456
Paramètres de requête obligatoires
  • af_media_source
  • af_campaign_id
  • af_r
Autres paramètres Voir tous les paramètres
Structure de l'URL https://engagements.appsflyer.com/v1.0/c2s/click/app/{platform}/{app_id}?af_media_source={media_source}&af_campaign_id={campaign_id}&af_r={app_store_url}
Exemple d'URL https://engagements.appsflyer.com/v1.0/c2s/click/app/steam/123456?af_media_source=aloha&af_campaign_id=1234&af_r=https%3A%2F%2Fstore.steampowered.com%2Fapp%2F440%2FTest_app2%2F%3Futm_term%3Dhello

Paramètres

Paramètre Nom d'affichage dans l'exportation de données brutes et l'API Pull Description Type de champ
plateforme Plateforme
  • Paramètre de chemin spécifiant la plateforme d'application.
  • Valeurs possibles :
    • smartcast
    • tizen
    • roku
    • webos
    • vidaa
    • playstation
    • steam
    • quest
    • battlenet
    • epic
    • switch
    • xbox
    • nativepc 

String

identifiant_application ID de l'application
  • Paramètre de chemin qui spécifie l'ID de l'application pour laquelle vous publiez.
  • Exemple : ap123456

String

af_media_source Source média Il s'agit de l'identifiant unique du partenaire tel que défini sur la plateforme AppsFlyer.
Les caractères spéciaux suivants ne sont pas autorisés : ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %.
String
af_campaign Campagne Nom de la campagne String
af_campaign_id ID de la campagne ID de la campagne String

af_request_id

N/A

Un identifiant unique pour chaque demande d'un partenaire.

String

af_adset

Adset

Nom de l'adset

String

af_adset_id

ID de l'adset

ID de l'adset

String

af_ad

Annonce

Nom de l'annonce

String

af_ad_id

ID de l'annonce

ID de l'annonce

String

af_campaign_type

Type de campagne

Soit :

  • acquisition_utilisateur
  • reciblage

String

af_prt

Partenaire

  • Nom de compte d'agence qui permet d'attribuer des installations à l'agence
  • Attention : N'utilisez pas ce paramètre avant de vérifier que les autorisations de l'agence sont activées

String

af_siteid

ID du site

ID unique qui identifie l'éditeur affichant l'annonce

String

af_sub_siteid

ID du sous-site

ID du sous-réseau/éditeur publicitaire

String

af_click_id

N/A

Identifiant de transaction unique du réseau publicitaire

String

af_lookback_window

N/A

  • Fenêtre de rétrospection pertinente pour l'attribution via une correspondance d'ID.
  • Cnombre de jours/heures configurable pour la période d'attribution de la fenêtre de rétrospection. Valeurs disponibles des paramètres : 1j-30j (jours) OU 1h-23h (heures).
  • Validation : 3 caractères max, en utilisant le schéma ci-dessus.
  • La valeur par défaut est de 24 heures pour les impressions et de 7 jours pour les clics.

String

N/A

Identifiant de transaction unique du réseau publicitaire

String

af_ad_type

Type de publicité

  • Type de publicité. Utilisez la convention de dénomination suivante :
    • texte : une unité publicitaire contenant uniquement du texte, par exemple un résultat de recherche
    • bannière : un format de base qui apparaît en haut ou en bas de l'écran de l'appareil
    • interstitiel : une annonce pleine page qui apparaît pendant les pauses dans l'expérience en cours
    • vidéo : une vidéo classique, qui ne donne pas droit à une récompense
    • vidéo récompensée : une unité publicitaire offrant des récompenses dans l'application en échange du visionnage d'une vidéo
    • jouable : une unité publicitaire contenant un aperçu interactif de l'application
    • audio : une publicité audio
  • Respect de la casse.

String

af_channel

Canal

Le canal de la source média à travers lequel les publicités sont diffusées, par exemple, UAC_Search, UAC_Display, Instagram, Meta Audience Network, etc.

String

af_model

Modèle d'appareil

Modèle d'appareil

String 64

af_os_version

N/A

  • Version de l'OS de l'appareil
  • Seuls les chiffres et les points sont autorisés
  • Exemple : 8.1.0

String

af_device_id_type

N/A

Type d'identifiant d'appareil Soit :

  • vida
  • tifa
  • rida
  • lgudid
  • fire
  • advertising_id
  • fire
  • personnalisé

String

af_device_id_value

N/A

Type d'identifiant d'appareil

String

af_r

N/A

  • Obligatoire
  • Contient le lien vers la boutique d'applications ou la page de destination appropriée
  • Tout ce qui se trouve dans le paramètre af_r doit être encodé. Cela inclut toutes les valeurs des paramètres UTM, si elles sont ajoutées.

String

Caractéristiques et limitations

Fenêtre rétrospective Avec la modélisation probabiliste, une fenêtre rétrospective fixe de 24 heures pour les clics et les impressions est utilisée. La valeur af_lookback_window est ignorée.
Attribution d'agence
  • Flux CTV-PC-Consoles vers mobile - l'attribution d'agence est prise en charge.
  • Flux mobile vers CTV-PC-Consoles - l'attribution d'agence n'est pas prise en charge.