Compartir públicos personalizados entre administradores comerciales

La API del administrador comercial establece responsabilidades y roles claros cuando se accede a un público de otro negocio.

A la hora de compartir un público personalizado entre varias partes, primero se debe establecer una relación de socios entre los administradores comerciales. Esto se encuentra en la sección Partners de Business Settings del Administrador comercial. Quien comparte el público también debe confirmar que cumple con las condiciones del servicio de públicos personalizados que figuran en el Administrador comercial; consulta Facebook, Condiciones de los públicos personalizados.

Una vez entablada, la relación de intercambio permite a un negocio compartir públicos con otro administrador comercial. No obstante, los públicos pueden compartirse en una sola dirección. Esto significa que el público se comparte del Negocio 1 al Negocio 2. El Negocio 2 no podrá compartirle públicos al Negocio 1 a menos que se entable una relación de intercambio aparte del Negocio 2 al Negocio 1.

A partir de 2018, para poder compartir un público personalizado entre administradores comerciales, estos negocios deben entablar una relación de intercambio de públicos del siguiente modo. Se necesitan permisos de administrador comercial para solicitar una relación que permita compartir un público. Si dos administradores comerciales ya establecieron esta relación, un anunciante puede compartir el público directamente con el otro negocio. Consulta también Referencias, Público personalizado y Referencias, Información sobre las cuentas con las que se compartió un público personalizado.

Para crear una relación, haz esta llamada a un custom_audience_id específico:

POST {custom_audience_id}/adaccounts?adaccounts=[<ad_account_id>]&relationship_type=[<relationship_type>] 

Gestionamos una solicitud en función del estado de la relación con el otro negocio:

• Para las cuentas publicitarias que ya tienen una relación aprobada, compartimos el público directamente con ellas.
• Para las cuentas publicitarias que ya tienen una relación en curso, agregamos el identificador del público a la solicitud de modo que, cuando el negocio que recibe la solicitud la aprueba, podemos compartir el público.
• Para las cuentas publicitarias que no tienen ninguna relación, creamos un acuerdo de intercambio con el identificador del público que tiene asociado; por lo tanto, cuando el negocio aprueba la solicitud recibida, podemos compartir el público.

Facebook devuelve un objeto sharing_data para cada cuenta publicitaria incluida en la solicitud. Por ejemplo:

{  
    success: true,
    sharing_data : [
     {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "in progress"
       "errors" : []
     },
     ...
    ]
}

Las opciones y los parámetros de esta solicitud incluyen lo siguiente:

Ejemplos

Si no tienes permisos de administrador comercial e intentas compartir un público, verás un error similar al siguiente:

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "not shared"
       "errors" : [
        "You don't have permission to initiate a sharing relationship for this ad account/business"
       ]
    }
...
]

Una vez que haces una solicitud, el negocio al que le pertenece la cuenta publicitaria puede recibir una solicitud pendiente de relación para compartir público, si aún no estableció una relación contigo. El negocio puede ver este estado en su administrador comercial. En ese punto, puede aprobar o rechazar la solicitud de relación:

POST <SHARING_RELATIONSHIP_ID>?request_response=approve

Si se realiza correctamente, el negocio recibe esta respuesta:

{  
    success: bool
}

Tienes estas opciones:

Una vez que el negocio aprueba la solicitud de relación recibida, puedes compartir el público con ese negocio. Al hacer una solicitud, sharing_data se ve así:

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "shared"
       "errors" : []
    }
...
]

Si eres un administrador comercial y compartes un público con una solicitud de relación pendiente, Facebook anexa el identificador del público con la relación existente:

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "in progress"
       "errors" : []
    }
...
]

Dado que puedes especificar varias cuentas publicitarias en tu solicitud para compartir un público, los resultados de cada cuenta aparecerán en la respuesta:

[   
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "shared"
       "errors" : []
    }
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "in progress"
       "errors" : []
    }
    {         
       "ad_acct_id": "<AD_ACCOUNT_ID>"
       "audience_share_status" : "not shared"
       "errors" : [
        "You don't have permission to initiate a sharing relationship for this ad account/business"
       ]
    }
...
]

Para ver las solicitudes para compartir un público que recibió tu negocio:

GET <BUSINESS_ID>/received_audience_sharing_requests?fields=custom_audiences,initiator,recipient,relationship_type,request_status,request_type

La respuesta tendrá el siguiente aspecto:

{
    "data": [   
        {         
           "initiator": {            
               "id": "<BUSINESS_ID>",            
               "name": "business_name1"         
            }, 
            "recipient": {            
               "id": "<BUSINESS_ID>",            
               "name": "business_name2"         
            },         
            "request_status": "IN_PROGRESS",
            "relationship_type": "[<relationship_type>]",
            "id": "<SHARING_RELATIONSHIP_ID>",
            "custom_audiences": [
                {
                    "id": "<CUSTOM_AUDIENCE_ID>",
                    "name": "<CUSTOM_AUDIENCE_NAME>",
                    "share_account_name": "<ACCOUNT_NAME>",
                    "share_account_id": "<ACCOUNT_ID>"
                }
            ]     
         }
         ...
    ],
    "paging": {
        "cursors": {
            "before": "<CURSOR>",
            "after": "<CURSOR>"
        }
    }
}

Para ver las solicitudes que envió tu negocio para compartir un público con otros:

GET <BUSINESS_ID>/initiated_audience_sharing_requests?fields=custom_audiences,initiator,recipient,relationship_type,request_status,request_type

La respuesta tendrá el siguiente aspecto:

{
    "data": [
        {         
            "initiator": {            
                "id": "<BUSINESS_ID>",            
                "name": "business_name1"         
            }, 
            "recipient": {            
                "id": "<BUSINESS_ID>",            
                "name": "business_name2"         
            },         
            "request_status": "IN_PROGRESS",
            "relationship_type": "[<relationship_type>]",         
            "id": "<SHARING_RELATIONSHIP_ID>",
            "custom_audiences": [
                {
                    "id": "<CUSTOM_AUDIENCE_ID>",
                    "name": "<CUSTOM_AUDIENCE_NAME>",
                    "share_account_name": "<ACCOUNT_NAME>",
                    "share_account_id": "<ACCOUNT_ID>"
                }
            ]    
        }
        ...
    ],
    "paging": {
        "cursors": {
            "before": "<CURSOR>",
            "after": "<CURSOR>"
        }
    }
}