Se usó la API de Cloud Translation para traducir esta página.

Cómo subir los IDs de anuncios a las listas de usuarios

Puedes usar la API de Bulk Uploader para agregar y quitar IDs de anuncios de Authorized Buyers listas de usuarios para la segmentación.

Este es un ejemplo de URL de la API de HTTPS Bulk Uploader:

https://cm.g.doubleclick.net/upload?nid={GoogleNetworkId}

El extremo acepta solicitudes POST HTTPS.

El valor de GoogleNetworkId debe ser tu ID de red de concordancia de cookies (NID) que identifica de forma exclusiva tu cuenta para la Carga masiva y Concordancia de Cookies.

La carga útil de la solicitud POST HTTPS es una búfer de protocolo que describe las listas que se modificarán. Consulta el esquema del servicio de Carga masiva en cookie-bulk-upload-proto.txt. La carga útil de cada se limita a 100 KB.

Si quieres obtener más información para compilar y usar cookie-bulk-upload.proto para para serializar y analizar mensajes, consulta el instructivo idioma.

Puedes subir los siguientes tipos de identificadores:

ID de usuario de Google
ID proporcionado por el socio
IDFA de iOS
ID de publicidad de Android
ID de Roku
ID de Amazon Fire TV
ID de Xbox o Microsoft

Subir los IDs de usuario de Google

Los IDs de usuario de Google son IDs encriptados del dominio doubleclick.net.

A continuación, te mostramos cómo subir un ID de usuario de Google:

Configura la Concordancia de cookies con Google y aloja la de coincidencias exactas.
Utiliza la tabla de coincidencias para convertir los IDs de usuario en IDs de usuario de Google.
Subir los IDs de usuario de Google a la lista de usuarios

Por ejemplo, supongamos que recibes lo siguiente durante la coincidencia de cookies:

https://ad.network.com/pixel?google_gid=CAESEHIV8HXNp0pFdHgi2rElMfk&google_cver=1

El parámetro google_gid es el ID de usuario de Google encriptado.

Para agregarla a una lista de usuarios, cópiala en el cuerpo UpdateUsersDataRequest:

ops {
  user_id: "CAESEHIV8HXNp0pFdHgi2rElMfk"
  user_list_id: 111
  delete: false
  user_id_type: GOOGLE_USER_ID
}

Subir los IDs proporcionados por los socios

Los IDs que proporcionan los socios son IDs que pertenecen al dominio propio del socio. Aquí te indicamos cómo sube un ID proporcionado por el socio:

Configurar la concordancia de cookies con Google y permitir Google alojará tu tabla de coincidencias.
Sube los IDs que proporcionó el socio a la lista de usuarios.

Por ejemplo, si tienes un ID de usuario para tu dominio configurado como 123456, puedes y la completará en la tabla de coincidencias alojada de Google con la concordancia de cookies. Afinidad incluyen una etiqueta segura para la Web versión codificada en base64 de El ID asignado al parámetro google_hm, como el siguiente:
```
https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=MTIzNDU2&google_cm
```

Luego, puedes subir el ID proporcionado por el socio a una lista de usuarios con UpdateUsersDataRequest:

ops {
 user_id: "123456"
 user_list_id: 123
 delete: false
 user_id_type: PARTNER_PROVIDED_ID
}

Luego, Google traduce la lista de usuarios de los IDs proporcionados por socios a Google de usuarios nuevos y los agrega a tu lista de usuarios.

Sube un IDFA o un ID de publicidad de Android

También puedes subir IDs de dispositivos.

Sube el ID del dispositivo con UpdateUsersDataRequest:

ops {
 user_id: "2024D65F-EBBD-11FF-23AB-823FC255913A"
 user_list_id: 111
 delete: false
 user_id_type: IDFA
}

Luego, Google traduce la lista de usuarios de los IDs de dispositivo a los IDs de usuario de Google. agrega los IDs a tu lista de usuarios.

Flujo de trabajo

Todos los ejemplos de solicitudes y respuestas de la Carga masiva están escritas en Texto Formato. Tienes que enviar como mensajes de búfer de protocolo serializados al extremo de la API de Uploader.

Por ejemplo, para subir un IDFA y un ID proporcionado por el socio a la lista de usuarios 123, haz lo siguiente: Crea un UpdateUsersDataRequest:

ops {
  user_id: "2024D65F-EBBD-11FF-23AB-823FC255913A"
  user_list_id: 123
  delete: false
  user_id_type: IDFA
}
ops {
  user_id: "1234567"
  user_list_id: 123
  delete: false
  user_id_type: PARTNER_PROVIDED_ID
}
# See warning before use. Requires affirmative end-user consent.
process_consent: true

Luego, envía una solicitud HTTPS POST con el objeto UpdateUsersDataRequest serializado. mensaje como carga útil.

Si todas las operaciones se realizan de forma correcta, obtendrás lo siguiente: UpdateUsersDataResponse:

status: NO_ERROR

Si algunas de las operaciones se realizaron con éxito, la respuesta incluirá un UpdateUsersDataResponse con un error por cada operación con errores:

status: PARTIAL_SUCCESS
errors {
  user_id: "1234567"
  error_code: UNKNOWN_ID
  user_id_type: PARTNER_PROVIDED_ID
}

Si ninguna de las operaciones tuvo éxito, la respuesta incluirá un UpdateUsersDataResponse con status configurado como BAD_COOKIE:

status: BAD_COOKIE

Ejemplo

Este es un ejemplo de secuencia de comandos de Python que demuestra cómo puedes usar la biblioteca generado por cookie-bulk-upload.proto para propagar un Lista de usuarios con un ID determinado mediante el servicio de carga masiva:

  #!/usr/bin/python
#
# Copyright 2023 Google Inc. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""A sample demonstrating usage of the Authorized Buyers Bulk Upload service.

Successfully running this example will add the provided ID to the given user
list. To learn more about the bulk uploader service, see:
https://developers.google.com/authorized-buyers/rtb/bulk-uploader
"""


import argparse

import gen.cookie_bulk_upload_pb2

import requests


BULK_UPLOAD_ENDPOINT_TEMPLATE = 'https://cm.g.doubleclick.net/upload?nid=%s'


def main(account_nid, user_list_id, user_id, user_id_type):
    # Build the bulk upload request.
    update_request = gen.cookie_bulk_upload_pb2.UpdateUsersDataRequest()
    update_request.send_notifications = True

    ops = update_request.ops
    op = ops.add()
    op.user_list_id = user_list_id
    op.user_id = user_id
    op.user_id_type = user_id_type

    user_id_type_value = gen.cookie_bulk_upload_pb2.UserIdType.Name(
        user_id_type)

    print(f'For NID "{account_nid}", adding user ID "{user_id}" of type '
          f'"{user_id_type_value}" to user list ID "{user_list_id}"')

    # Execute the bulk upload request.
    response = requests.post(BULK_UPLOAD_ENDPOINT_TEMPLATE % account_nid,
                             data=update_request.SerializeToString())

    # Parse and display the response.
    update_response = gen.cookie_bulk_upload_pb2.UpdateUsersDataResponse()
    update_response.ParseFromString(response.content)

    print('Operation completed with the following:')
    print(f'\tHTTP Status code: {response.status_code}')
    status_value = gen.cookie_bulk_upload_pb2.ErrorCode.Name(
        update_response.status)
    print(f'\tUpdateUsersDataResponse.status: {status_value}')
    print(f'\tUpdateUsersDataResponse.errors: {update_response.errors}')
    print('\tUpdateUsersDataResponse.notifications: '
          f'{update_response.notifications}')
    n_status_value = gen.cookie_bulk_upload_pb2.NotificationStatus.Name(
        update_response.notification_status)
    print(f'\tUpdateUsersDataResponse.notification_status: {n_status_value}')


if __name__ == '__main__':
    parser = argparse.ArgumentParser(
        description=('A sample demonstrating usage of the Authorized Buyers '
                     'bulk uploader service.'))
    parser.add_argument('-n', '--account_nid',
                        required=True, help='The Account NID.')
    parser.add_argument('-u', '--user_id',
                        required=True, help='The User ID to be added.')
    parser.add_argument('-l', '--user_list_id', type=int, required=True,
                        help='The user list that the ID is being added to.')
    parser.add_argument('-t', '--user_id_type', type=int, required=True,
                        help=('The type of user ID being added. See '
                              '"UserIdType" enum for more details.'))
    args = parser.parse_args()

    main(args.account_nid, args.user_list_id, args.user_id, args.user_id_type)

Procesar consentimiento en la solicitud de carga masiva

Los socios que utilizan la API de Bulk Upload deben indicar que cuentan con la base jurídica para compartir datos del usuario con Google para la carga masiva mediante el parámetro process_consent. Este requisito se aplica a todas las cargas masivas. solicitudes.

Para los datos del usuario que requieren el consentimiento del usuario final según lo exige la UE de Google Política de Consentimiento de Usuarios (consulta https://www.google.com/about/company/user-consent-policy/) o por otras legislaciones locales, los socios deben obtener el consentimiento del usuario final y se indica el consentimiento recopilado estableciendo process_consent=True.

En el caso de los datos del usuario que no están sujetos a los requisitos de consentimiento del usuario final, los socios deben indicar que el consentimiento requeridos mediante la configuración de process_consent=True.

Las solicitudes en las que falta process_consent se filtrarán y se mostrarán el siguiente error:

status: MISSING_CONSENT_WILL_BE_DROPPED

Las solicitudes en las que process_consent esté configurado como false se filtrarán y devuelve el siguiente error:

status: MISSING_CONSENT