Activación directa en Meta - Activation Only
¿Qué es PII Activation Only (PII AO)?
PII Activation Only (PII AO) es una integración especial de datos que permite activar segmentos utilizando dispositivos PII en las SSP/DSP compatibles.
Importante: Los datos PII proporcionados no se utilizan para construir o enriquecer audiencias de Retargetly. PII Activation Only se encarga únicamente de activar los datos.
Caso de uso
PII AO le permite crear audiencias específicas y ejecutar campañas publicitarias dirigidas únicamente con sus datos, sin preocuparse por cómo integrarse con SSP/DSP ni por la utilización de sus datos para enriquecer a otros partners.
⚙️Configuración
Paso 1: Configuración Inicial
- Retargetly te proporcionará un depósito para que puedas transferir el archivo
- Al recibir el acceso, seleccione el "bucket" donde se cargarán los archivos, ya sea uno proporcionado por Retargetly
- Defina si los archivos que cargará estarán comprimidos y notifique el formato de compresión.
🚨Importante: Si utiliza un "bucket" propio, debe comunicar el equipo de Retargetly y crear dos carpetas llamadas 'meta' y 'data', cuyo funcionamiento se explicará en las siguientes secciones.
Paso 2: Licencia
Antes de cargar los datos PII, debe crear la licencia del segmento siguiendo estos pasos:
- Suba un archivo de metadatos (explicado en la siguiente sección) para crear la licencia del segmento.
Paso 3: Activación
Una vez que la licencia se haya creado con éxito, puede proceder a cargar los datos PII. Asegúrese de que los datos estén hasheados en SHA256 y cumplan con las especificaciones de cada plataforma para obtener una mejor match rate.
- Una vez que los datos de activación se coloquen en el "bucket", un proceso automatizado se encargará de enviarlos a la plataforma externa. Este proceso puede llevar varias horas o, según la carga del sistema, hasta una semana.
🚨Importante:
- Si el paso 1 ya está configurado, puede realizar los pasos 2 y 3 para crear nuevos segmentos
- Si el segmento ya ha sido licenciado, sólo se requiere el paso 3 de activación
🧾Licencia: Archivo metadata
En el paso 2 descrito anteriormente, vimos que se necesita un archivo metadata para crear la licencia de un segmento. En esta sección trataremos en detalle cómo debe ser este archivo y qué consideraciones deben tenerse para su correcto funcionamiento.
Consideraciones
- El archivo metadata debe contener solo un id de segmento.
- El archivo metadata debe contener los business ads accounts ids del partner en los que se desee licenciar segmentos.
- Los archivos metadata deben guardarse dentro de la carpeta /meta/ del bucket asignado.
- Los archivos metadata deben ser en formato ‘json’ y su contenido debe ser un json válido, respetando el formato debajo.
- Un archivo metadata puede contener solo un id de segmento para licenciar, pero sí puede tener múltiples ads accounts en los que crearlos.
- Una vez procesado, se creará un archivo con el mismo nombre que el subido por el partner pero con extensión ‘.success’ o ‘.fail’ y en su interior se podrá evaluar el resultado del mismo.
Formato metadata
Se debe respetar el siguiente formato para el nombre del archivo subido como metadata:
Template:
segment_metadata_{RequestID}_{SegmentID}_{UnixTimestamp}.json
Donde:
{RequestID} es el número de pedido seleccionado por el Partner, utilizado para auditorías o soporte.
{SegmentID} identificador interno del Partner para su segmento que desee licenciar.
{UnixTimestamp} marca de tiempo en forma unix para evitar archivos duplicados.
Ejemplo:
segment_metadata_10235_1909098_1650481120.json
Ejemplo metadata válido:
{
"segmentId":"1909098",
"segmentName":"Golf ",
"segmentDescription":"People born between the early 80s and mid 90s with an affinity for golf",
"requestId":"10253",
"numRecords":3000000,
"platforms": {
"tiktok":{
"adaccounts":[
{
"id":"213123123123"
}
]
}
}
}
Donde:
segmentId: el ID de segmento DEL CLIENTE, usado en el filename.
segmentName: el nombre de dicho segmento; este nombre será utilizado como nombre al crear el segmento relacionado en Rely.
segmentDescription: idem, pero sobre la descripción, si es que debe tener alguna.
requestId: un identificador para trackear issues; se aumenta programáticamente desde el lado del cliente al mandar el file, usado en el filename.
platforms: las plataformas a las que se quieran enviar PIIs; ahora mismo activas Facebook
adaccounts: los business account manager IDs, para licenciar en uno o más seats.
Respuesta de licenciamiento
El sig. archivo llamado “segment_metadata_10253_1909098_1650481120.json.success” es una respuesta válida de Retargetly al ingestar el archivo metadata:
{
"currentStep":8,
"totalSteps":8,
"relySegmentId":1243151,
"platformsLicensed":{
"tiktok":{
"seatIds":[
"213123123123"
]
}
},
"platformsSegments":[
{
"platformId":71,
"platformName":"tiktok",
"platformSegmentId":"175550673",
"relySegmentId":1243151
}
]
}
Donde:
currentStep: Para uso interno en auditorias
totalSteps: Para uso interno en auditorias
relySegmentId: Segmento de rely asociado al segmento de cliente
platformsLicensed: Contiene un objeto donde se enumera a qué plataforma fue licenciado dicho segmento y qué cuentas se utilizaron.
platformsSegments: Contiene un arreglo con los distintos segmentos licenciados en cada SSP/DSP, con información relevante de la plataforma como el platformSegmentId que permite ver el segmento en el business center correspondiente.
Luego d e licenciar el archivo metadata de ejemplo podemos armar la siguiente tabla que relaciona los id de segmentos según quien sea el dueño:
Id segmento del partner (usado en el filename) | Id segmento de Retargetly (usado internamente por el job) | Id de segmento en Tiktok (usado en la plataforma externa) |
1909098 | 1243151 | 175550673 |
🧾Activación: Archivo DATA PII
Luego de que se haya licenciado correctamente, es posible subir los datos PII dentro de la folder /data/, en el bucket asignado al partner, para que sean activados en los SSP/DSP externos.
Consideraciones
- El archivo data PII debe ser un archivo en formato TSV (tab separated values) y debe cumplir con el formato establecido en la sección “Formato data PII”.
- La cantidad de líneas admitidas en un archivo es de hasta 50M
- En esta primera versión no se soporta la compresión de archivos.
- En una próxima iteración de la feature, será posible subir los archivos PII comprimidos en formato .gz.
- Se pueden subir archivos a esa carpeta si previamente el segmento fue licenciado.
- Se debe usar un segmento por archivo que se desea activar.
- Los valores de PII deben cumplir las especificaciones de los SSP/DSP y estar hasheados en SHA256 antes de ser subidos a PII AO.
Formato data PII
Convención en el nombre de los archivos subidos:
Template:
/segment_pii_{RequestID}_{SegmentID}_{UnixTimestamp}.tsv
Donde:
{RequestID} es el número de pedido seleccionado por el Partner, utilizado para auditorias o soporte.
{SegmentID} identificador interno del Partner para el segmento que se desea licenciar
{UnixTimestamp} marca de tiempo en forma unix para evitar archivos duplicados
Ejemplo:
/segment_pii_10235_98989898_1650481120.tsv
Contenido del archivo
- Los archivos subidos deben seguir la convención utilizada por todo data in como se detalla aquí.
- Un archivo solo puede contener un segment id, que debe ser el mismo que figure en el nombre del archivo.
- La primera línea de cada archivo deberá tener el nombre de las columnas para que pueda ser interpretado correctamente.
- Todos los campos que contienen data PII deben ser hasheados en SHA256 y otros deben normalizarse antes de hashearlos. Estas normalizaciones dependen de cada plataforma como puede ver en la sección “Listado de SSP/DSP que soportan audiencias con data PII”.
- Algunos campos deben enviarse en combinación con otros para obtener un match rate, por ejemplo para enviar un FIRST_NAME, es necesario añadir un LAST_NAME para que tenga sentido la activación.
Listado de SSP/DSP que soportan audiencias con data PII
SSP/DSP | PII permitidos | Documentación |
Individuales:
En combinación con los anteriores:
| https://developers.facebook.com/docs/marketing-api/audiences/guides/custom-audiences/#hash |
Ejemplo PII válido:
Archivo PII “segment_pii_2_1909098_1650481120.tsv”
device_type segments first_name last_name emails phones city state zip country
pii_sh2 1909098 242262141f15cb61c5bfc513812e8c83acc04afd53ef45dc11a2ae666ce2b830 431ae70bd8a1ca4cd3eb0e04065a503b646c46643f6296975455928e44d1cf31 0587a43f82be2a6b4bed48b927e9631b2657223611ec317d0e4f8d1d9b506d60,0587a43f82be2a6b4bed48b927e9631b2657223611ec317d0e4f8d1d9b506d60,0587a43f82be2a6b4bed48b927e9631b2657223611ec317d0e4f8d1d9b506d60 479b145a2537e125aa9445f5d04c916d33d4455599d028e884050a41e686047f 9c0fbbbf31250b74a574810f54e091b4f4cf4d6252b5f30f8657aaf8cb92eb12 dbc74a36d8e7439c45c64d856388506cc9b1218619cef979c3d605115a7a4546
pii_sh2 1909098 7555ae89e0627b4158f9a95e91c58473f38b8fb176fe3a9380c1117cd68382dc fe2107e600f89accecf314a421cc4fab9b5f10a68eade6ba4ae3d728949c3be2 8f4036ad60321b85b53c86d0409cb77779cfcd56bad2f2eec8acd864a786c43d,0587a43f82be2a6b4bed48b927e9631b2657223611ec317d0e4f8d1d9b506d60 a94c3914de2dd65e8e446b98f11bb92296469e8a498f159dcc2400f58102002c befcd153e384e3d77c2612121b1c88dc9c26ba44ad977d1c728ec63c8e2d1ab0 647d52aad89259482c9345e16772e44df61ed3adc9514b9773fd0bcf2e68e2c2 c3782c86d8099f3fb5b755ebc970322567aa3894923de8c9c5fc97456133471c
pii_sh2 1909098 3a7caada000194e51fe64a772ef8b4c46859f91d45651cf11d91222ebe4dbd20 96f12b28d735c75378017acc8db6e1881cef8f6c8a8ef38666951f69b6738933 5f10e3af4b136268cd14c81f11dd929004ca7359b04452189285374c8772d592 1baf9f9764d393335b99c202c041d4180a4c92839f95f1e38471a55af6ef0982 8cf2bbca39e5b1e7a6ef51c43d5104cf2e30e056bbf291ef6139f51fa5337bc9 fc9a9a297a94bb68122e6bb98f8d1a2c82263aff5620bcd122e99927714a34b6 4d5b1e2136b9d028209ad04187ed147b8ed817e851b00a6672886a0c19cb3a95 7a1ca4ef7515f7276bae7230545829c27810c9d9e98ab2c06066bee6270d5153
pii_sh2 1909098 c10ce8e88ec2078f3c15613c22e9f869a1b59dc24a7af4a3cbd79f4ab8f9d455 9b43b8dac4a4ca206e8c3d5a41827be8e5add77762cd92dbfc35e1906ab5bf72 18147d8dfb86d1caff7190ac46c348ae885d53466ccfd84175082096b3066085 ac61f26e0602239cb1f11eaa4d0b2e28ba84e60568f2adb47f5c2b79f81ded43 605e81e83c020e49c7884893e64990aeb9a1c07bff2fe9f7d4ae1a8f9499d736 af11eb02975da3225d851e2e4bb5cd31a041e0402f1634c5b33d8e6eb15e9cc7 1c769ecb9e80202f43b5dfa8c2e8a76f1136f688292489308b07c22a66763376
pii_sh2 1909098 170b32aaa8c0d0475d6f652e20f72503d5ee3fd622049323418b6ba395ec48f0 1e3c818762f645f84c600482c674e923b2df59bab20763c22cc1c5ef4a889a32 800e70cf52bd6e1ddf348c0049ba4fab232590ca6988c2351ca146a173003d80 c3f96a3b80ef6b329f0bb8c47bd4dda9170f37b165f168a1ab00a72b4396d74d 7a498e8ae2fbd456bf5ca895b8db94fa96cc6c8a6e63ee42c1da40f6f9ec31fa 0b5580e79dfc9896dc12e7a6f73e1e178c6847140eb24d552975ffaee3c083ef c3782c86d8099f3fb5b755ebc970322567aa3894923de8c9c5fc97456133471c
pii_sh2 1909098 e482ac3aeb2d18e6e145bac7371dd820f7513f9544f961830a0ee4a0e6663600 bc98f382bb149be20a05770df4fc618cf10adb93efa8123244cb914a012e03af 4e3013055b35d560c3c6197a7bf068ba6f11266c7c9203650fe12de08f427545 d5eca9d8ac8107030b76d0aa0525d87319f5dcc76b02551d407776b4ca743d5d f80975c1cf8863a35a78aa912aa80be6177ccda0643fdd3f647b0675e2e1ac4e 10436829032f361a3de50048de41755140e581467bc1895e6c1a17f423e42d10
pii_sh2 1909098 e4f3ee065e4cf4f624d85d438124ade25744bf3c59d8567bf6ae092e11479665 77963de1398a790aaf6d9607c8cd1186656531f301d810150e6711b92ef2bd65 ca8ec926f5479a411395e214be92436d8ef5248431ba8ef70ab1bbcc2cee1d7b dde43910279f1c619cde43ab720cb1d4df299ed2d4ba802e9b7f670a7cf0d8f7 7707dda73ae0164b7e10efe8f1fe699f6db3a6e8233ad6a4a4bb6edee8c7392d 283f2a5476d976382186223566b5fe2520d9eccc889fb98dd23ecb2b8458ebe5 6b615adb1300c1161bcb58c11141164e9b762987607e7cccdcd0178f3bb13d0b
pii_sh2 1909098 86bc4e7d4f0f95e92bbab6cb4366487c8e3afbf2be71d33c34c24014f28a4dbc 8b24387c4344aae612d920fcd0bcff6971e7846c71c4b259fe351f222566bd3d 1a70f17d77af8998ebf508c7cae320da28d5c965ec7b3c6eee32b4b8d4bd90aa 0458367ed7676e093e847f8e600d622e1074be4355e661a2cdb6ba9adeff4924 0b6abde656bf1d15886655dd1b6ed2eb5fde3f573f177c15659a96167e2d6a5e dbc74a36d8e7439c45c64d856388506cc9b1218619cef979c3d605115a7a4546
pii_sh2 1909098 200828592bfd4da615b285d0bc0cd2ef50ca50ddb155f9e926d82808edd2804c bacaf824169d2e704debcebcd302514a0f224d457b9b8016824703767df0b278 5e85f297b3be1ce6ee2229a0ab9b02cce5ffe9ae574a04adae1da94f5f9b0a28 3c46fcfec27aa378a7782a0abfafefdccd2d8d06af417aa88b53cb1854f52808 79d18de239d6479769776407b3ef2c7537d0b1e1b05e0fc2079952feff64d019 10436829032f361a3de50048de41755140e581467bc1895e6c1a17f423e42d10
pii_sh2 1909098 6b1626ed6aa77f7e7d1fd12402f70a672831384d468bf738eac8aa7db51883cd 5732a3d8adbf0d41728fd30c5a59453bd036b2fa3c7793772c1ba89cc0fa2dc4 517ecc3a2ad1f15351eed4fb03b274f7a453e06feff26da5d4f0223a933f1f06 a290ee6b68e95f8d2c9f19892a054837715bfd0f94d2419a05c4b771e74c68bd f69695e0983b9718346dc2e171b6a21ed9031e7428914e209a9ae237b2eae9a7 c8510e576de1a92052f8172ab99b34cbcc2e7b18ada1a51d37870a7a9dfa7b00 c3782c86d8099f3fb5b755ebc970322567aa3894923de8c9c5fc97456133471c
Como puede verse, todos los datos PII fueron normalizados y hasheados en SHA256 antes de ser subimos al bucket en la carpeta /data/
Respuesta de activación
En la misma carpeta /data cuando el archivo es procesado, se crea un archivo terminado en “.success” o “fail”. Siguiendo el ejemplo anterior podemos ver una respuesta válida para el archivo “segment_pii_2_1909098_1650481120.tsv.success” en formato json:
{
"version":"v2",
"payload":{
"translations":{
"total":10,
"failed":{
"partial":0,
"all":0
}
},
"uniques":{
"total":10,
"pii_sh2":10
},
"uploaded":{
"total":10,
"pii_sh2":10
},
"invalid":0,
"matched":{
"total":0
},
"onboarded":{
"total":0
},
"found":{
"total":0
},
"activated":{
"total":10,
"platforms":{
"71":{
"total":10,
"pii_sh2":10
}
},
"pii_sh2":10
},
"updated":{
"total":0
},
"asdfound":{
"total":0
},
"asderrors":{
"read":0,
"put":0
},
"new":{
"total":0
},
"translated":0,
"segmentsVolume":{
},
"eventQueueSent":0
}
}
Donde los campos más importantes a interpretar para PII AO son:
Payload.uniques: Indica cantidad y tipo de dispositivos detectados por el jobpayload.invalid: Número de dispositivos inválidos detectados
payload.activated.total: Cantidad total de dispositvos activados
payload.activated.platforms: Contiene separado por id de plataforma, con la cantidad de dispositivos activados y tipo
Tener en cuenta que el jobs no válida la normalización y hasheo de datos, por lo que la calidad de los mismos es responsabilidad del partner que sube los archivos PII
🆘Resolución de problemas
Sintoma | Diagnóstico/Acciones |
Error en la licencia (archivo metadata) |
|
Archivo PII subido no es ingestado |
|
Error al ingestar el archivo PII |
|
El archivo es ingestado pero no genera volumen en la plataforma externa |
|
El archivo da error al ingestar devices de tipo android, ios, ctv o web |
|
Los segmentos que subo tienen bajo volumen |
|
🆘FAQ
¿Qué se entiende por Integración Data In?
Una integración Data In se refiere a cuando un partner proporciona sus datos a Retargetly para utilizar alguno de nuestros productos de forma programática.
¿Qué significa activar un segmento?
Activar un segmento se refiere al proceso de agregar dispositivos que cumplen con un criterio o regla a un segmento que inicialmente tiene un volumen de cero. Esto convierte el segmento en una audiencia lista para ser utilizada en una campaña de marketing.
¿Qué es un dispositivo PII?
Un dispositivo PII, del inglés "Personally Identifiable Information" (Información Personalmente Identificable), se refiere a cualquier información que puede utilizarse para identificar de manera única a una persona específica. Esto incluye datos como el nombre, dirección, número de teléfono, dirección de correo electrónico, número de seguridad social, fecha de nacimiento, entre otros. Para mantener estos datos seguros y privados, es necesario hashearlos antes de cargarlos en Retargetly para que no se pueda identificar a la persona.
