Atribuye las instalaciones de iOS con SKAdNetwork

El intercambio de Google admite los indicadores que usa el SDK de anuncios de Google para dispositivos móviles para iniciar la atribución de SKAdNetwork con la API de SKAdNetwork de Apple. Puedes realizar la integración con los indicadores de SKAdNetwork para permitir que los anunciantes midan el éxito de las campañas de anuncios de instalación de aplicación para dispositivos iOS y, al mismo tiempo, mantengan la privacidad del usuario.

En la siguiente lista, se describe cómo cambia el comportamiento de la atribución de instalación de la app según la versión de SKAdNetwork:

• 2.0-2.1: La atribución de la instalación de una app promocionada se genera a través de la página del producto de App Store renderizada por StoreKit cuando el usuario hace clic en tu anuncio, lo que hace que el usuario instale la app.
• 2.2 y versiones posteriores: Se agregó compatibilidad con los anuncios de vista completa, en los que se atribuye la instalación de una app anunciada cuando el usuario la instala después de ver tu anuncio.

Para obtener más información sobre las diferencias en las versiones de SKAdNetwork, consulta las notas de la versión de SKAdNetwork.

Configura los IDs de SKAdNetwork en la IU

Para recibir solicitudes de ofertas que contengan IDs de SKAdNetwork, debes especificar tus IDs de SKAdNetwork en la IU de Authorized Buyers o de Open Bidding. Por ejemplo, un ID de SKAdNetwork podría tener un valor como a1b2c3d4e5.skadnetwork.

Para especificar tu ID de SKAdNetwork en la IU de Authorized Buyers o de Open Bidding, haz lo siguiente:

1. En el menú de navegación Configuración del ofertante, haz clic en Configuración de RTB. Aparecerá la página Configuración de RTB.
2. Navega al cuadro IDs de SKAdNetwork de iOS permitidos para ver y configurar los IDs de SKAdNetwork.

En la siguiente imagen, se muestra un ejemplo de ID de SKAdNetwork en el cuadro IDs de SKAdNetwork de iOS permitidos:

Configura las creatividades para la atribución

El SDK de anuncios de Google para dispositivos móviles inicia la atribución de SKAdNetwork solo si la URL de clic dirige a la tienda de aplicaciones de Apple. Cuando envías creatividades para su revisión con la API de Real-time Bidding, estas deben usar una URL de clic que sea un vínculo directo a la app anunciada en App Store o que use redireccionamientos HTTP en los que el destino final sea la app anunciada en App Store. El SDK de anuncios de Google para dispositivos móviles inicia la atribución si el destino final de la URL de clic de tu creatividad comienza con alguno de los siguientes prefijos:

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

Si el destino final de la URL de clic de tu creatividad no coincide con estos prefijos o si tu URL de clic usa cualquier otro método de redireccionamiento del lado del cliente que no dirija a la tienda de aplicaciones, es posible que el SDK de anuncios de Google para dispositivos móviles no inicie la atribución de SKAdNetwork. En la siguiente lista, se incluyen ejemplos de dónde se podría aplicar este proceso:

• Una página HTML que requiere que el usuario realice una acción para redireccionarlo a la tienda de aplicaciones
• Una página HTML que tiene una secuencia de comandos de redireccionamiento automatizada basada en JavaScript a la tienda de aplicaciones
• Metaetiquetas de actualización

Inicia la atribución por tipo de creatividad

La acción de clic para iniciar la atribución de SKAdNetwork se puede configurar para los diferentes tipos de creatividades de la siguiente manera:

HTML

Se puede configurar como la URL de destino en las etiquetas de anclaje que rodean el elemento en el que se puede hacer clic o como la URL de destino de las operaciones window.location de los eventos de clic basados en JavaScript.

MRAID

La acción de clic debe llamar a Mraid.open() para iniciar la atribución de SKAdNetwork.

Video de VAST

La URL de la tienda de aplicaciones se debe establecer en el elemento ClickThrough del XML de VAST.

Nativo

La URL de la tienda de aplicaciones se debe establecer en el campo BidResponse.seatbid.bid.{adm/adm_native}.link.url.

Identifica los indicadores de BidRequest

Puedes encontrar información sobre los IDs de SKAdNetwork registrados que admite la app del publicador con el campo BidRequest.imp.ext.skadn. Si se especifica el campo skadn, puedes usar los atributos para compilar una respuesta para un anuncio de instalación de aplicación o de reactivación que asocie una instalación o conversión con uno de los IDs de SKAdNetwork incluidos. El campo skadn es un objeto SKAdNetworkRequest con los siguientes atributos:

En el siguiente ejemplo, se muestra una solicitud de oferta para el inventario de dispositivos móviles en el que la app del publicador admite tus IDs de 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...
}

Completa los campos de BidResponse

Puedes incluir información de atribución en tu respuesta de oferta que permita al anunciante recibir una notificación de conversión cuando un usuario interactúe con su anuncio. Para obtener más información sobre las notificaciones de postback, consulta Cómo recibir atribuciones de anuncios y postbacks.

Debes pasar información de atribución que sea coherente con la que se incluyó en la solicitud de oferta. La información de atribución se especifica en el campo BidResponse.seatbid.bid.ext.skadn, que es un objeto SKAdNetworkResponse con los siguientes atributos:

En el siguiente ejemplo, se muestra una respuesta de oferta que incluye información de atribución de instalación de la app:

{
  "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...
}

En la siguiente lista, se comparte el comportamiento esperado de SKAdNetwork correspondiente a la respuesta de oferta:

• Cuando la app anunciada se instala en un plazo de 24 horas después de que se ve el anuncio durante al menos tres segundos, se envía al anunciante la notificación de devolución de datos de atribución de vista completa de SKAdNetwork.
• Cuando se hace clic en el anuncio, se muestra una superposición de tienda integrada de la app anunciada y se envía la notificación de devolución de datos de atribución de clics de SKAdNetwork al anunciante si el usuario instala y abre la app anunciada.

Aumenta la atribución con SKOverlay

Puedes aumentar la atribución de los anuncios renderizados por StoreKit que colocas mostrando un SKOverlay cuando se admite SKOverlay. Un SKOverlay permite que la app del publicador muestre una superposición que permite a los usuarios descargar la app anunciada sin salir de la app del publicador. Para obtener más información sobre SKOverlay, consulta SKOverlay.

Cuando se cumplen todas las condiciones siguientes, recibes la atribución por la instalación de la app anunciada:

• Tu SKOverlay se muestra durante tres segundos o más.
• La app anunciada se instala en un plazo de 30 días a partir de que se muestra tu SKOverlay.
• Tu SKOverlay fue el último que se mostró antes de que se instalara la app anunciada.

Google admite SKOverlay para fragmentos HTML y creatividades de video de VAST que se colocan en anuncios intersticiales o recompensados.

Determina si se admite SKOverlay

Cuando recibes una solicitud de oferta, puedes verificar si se admite SKOverlay comprobando el valor del campo BidRequest.imp.ext.skadn.skoverlay. SKOverlay se admite en los casos en que el campo skoverlay se establece en true para los extremos de licitación que usan el formato Protobuf de OpenRTB o en 1 para los extremos de licitación que usan el formato JSON de OpenRTB.

Coloca tu anuncio con un SKOverlay

Cuando se admite SKOverlay, puedes especificar el campo BidResponse.seatbid.bid.ext.skadn.skoverlay para indicar que quieres mostrar un SKOverlay. El campo skoverlay tiene los siguientes atributos:

• delay: Es un número entero que representa la demora en segundos entre el momento en que se muestra el anuncio y el momento en que se muestra el SKOverlay. En el caso de las creatividades de video, el tiempo de visualización es el momento en que el video comienza a reproducirse. Si no se configura este campo, no se muestra el SKOverlay.
• endcarddelay: Es un número entero que representa la demora en segundos entre el momento en que se muestra la tarjeta final con llamado a la acción de una creatividad de video y el momento en que se muestra SKOverlay. Si no se configura este campo, no se mostrará el SKOverlay después de la tarjeta final con llamado a la acción. Solo se aplica a las creatividades de video de VAST que se colocan en anuncios intersticiales o recompensados.
• dismissible: Es un valor booleano que representa si el usuario puede descartar el SKOverlay.

En el siguiente ejemplo, se muestra una respuesta de oferta:

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

Revisa el comportamiento esperado de SKOverlay

Este es el comportamiento esperado de SKOverlay correspondiente a la respuesta de oferta anterior:

• Muestra el SKOverlay cinco segundos después de que comience el video.
• Muestra el SKOverlay inmediatamente después de la tarjeta final con llamado a la acción.

• Abre la tienda de aplicaciones cuando el usuario haga clic en SKOverlay.

• Si se especifica BidResponse.seatbid.bid.ext.skadn.productpageid, los datos de la ficha de la app en SKOverlay son el ícono de la página personalizada del producto.

• En el caso de las creatividades de video de VAST, cuando un usuario hace clic en la SDKoverlay, se hace ping a las URLs de seguimiento de clics y de clics de destino.

• En el caso de las creatividades de video de VAST, incluso si un usuario descarta el SKOverlay durante el video, este se sigue mostrando después de la tarjeta final con llamado a la acción si se establece el campo BidResponse.seatbid.bid.ext.skadn.skoverlay.endcarddelay.