Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Attribuer les installations iOS avec SKAdNetwork

La place de marché Google accepte les signaux que le SDK Google Mobile Ads utilise pour lancer l'attribution SKAdNetwork avec l'API SKAdNetwork d'Apple. Vous pouvez intégrer les signaux SKAdNetwork pour permettre aux annonceurs de mesurer l'efficacité des campagnes d'annonces incitant à installer une application pour les appareils iOS tout en préservant la confidentialité des utilisateurs.

La liste suivante décrit l'évolution du comportement d'attribution des installations d'applications en fonction de la version de SKAdNetwork :

2.0-2.1 : l'attribution de l'installation d'une application promue est déterminée par la page produit de l'App Store affichée par StoreKit lorsque l'utilisateur clique sur votre annonce, ce qui l'amène à installer l'application.
2.2+ : prise en charge supplémentaire des annonces vues, où l'attribution de l'installation d'une application promue est accordée lorsque l'utilisateur installe l'application après avoir vu votre annonce.

Pour en savoir plus sur les différences entre les versions de SKAdNetwork, consultez les notes de version de SKAdNetwork.

Configurer les ID SKAdNetwork dans l'UI

Pour recevoir des demandes d'enchères contenant des ID SKAdNetwork, vous devez spécifier vos ID SKAdNetwork dans l'interface utilisateur d'Authorized Buyers ou d'Open Bidding. Par exemple, un ID SKAdNetwork peut avoir une valeur telle que a1b2c3d4e5.skadnetwork.

Pour spécifier votre ID SKAdNetwork dans l'interface utilisateur d'Authorized Buyers ou d'Open Bidding, procédez comme suit :

Dans le menu de navigation Paramètres de l'enchérisseur, cliquez sur Paramètres RTB. La page Paramètre RTB s'affiche.
Accédez à la zone ID SKAdNetwork iOS autorisés pour afficher et configurer les ID SKAdNetwork.

L'image suivante montre un exemple d'ID SKAdNetwork dans le champ ID SKAdNetwork iOS autorisés :

Paramètre "ID SKAdNetwork iOS autorisés" dans les paramètres RTB

Configurer des créations pour l'attribution

Le SDK Google Mobile Ads ne lance l'attribution SKAdNetwork que si l'URL de destination redirige vers le magasin d'applications d'Apple. Lorsque vous envoyez des créations pour examen à l'aide de l'API d'enchères en temps réel, elles doivent utiliser une URL de destination qui est un lien direct vers l'application promue dans le magasin d'applications ou qui utilise des redirections HTTP dont la destination finale est l'application promue dans le magasin d'applications. Le SDK Google Mobile Ads lance l'attribution si la destination finale de l'URL de destination de votre création commence par l'un des préfixes suivants :

https://apps.apple.com
https://itunes.apple.com
itms-apps://
itms://

Si la destination finale de l'URL de destination de votre création ne correspond pas à ces préfixes, ou si votre URL de destination utilise d'autres méthodes de redirection côté client qui ne redirigent pas vers le magasin d'applications, il est possible que le SDK Google Mobile Ads ne lance pas l'attribution SKAdNetwork. La liste suivante présente des exemples de cas où ce processus peut s'appliquer :

Une page HTML qui nécessite une action de l'utilisateur pour rediriger vers le magasin d'applications.
Une page HTML contenant un script de redirection automatique basé sur JavaScript vers le magasin d'applications.
Balises Meta refresh

Lancer l'attribution par type de création

L'action de clic permettant de lancer l'attribution SKAdNetwork peut être configurée pour les différents types de créations comme suit :

HTML: Elle peut être configurée en tant qu'URL de destination sur les balises d'ancrage entourant l'élément cliquable, ou en tant qu'URL cible des opérations window.location à partir d'événements de clic basés sur JavaScript.
MRAID: L'action de clic doit appeler Mraid.open() pour lancer l'attribution SKAdNetwork.
Vidéo VAST: L'URL du magasin d'applications doit être définie dans l'élément ClickThrough du fichier XML VAST.
Natif: L'URL du magasin d'applications doit être définie dans le champ BidResponse.seatbid.bid.{adm/adm_native}.link.url.

Identifier les signaux `BidRequest`

Le champ BidRequest.imp.ext.skadn vous permet de trouver des informations sur les ID SKAdNetwork enregistrés que l'application de l'éditeur accepte. Si le champ skadn est spécifié, vous pouvez utiliser les attributs pour créer une réponse pour une annonce incitant à installer une application ou une annonce de réengagement qui associe une installation ou une conversion à l'un des ID SKAdNetwork inclus. Le champ skadn est un objet SKAdNetworkRequest avec les attributs suivants :

Nom de l'attribut	Description
`sourceapp`	ID de chaîne de l'application de l'éditeur sur l'App Store d'Apple. Utilisez cet attribut pour identifier l'application de l'éditeur.
`skadnetids`	Liste de chaînes représentant vos ID SKAdNetwork compatibles avec l'application de l'éditeur. Vous pouvez vous y référer lorsque vous créez la réponse afin de sélectionner un ID SKAdNetwork compatible avec l'éditeur à spécifier dans le champ `BidResponse.seatbid.bid.ext.skadn.network`.
`versions`	Liste de chaînes représentant les versions de SKAdNetwork compatibles avec l'éditeur. La version de SKAdNetwork que vous spécifiez dans votre réponse avec le champ `BidResponse.seatbid.bid.ext.skadn.version` doit être l'une des versions spécifiées par ce champ.
`fidelities`	Liste de valeurs d'énumération `SKAdNetworkFidelityType` représentant les types de fidélité acceptés par l'éditeur. Voici une description de ces valeurs d'énumération pour les points de terminaison d'enchères configurés pour utiliser OpenRTB aux formats Protobuf et JSON : `VIEW_THROUGH_ADS` (Protobuf) / `0` (JSON) : lorsque vous remportez l'enchère et diffusez une annonce, l'attribution de l'impression peut être reçue dans les 24 heures, lorsque l'annonce est visionnée pendant au moins trois secondes. En général, vous devez afficher un SKOverlay s'il est compatible pour que l'annonceur reçoive ce type d'attribution. `STOREKIT_RENDERED_ADS` (Protobuf) / `1` (JSON) : lorsque vous remportez l'enchère et diffusez une annonce, l'attribution d'une installation d'application ou d'une conversion est initiée par la page produit de l'App Store affichée par StoreKit lorsque l'utilisateur clique sur l'annonce.
`skoverlay`	Valeur booléenne lorsqu'elle est représentée au format OpenRTB Protobuf, ou entier lorsqu'elle est représentée au format OpenRTB JSON. Vous pouvez utiliser cette valeur booléenne pour déterminer si SKOverlay est compatible. Google n'est compatible avec SKOverlay que pour les créations vidéo et d'extrait HTML placées sur un inventaire interstitiel ou avec récompense.

L'exemple suivant montre une demande d'enchère pour un inventaire mobile où l'application de l'éditeur est compatible avec vos ID SKAdNetwork :

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "imp": [
    {
      "id": "1",
      // OMITTED...
      "ext": {
        // OMITTED...
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "cF58w81X"
          ],
          "versions": [
            "2.0",
            "2.1",
            "4.0"
          ],
          "fidelities": [
            1,
            0
          ]
        }
        // OMITTED...
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "5.6.0",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-6156239328255091",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ja"
    },
    "storeurl": "https://www.google.com"
  }
  // OMITTED...
}

Remplir `BidResponse` champ

Vous pouvez inclure des informations d'attribution dans votre réponse à l'enchère pour permettre à l'annonceur de recevoir une notification de postback lorsqu'un utilisateur interagit avec son annonce. Pour en savoir plus sur les notifications de postback, consultez Recevoir des attributions d'annonces et des postbacks.

Vous devez transmettre des informations d'attribution cohérentes avec celles incluses dans la demande d'enchère. Les informations d'attribution sont spécifiées dans le champ BidResponse.seatbid.bid.ext.skadn, qui est un objet SKAdNetworkResponse avec les attributs suivants :

Nom de l'attribut	Description
`version`	Chaîne représentant une version de SKAdNetwork compatible avec l'annonceur. Vous devez spécifier l'une des versions de SKAdNetwork compatibles avec l'éditeur, qui est spécifiée dans `BidRequest.imp.ext.skadn.versions`.
`network`	ID SKAdNetwork de l'annonceur (chaîne). Vous devez spécifier l'un des ID SKAdNetwork inclus dans `BidRequest.imp.ext.skadn.skadnetids`.
`campaign`	ID de chaîne numérique à deux chiffres représentant la campagne publicitaire de l'annonceur. Vous devez spécifier cet attribut plutôt que `sourceidentifier` si votre réponse à l'enchère inclut des informations d'attribution utilisant SKAdNetwork 3.0 ou une version antérieure.
`sourceidentifier`	Chaîne numérique de quatre chiffres représentant l'ID de la campagne publicitaire de l'annonceur. Vous devez spécifier cet attribut plutôt que `campaign` si votre réponse à l'enchère inclut des informations d'attribution utilisant SKAdNetwork 4.0 ou une version ultérieure.
`itunesitem`	ID de chaîne de l'application de l'annonceur sur l'App Store d'Apple. Cette valeur doit être cohérente avec celle spécifiée dans `BidResponse.seatbid.bid.bundle`.
`productpageid`	ID de chaîne facultatif représentant une page produit personnalisée à afficher pour les appareils équipés d'iOS 15 ou version ultérieure. Pour en savoir plus sur les pages produit personnalisées, consultez Pages produit personnalisées sur l'App Store. Si aucune valeur n'est spécifiée, la page produit par défaut s'affiche.
`fidelities`	Liste d'objets `Fidelity` qui identifie les types de fidélité applicables à l'annonce diffusée et fournit des signatures cryptographiques utilisées pour identifier la campagne de l'annonceur lorsque celui-ci reçoit une notification de postback. Vous ne devez spécifier l'attribut `fidelity` qu'avec des valeurs incluses dans `BidRequest.imp.ext.skadn.fidelities`.
`sourceapp`	Chaîne représentant l'application de l'éditeur sur l'App Store d'Apple. Vous devez le spécifier avec l'ID trouvé dans `BidRequest.imp.ext.skadn.sourceapp`.
`skoverlay`	Objet `SKOverlay` représentant la façon dont l'application promue est présentée dans un SKOverlay. Vous ne pouvez spécifier cet attribut que lorsque `BidRequest.imp.ext.skadn.skoverlay` est défini sur `true` pour les points de terminaison d'enchères utilisant le format OpenRTB Protobuf, ou sur `1` lorsque vous utilisez le format OpenRTB JSON.

L'exemple suivant montre une réponse à l'enchère incluant des informations d'attribution d'installation d'application :

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9NaI48SmPW7Zf3MAHR43DY",
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              "version": "4.0",
              "network": "cF58w81X",
              "itunesitem": "788729094",
              "sourceapp": "1422994973",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
                },
                {
                  "fidelity": 1,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
                }
              ],
              "sourceidentifier": "5507"
            },
            "app_promotion_type": 1
            // OMITTED...
          }
        }
      ]
      // OMITTED...
    }
  ]
  // OMITTED...
}

La liste suivante présente le comportement attendu de SKAdNetwork correspondant à la réponse à l'enchère :

Lorsque l'application promue est installée dans les 24 heures suivant le visionnage de l'annonce pendant au moins trois secondes, la notification de postback d'attribution après lecture complète de l'annonce SKAdNetwork est envoyée à l'annonceur.
Lorsque l'utilisateur clique sur l'annonce, une superposition intégrée de la plate-forme de téléchargement d'applications s'affiche pour l'application promue. De plus, la notification de postback d'attribution de clic SKAdNetwork est envoyée à l'annonceur si l'utilisateur installe et ouvre l'application promue.

Améliorer l'attribution avec SKOverlay

Vous pouvez augmenter l'attribution des annonces affichées par StoreKit que vous diffusez en affichant un SKOverlay lorsqu'il est pris en charge. Un SKOverlay permet à l'application de l'éditeur d'afficher une superposition qui permet aux utilisateurs de télécharger l'application promue sans quitter l'application de l'éditeur. Pour en savoir plus sur SKOverlay, consultez SKOverlay.

Lorsque toutes les conditions suivantes sont remplies, l'installation de l'application promue vous est attribuée :

Votre SKOverlay s'affiche pendant au moins trois secondes.
L'application promue est installée dans les 30 jours suivant l'affichage de votre SKOverlay.
Votre SKOverlay était le dernier affiché avant l'installation de l'application promue.

Google est compatible avec SKOverlay pour les créations vidéo VAST et les extraits HTML placés dans des annonces interstitielles ou avec récompense.

Déterminer si SKOverlay est compatible

Lorsque vous recevez une demande d'enchère, vous pouvez vérifier si SKOverlay est compatible en consultant la valeur du champ BidRequest.imp.ext.skadn.skoverlay. SKOverlay est compatible lorsque le champ skoverlay est défini sur true pour les points de terminaison d'enchères utilisant le format OpenRTB Protobuf, ou sur 1 pour les points de terminaison d'enchères utilisant le format OpenRTB JSON.

Placer votre annonce avec un SKOverlay

Lorsque SKOverlay est compatible, vous pouvez spécifier le champ BidResponse.seatbid.bid.ext.skadn.skoverlay pour indiquer que vous souhaitez afficher un SKOverlay. Le champ skoverlay comporte les attributs suivants :

delay : entier représentant le délai en secondes entre l'affichage de l'annonce et l'affichage de SKOverlay. Pour les créations vidéo, l'heure d'affichage correspond à l'heure à laquelle la lecture de la vidéo commence. Si ce champ n'est pas défini, SKOverlay ne s'affiche pas.
endcarddelay : entier représentant le délai en secondes entre l'affichage de la fiche de fin d'une création vidéo et l'affichage de SKOverlay. Si ce champ n'est pas défini, le SKOverlay ne s'affiche pas après la fiche de fin. S'applique uniquement aux créations vidéo VAST placées dans des annonces interstitielles ou avec récompense.
dismissible : valeur booléenne indiquant si l'utilisateur peut ignorer le SKOverlay.

L'exemple suivant montre une réponse à l'enchère :

{
  // OMITTED...
  "seatbid": [
    {
      "bid": [
        {
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              // OMITTED...
              "itunesitem": "422689480",
              "skoverlay": {
                "delay": 5,
                "endcarddelay": 0
              },
              "productpageid": "some_id"
            }
          }
        }
      ]
    }
  ]
}

Examiner le comportement attendu de SKOverlay

Voici le comportement attendu de SKOverlay correspondant à la réponse à l'enchère précédente :

Affichez le SKOverlay cinq secondes après le début de la vidéo.
Affichez le SKOverlay immédiatement après la fiche de fin.
Ouvrez le magasin d'applications lorsque l'utilisateur clique sur le SKOverlay.
Si BidResponse.seatbid.bid.ext.skadn.productpageid est spécifié, les données de la fiche de l'application sur le SKOverlay correspondent à l'icône de la page produit personnalisée.
Pour les créations vidéo VAST, lorsqu'un utilisateur clique sur l'overlay SDK, les URL de suivi des clics et des clics sont pingées.
Pour les créations vidéo VAST, même si un utilisateur ferme le SKOverlay pendant la vidéo, celui-ci s'affiche toujours après la fiche de fin si le champ BidResponse.seatbid.bid.ext.skadn.skoverlay.endcarddelay est défini.