Ads conversion
The ads conversion analysis makes it possible to evaluate the relevance and return of the created ads. Therefore, Checkout Pro offers integration with Facebook Ads and Google Ads platforms, allowing you to associate payments with business campaigns.
Facebook Ads
When creating a preference, you can associate it with a pixel (identifier) for tracking Facebook Ads conversions. Checkout Pro's integration.
To integrate Checkout Pro with Facebook Ads, use one of the SDKs available below.
<?php
// Create a preference object
$preference = new MercadoPago\Preference();
// Associate your Facebook pixel
$preference->tracks = array(
array(
'type' => 'facebook_ad',
'values'=> array(
'pixel_id' => 'PIXEL_ID'
)
)
);
// ...
// Save and post the preference
$preference->save();
?>
Add the code in the preference and replace the pixel_id value with your identifier.
// Create a preference object
var preference = {
// Associate your Facebook pixel
tracks: [
{
type: "facebook_ad",
values: {
"pixel_id": 'PIXEL_ID'
}
}
]
//...
};
Add the code in the preference and replace the pixel_id value with your identifier.
// Create a preference object
PreferenceClient client = new PreferenceClient();
// Associate your Facebook pixel
List<PreferenceTrackRequest> tracks = new ArrayList<>();
PreferenceTrackRequest trackFacebook = PreferenceTrackRequest.builder()
.type("facebook_ad")
.values(PreferenceTrackValuesRequest.builder().pixelId("PIXEL_ID").build())
.build();
tracks.add(trackFacebook);
PreferenceRequest request = PreferenceRequest.builder().tracks(tracks).build();
Preference preference = new Preference()
.appendTrack(trackFacebook);
// Save and post the preference
client.create(request);
Add the code in the preference and replace the pixel_id value with your identifier.
// Associate your Facebook pixel
var tracks = new List<PreferenceTrackRequest>
{
new PreferenceTrackRequest
{
Type = "facebook_ad",
Values = new PreferenceTrackValuesRequest
{
PixelId = "PIXEL_ID",
},
},
};
var request = new PreferenceRequest
{
// ...
tracks = tracks,
};
var client = new PreferenceClient();
Preference preference = await client.CreateAsync(request);
Add the code in the preference and replace the pixel_id value with your identifier.
# Associate your Facebook pixel
preference_data = {
# ...
"tracks": [
{
"type": "facebook_ad",
"values": {
"pixel_id": "PIXEL_ID"
}
}
]
}
preference_response = sdk.preference().create(preference_data)
preference = preference_response["response"]
When finishing the configuration, a Purchase event will be associated with the specified pixel when a payment forwarded by your ad is approved.
track parameter with the type and values attributes informing your facebook_id and the pixel ID respectively to the
/checkout/preferences
endpoint /post) and execute the request.Google Ads
When creating a preference, you can associate it with a tag (identifier) for tracking Google Ads conversions.
To integrate Checkout Pro with Google Ads, use one of the SDKs available below.
tracks parameter with the type, conversion_id and conversion_label attributes informing your conversion_id and the conversion label available in your Google account to the endopoint
/checkout/preferences
and execute the request.Add the code to the preference and replace the CONVERSION_ID and CONVERSION_LABEL values with your tag data.
<?php
// Create a preference object
$preference = new MercadoPago\Preference();
// Associate your Google ads tag
$preference->tracks = array(
array(
'type' => 'google_ad',
'values' => array(
'conversion_id' => 'CONVERSION_ID',
'conversion_label' => 'CONVERSION_LABEL'
)
)
);
...
// Save and post the preference
$preference->save();
?>
Add the code to the preference and replace the CONVERSION_ID and CONVERSION_LABEL values with your tag data.
// Create a preference object
var preference = {
// Associate your Google ads tag
tracks: [
{
type: "google_ad",
values: {
conversion_id: "CONVERSION_ID",
conversion_label: "CONVERSION_LABEL"
}
}
]
...
};
Add the code to the preference and replace the CONVERSION_ID and CONVERSION_LABEL values with your tag data.
// Create a preference object
PreferenceClient client = new PreferenceClient();
// Associate your Google ads tag
List<PreferenceTrackRequest> tracks = new ArrayList<>();
PreferenceTrackRequest trackGoogle =
PreferenceTrackRequest.builder()
.type("google_ad")
.values(
PreferenceTrackValuesRequest.builder()
.conversionId("CONVERSION_ID")
.conversionLabel("CONVERSION_LABEL")
.build())
.build();
tracks.add(trackGoogle);
PreferenceRequest request = PreferenceRequest.builder().tracks(tracks).build();
// Save and post the preference
client.create(request);
Add the code to the preference and replace the CONVERSION_ID and CONVERSION_LABEL values with your tag data.
// Associate your Google ads tag
var tracks = new List<PreferenceTrackRequest>
{
new PreferenceTrackRequest
{
Type = "facebook_ad",
Values = new PreferenceTrackValuesRequest
{
ConversionId = "CONVERSION_ID",
ConversionLabel = "CONVERSION_LABEL",
},
},
};
var request = new PreferenceRequest
{
// ...
tracks = tracks,
};
var client = new PreferenceClient();
Preference preference = await client.CreateAsync(request);
Add the code to the preference and replace the CONVERSION_ID and CONVERSION_LABEL values with your tag data.
# Associate your Google ads tag
preference_data = {
# ...
"tracks": [
{
"type": "google_ad",
"values": {
"conversion_id": "CONVERSION_ID",
"conversion_label": "CONVERSION_LABEL"
}
}
]
}
preference_response = sdk.preference().create(preference_data)
preference = preference_response["response"]
Once setup is complete, a conversion will be associated with the specified tag when a payment forwarded by your ad is approved.
Add the code in the preference and replace the
pixel_idvalue with your identifier.