La variable "purchase-details" fournit des informations sur les produits vendus lors d'une transaction donnée. Vous pouvez l'ajouter à un extrait d'événement Floodlight, à une balise Floodlight, à la couche de données Google Tag Manager ou à une macro Google Tag Manager.
Selon la méthode choisie pour ajouter la variable, utilisez l'un des formats suivants :
-
Si vous utilisez la balise Google, mettez en forme la variable "purchase-details" en tant qu'objet JSON directement dans l'extrait d'événement Floodlight.
- Si vous utilisez une balise d'image ou iFrame Floodlight, ou si vous transmettez les données à Google Tag Manager en tant que macro, mettez en forme la variable "purchase-details" en tant que chaîne divisée en un ensemble de champs.
-
Si vous envoyez les données à la couche de données de Google Tag Manager, mettez en forme la variable en tant qu'objet JSON avec des champs détaillant les achats.
Exigences relatives au format JSON dans un extrait d'événement Floodlight
Si vous utilisez la balise Google, vous devez spécifier les détails des achats dans l'extrait d'événement sous la forme d'un tableau JSON items
, ainsi que de champs country
et language
. Chaque élément du tableau contient les champs suivants :
id
price
-
quantity
Exemple :
<!--
Event snippet for Thank You on http://www.example.com/thanks: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 11/01/2017
-->
<script>
gtag('event', 'purchase',
{
'allow_custom_scripts': true,
'send_to': 'DC-1234567/group1/thank123+transactions',
'transaction_id': '012345',
'value': 129.97,
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
],
'country': 'us',
'language': 'en'
}
);
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123;
qty=1;cost=129.97;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;
ord=012345;prd=i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2|c:us|l:en?" width="1" height="1" alt="">
</noscript>
<!-- End of event snippet: Please do not remove -->
Remarque : Les extraits d'événement générés par Search Ads 360 incluent une balise <noscript>
facultative qui contient un tag d'image Floodlight. Cette balise permet de comptabiliser les conversions dans les navigateurs qui ne sont pas compatibles avec JavaScript.
Exigences relatives au format JSON dans la couche de données
Si vous utilisez Google Tag Manager, vous devez spécifier les champs détaillant les achats sous la forme d'éléments d'un tableau JSON ecommerce.purchase.products
:
'ecommerce':{
'purchase':{
'products': [{
'id': 'String',
'price': 'Floating point',
'quantity': Integer,
'country': 'String', // Optional
'language': 'String', // Optional
'accountId': 'String' // Optional
},
{
… // Each SKU (product) in the transaction
// is in its own array item.
}]
}
}'
Notez que les noms de champs de cet objet JSON sont différents de ceux définis pour l'objet JSON que vous utilisez si vous ajoutez la variable "purchase-details" à un extrait d'événement Floodlight.
Lorsque vous transférez les détails concernant les achats dans la couche de données, vous stockez les données dans l'objet qui permet à Google Analytics de créer des rapports sur les produits achetés sur votre site. En d'autres termes, si vous générez des rapports détaillant les achats via Search Ads 360 et Google Analytics, votre développeur Web peut stocker les données des deux produits dans le même objet.
Exigences relatives au format "Chaîne"
Au format "Chaîne", chaque champ détaillant les achats doit être indiqué sous la forme d'une paire clé-valeur comme suit :
[ID de champ][index]:[valeur]
- [ID de champ] identifie le type de valeur enregistrée.
- [index] indique l'article dont la valeur est enregistrée.
- [valeur] fournit des informations sur la vente du produit.
Séparez chaque champ à l'aide d'une barre verticale (|). Exemple :
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Champs détaillant les achats
Champ |
ID au format "Chaîne" |
Type |
Obligatoire |
Description |
|
|
Chaîne |
Oui |
ID du produit qui a été vendu. Il doit correspondre à l'ID d'article de Google Merchant Center. |
|
|
Virgule flottante |
Oui |
Prix unitaire du produit vendu. N'insérez pas le symbole de devise. |
|
|
Entier |
Oui |
Nombre d'unités du produit vendues. |
|
|
Chaîne (code pays ISO 3166) |
Non |
Pays enregistré pour le flux Merchant Center contenant des données sur le produit. Ce champ n'est nécessaire que si les ID d'article sont partagés par plusieurs flux Merchant Center. N'indiquez le pays qu'une seule fois pour chaque produit (il ne s'agit pas d'un champ répété). Si le champ n'est pas spécifié, Search Ads 360 sélectionne un flux Merchant Center contenant l'ID produit et utilise ses attributs pour les dimensions "Produits vendus". |
|
|
Chaîne (code de langue ISO 639) |
Non |
Langue enregistrée pour le flux Merchant Center contenant des données sur le produit. Ce champ n'est nécessaire que si les ID d'article sont partagés par plusieurs flux Merchant Center. Si le champ n'est pas spécifié, Search Ads 360 sélectionne un flux Merchant Center contenant l'ID produit et utilise ses attributs pour les dimensions "Produits vendus". |
Caractères spéciaux et encodage des URL
Le signe deux-points :
et la barre verticale |
sont utilisés comme délimiteurs de champ dans le format "Chaîne". Search Ads 360 ne peut pas accepter les données incluant ces caractères en tant que valeurs d'un champ, même si vous utilisez l'un des formats JSON.
Comme c'est le cas avec l'ensemble des données Floodlight, les caractères suivants ne sont pas acceptés :
;
, <
, >
, ?
Supposons qu'une transaction se compose des articles suivants :
-
Article 1
- Nom : m-dress-orange-xl
- UPC : 123456755559
- Prix par article : 19,99 $
- Quantité : 1
-
Article 2
- Nom : m-polo-green-l
- UPC : 123456788889
- Prix par article : 54 $
- Quantité : 2
La variable "purchase-details" d'un extrait d'événement contient alors les champs suivants :
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
]
Voici la façon dont la variable "purchase-details" s'affiche dans une balise iFrame Floodlight :
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Outre la variable "purchase-details", l'extrait d'événement ou la balise Floodlight indique les données suivantes :
-
ID du groupe d'activité Floodlight
-
ID de l'activité Floodlight
-
ID de transaction (ID de commande)
-
Valeur totale de la transaction : 129,97 $ = (1*19,99 $ + 2*54 $)
-
Quantité : 3 (Vous pouvez définir la signification exacte de ce champ et envisager de l'utiliser pour générer un rapport sur la taille totale du panier.)
-
Toute autre variable Floodlight personnalisée
Le global site tag final et l'extrait d'événement se présentent comme suit :
<!--
Start of global snippet: Please do not remove
Place this snippet between the <head> and </head> tags on every page of your site.
-->
<!-- Google Tag (gtag.js) - DoubleClick -->
<script async src="https://www.googletagmanager.com/gtag/js?id=DC-1234567"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments)};
gtag('js', new Date());
gtag('config', 'DC-1234567');
</script>
<!-- End of global snippet: Please do not remove -->
<!--
Event snippet for Thank You on http://www.example.com/thanks: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 11/01/2017
-->
<script>
gtag('event', 'purchase',
{
'allow_custom_scripts': true,
'send_to': 'DC-1234567/group1/thank123+transactions',
'transaction_id': '012345',
'value': 129.97,
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
],
'country': 'us',
'language': 'en'
}
);
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123;
qty=1;cost=129.97;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;
ord=012345;prd=i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2|c:us|l:en?" width="1" height="1" alt="">
</noscript>
<!-- End of event snippet: Please do not remove -->
Voici un exemple de balise iFrame Floodlight comportant une variable "purchase-details" :
Vous pouvez utiliser Merchant Center pour envoyer vos produits dans plusieurs flux, chacun d'eux ciblant une langue et un pays bien précis. Par exemple, si vous vendez le même groupe de produits aux États-Unis et au Canada, vous pouvez configurer un flux avec des prix et des descriptions pour les États-Unis, un autre avec des prix en dollar canadien et des descriptions en français, et un troisième avec des prix en dollar canadien et des descriptions en anglais.
Lorsque vous soumettez des flux avec les mêmes ID produit, mais avec des langues ou des pays cibles différents, vous devez inclure les codes de pays et de langue dans la variable "purchase-details". Par exemple, le tableau items
et les champs country
et language
de l'extrait d'événement enregistrent un achat à partir du flux ciblant les Canadiens francophones.
'items': [
{ 'id': '123456788889',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456755559',
'price': '54.00',
'quantity': 2
}
],
'country': 'ca',
'language': 'fr'
Veillez à utiliser les codes de pays et de langue ISO à deux chiffres.