Appelez la méthode Conversion.insert() pour ajouter une ou plusieurs conversions. Pour attribuer correctement la conversion, votre demande doit spécifier le nom d'une activité Floodlight utilisée par l'annonceur pour générer des rapports sur les conversions hors connexion, ainsi que l'ID du mot clé, de l'annonce et éventuellement du clic à l'origine de la conversion. Pour savoir comment obtenir des ID Search Ads 360, consultez ID et conversions Search Ads 360.
Pour en savoir plus sur les restrictions concernant l'importation de l'historique des conversions, consultez le Centre d'aide Search Ads 360.
Si votre demande Conversion.insert() spécifie plusieurs conversions, Search Ads 360 tente d'importer chaque conversion "au mieux", au lieu d'importer l'intégralité du lot en tant que transaction "tout ou rien". Si l'importation de certaines conversions d'un lot échoue, d'autres peuvent encore être importées correctement. Les importations de conversions peuvent échouer en raison d'une requête non valide, ou de défaillances temporaires du réseau ou du système. Par conséquent, nous vous recommandons de lire la réponse pour chaque conversion insérée afin de vous assurer que l'importation a réussi.
Combien de temps dois-je attendre avant de pouvoir utiliser les données importées ?
Si vous spécifiez la valeur
conversionTimestamp pour le jour ou la veille pour une conversion, les statistiques relatives à cette conversion s'affichent dans l'interface utilisateur de Search Ads 360 dans l'heure qui suit l'importation. Si vous spécifiez un conversionTimestamp antérieur à la veille, les métriques seront mises à jour après plusieurs heures.
Convertissez tous les codes temporels des conversions au format epoch (également appelé "heure Unix").
Puis-je créer des activités Floodlight à partir de l'API ?
Si l'annonceur n'a pas encore créé d'activité Floodlight pour le suivi des conversions hors connexion, vous pouvez utiliser l'API Campaign Manager pour en créer une. Vous ne pouvez pas utiliser l'API pour indiquer qu'une activité Floodlight est principalement utilisée pour les conversions hors connexion. Il s'agit d'une bonne pratique lorsque les stratégies d'enchères utilisent les données de la conversion.
Nous vous recommandons après avoir créé une activité Floodlight à l'aide de l'API, à un utilisateur Search Ads 360 de se connecter à Search Ads 360 et de modifier le paramètre de l'activité pour indiquer que la principale source de conversions est l'activité hors connexion.
Bonnes pratiques pour ajouter des conversions
Nous vous recommandons de suivre les bonnes pratiques suivantes pour ajouter des conversions:
Demandez à un utilisateur Search Ads 360 de se connecter à Search Ads 360 et de modifier les paramètres de chaque activité Floodlight que vous utilisez pour générer des rapports sur les conversions hors connexion. Ces paramètres doivent indiquer que la principale source de conversions est l'activité hors connexion. Pour savoir comment procéder, consultez le Centre d'aide Search Ads 360.
Importez les conversions dès qu'elles sont disponibles. Si vous attribuez des conversions à des visites spécifiques, attendez au moins 30 minutes avant d'importer la conversion. Il est possible que Search Ads 360 ne reconnaisse pas l'ID de clic de la visite si vous effectuez l'importation moins de 30 minutes après la visite. Dans de rares cas, vous devrez peut-être attendre jusqu'à quatre heures avant que Search Ads 360 ne reconnaisse l'ID de clic.
Assurez-vous que chaque importation contient les conversions les plus récentes. Dans une même requête d'importation, les entrées peuvent ne pas être dans l'ordre chronologique. Toutefois, une stratégie d'enchères risque de ne pas pouvoir prendre en compte des conversions plus anciennes que vous importez plus tard dans une autre demande.
Si vous attendez plus de 24 heures avant d'importer des conversions pour une activité Floodlight, envoyez un horodatage de disponibilité.
Le code temporel de disponibilité doit correspondre à l'un des éléments suivants:
- Si vous avez enregistré des conversions au cours des dernières 24 heures, mais que vous ne les avez pas encore importées, l'horodatage doit correspondre à l'heure à laquelle la dernière conversion importée s'est produite. Vous indiquez ainsi à Search Ads 360 que des conversions sont susceptibles d'avoir eu lieu au cours des dernières 24 heures, mais que vous n'avez pas encore fourni les données. Les stratégies d'enchères et les autres systèmes automatisés ne prennent en compte l'historique des performances que jusqu'à la dernière conversion importée.
- Si aucune conversion n'a eu lieu au cours des dernières 24 heures, l'horodatage doit correspondre à la date et l'heure actuelles. Cela indique à Search Ads 360 qu'aucune conversion n'a été effectuée au cours des dernières 24 heures. Les stratégies d'enchères et d'autres systèmes automatisés incluront les dernières 24 heures (une journée complète sans conversions) dans l'historique des performances.
Envoyer une requête d'insertion
Vous pouvez envoyer une requête Conversion.insert() pour effectuer l'une des opérations suivantes:
- Attribuer une conversion à une visite spécifique
- Attribuer une conversion à un mot clé uniquement
Les champs obligatoires dans une requête Conversion.insert() dépendent de l'événement ou de l'élément auquel vous attribuez la conversion. Les sections suivantes répertorient les champs obligatoires et facultatifs pour chaque événement ou élément auquel vous pouvez attribuer une conversion.
Attribuer une conversion à une visite spécifique
Lorsqu'un internaute clique sur une ou plusieurs annonces et est redirigé vers le site d'un annonceur, Search Ads 360 considère que la session utilisateur sur le site de l'annonceur est une visite.
Pour attribuer une conversion à une visite, spécifiez les éléments suivants dans votre requête Conversion.insert():
Champs obligatoires
clickId: ID de clic sensible à la casse de la visite Recherchez l'ID de clic dans les journaux Web de l'annonceur ou répertoriez les conversions, puis utilisez l'ID de clic d'une autre conversion. Search Ads 360 attribue la conversion au mot clé, à l'annonce et aux autres objets Search Ads 360 qui ont généré la visite.
Attendez au moins 30 minutes après que Search Ads 360 a généré un ID de clic pour importer les conversions. Si vous recevez le message d'erreur "ID de clic introuvable", patientez quatre heures, puis importez à nouveau les conversions. Toutes les conversions doivent être importées dans les 90 jours suivant la génération de l'ID de clic. Sinon, l'API Search Ads 360 risque de ne pas reconnaître la visite.conversionId: pour les conversions hors connexion, les annonceurs fournissent cet ID. Les annonceurs peuvent spécifier n'importe quel ID qui les intéresse. Chaque conversion d'une demande doit spécifier un identifiant unique, et la combinaison de cet ID et de l'horodatage doit être unique parmi toutes les conversions de l'annonceur. Pour les conversions en ligne, Search Ads 360 copie la propriétédsConversionIdoufloodlightOrderIddans cette propriété, en fonction des instructions Floodlight de l'annonceur.conversionTimestamp: indique la date et l'heure de la conversion. Par exemple, si la conversion a lieu le vendredi 5 août 2016 à 11:53:22, heure d'été de l'Est (GMT -4:00), spécifiez l'horodatage en millisecondes au format epoch:1470412402000.segmentationType: spécifie le type de système de conversion dans lequel vous importez la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Ce champ doit donc toujours spécifier la valeurFLOODLIGHT.segmentationName: nom de l'activité Floodlight que l'annonceur utilise pour enregistrer la conversion.Si votre annonceur contient des activités portant le même nom (cela peut se produire si les activités appartiennent à des groupes Floodlight différents), nous vous recommandons de renommer l'une des activités.
Si vous connaissez l'ID attribué par Search Ads 360 à une activité Floodlight, vous pouvez également l'indiquer dans le champ
segmentationIdau lieu d'indiquer le nom dans le champsegmentationName. Campaign Manager attribue également un ID à l'activité Floodlight, mais cet ID est différent de l'ID Search Ads 360 et ne peut pas être utilisé pour attribuer des conversions. Pour afficher l'ID Search Ads 360 d'une activité Floodlight, téléchargez un rapport sur les conversions (à partir de l'interface utilisateur Search Ads 360 ou de l'API Reporting). Si au moins une conversion a été attribuée à l'activité Floodlight au cours de la période couverte par le rapport, l'ID Search Ads 360 s'affiche dans le rapport.type: type de la conversion, c'est-à-direACTIONouTRANSACTION. Une conversion de type ACTION n'a aucune valeur monétaire, contrairement à une conversion de type TRANSACTION. Il s'agit par exemple des inscriptions à une liste de diffusion (ACTION) et des achats en ligne (TRANSACTION).Si vous spécifiez
TRANSACTION, vous devez également spécifier le champ suivant:revenueMicros: valeur monétaire de la conversion.
Champs facultatifs
quantityMillis: nombre d'éléments dans cette conversion. (par exemple, le nombre de personnes qui se sont abonnées à une newsletter par e-mail ou la quantité totale d'articles vendus). Si vous ne spécifiez pas ce champ pour les conversions ACTION, Search Ads 360 insère automatiquement la valeur1000.currencyCode: devise des revenus d'une transaction. Par défaut, les revenus sont censés être exprimés dans la devise de l'annonceur. Si vous spécifiez une autre devise, Search Ads 360 convertit les revenus spécifiés dans la devise de l'annonceur. En savoir plus
Utilisez le format alphabétique ISO 4217 (trois caractères) pour spécifier la devise.
Applicable uniquement aux conversions TRANSACTION.customMetricetcustomDimension: importe des données supplémentaires sur une conversion, telles que le pays de livraison d'un article acheté, les identifiants produit ou même la durée d'un appel téléphonique. En savoir plus sur l'importation de données pour les variables Floodlight personnaliséesdeviceType: spécifie le type d'appareil sur lequel la conversion a eu lieu. Consultez la liste des valeurs acceptées pour ce champ.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"kind": "doubleclicksearch#conversionList",
"conversion" : [{
"clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
"conversionId" : "test_20130906_04",
"conversionTimestamp" : "1378710000000",
"segmentationType" : "FLOODLIGHT",
"segmentationName" : "Test",
"type": "TRANSACTION",
"revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue
"currencyCode": "USD"
}]
}
Java
/**
* Instantiate the Doubleclicksearch service, create conversions, and upload them.
*/
public static void main(String[] args) throws Exception {
Doubleclicksearch service = getService(); // See Set Up Your Application.
// Set up a List to keep track of each conversion you create.
List<Conversion> conversions = new Vector<Conversion>();
// Add a conversion to the List.
addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
"test_" + System.currentTimeMillis(), 10000000L, 1378710000000L);
// Upload the List and handle the response.
uploadConversions(conversions, service);
}
/**
* Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes
* the segmentation name and currency. You probably wouldn't want your production code to be so brittle.
*/
private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions,
String clickId, String conversionId, Long revenue, Long timeStamp) {
Conversion conversion = new Conversion().setClickId(clickId)
.setConversionId(conversionId)
.setSegmentationType("FLOODLIGHT")
.setSegmentationName("Test")
.setType("TRANSACTION")
.setRevenueMicros(revenue)
.setCurrencyCode("USD")
.setConversionTimestamp(BigInteger.valueOf(timeStamp));
conversions.add(conversion);
return conversions;
}
/**
* Convert the List of conversions to a DS ConversionList, send an insert request to DS,
* and output the response to a file.
*/
private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service)
throws IOException {
FileOutputStream outputStream =
new FileOutputStream(new File("./", "InsertConversionsResponse.txt"));
final PrintStream printStream = new PrintStream(outputStream);
try {
// Convert the List to a ConversionList.
ConversionList conversionList = new ConversionList().setConversion(conversions);
// Insert an upload request and download the response to a file.
service.conversion().insert(conversionList).executeAndDownloadTo(printStream);
printStream.close();
} catch (GoogleJsonResponseException e) {
System.err.println("Get request was rejected.");
for (ErrorInfo error : e.getDetails().getErrors()) {
System.err.println(error.getMessage());
}
System.exit(e.getStatusCode());
}
}
Python
def insert_conversion(service):
"""Create and upload a TRANSACTION conversion that is attributed to a visit.
Args:
service: An authorized Doubleclicksearch service. See Set Up Your Application.
"""
request = service.conversion().insert(
body=
{
'conversion': [{
'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site
'conversionId': 'test_20140206_00',
'conversionTimestamp': '1378710000000',
'segmentationType': 'FLOODLIGHT',
'segmentationName': 'Test',
'type': 'TRANSACTION',
'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue
'currencyCode': 'USD'
}]
}
)
pprint.pprint(request.execute())
Attribuer une conversion à un mot clé uniquement
Si votre principal objectif est d'attribuer des conversions aux mots clés (et non de les attribuer à des annonces), vous pouvez omettre la plupart des identifiants Search Ads 360 et ne spécifier que l'identifiant du mot clé et quelques autres champs:
Champs obligatoires
criterionId: identifiant du mot clé. Pour obtenir la valeurcriterionId, ajoutez la macroTrackerIdaux URL de vos pages de destination. Pour savoir comment obtenir les identifiants des mots clés, consultez ID et conversions Search Ads 360.conversionId: pour les conversions hors connexion, les annonceurs fournissent cet ID. Les annonceurs peuvent spécifier n'importe quel ID qui les intéresse. Chaque conversion d'une demande doit spécifier un identifiant unique, et la combinaison de cet ID et de l'horodatage doit être unique parmi toutes les conversions de l'annonceur. Pour les conversions en ligne, Search Ads 360 copie la propriétédsConversionIdoufloodlightOrderIddans cette propriété, en fonction des instructions Floodlight de l'annonceur.conversionTimestamp: indique la date et l'heure de la conversion. Par exemple, si la conversion a lieu le vendredi 5 août 2016 à 11:53:22, heure d'été de l'Est (GMT -4:00), spécifiez l'horodatage en millisecondes au format epoch:1470412402000.segmentationType: spécifie le type de système de conversion dans lequel vous importez la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Ce champ doit donc toujours spécifier la valeurFLOODLIGHT.segmentationName: nom de l'activité Floodlight que l'annonceur utilise pour enregistrer la conversion.Si votre annonceur contient des activités portant le même nom (cela peut se produire si les activités appartiennent à des groupes Floodlight différents), nous vous recommandons de renommer l'une des activités.
Si vous connaissez l'ID attribué par Search Ads 360 à une activité Floodlight, vous pouvez également l'indiquer dans le champ
segmentationIdau lieu d'indiquer le nom dans le champsegmentationName. Campaign Manager attribue également un ID à l'activité Floodlight, mais cet ID est différent de l'ID Search Ads 360 et ne peut pas être utilisé pour attribuer des conversions. Pour afficher l'ID Search Ads 360 d'une activité Floodlight, téléchargez un rapport sur les conversions (à partir de l'interface utilisateur Search Ads 360 ou de l'API Reporting). Si au moins une conversion a été attribuée à l'activité Floodlight au cours de la période couverte par le rapport, l'ID Search Ads 360 s'affiche dans le rapport.type: type de la conversion, c'est-à-direACTIONouTRANSACTION. Une conversion de type ACTION n'a aucune valeur monétaire, contrairement à une conversion de type TRANSACTION. Il s'agit par exemple des inscriptions à une liste de diffusion (ACTION) et des achats en ligne (TRANSACTION).Si vous spécifiez
TRANSACTION, vous devez également spécifier le champ suivant:revenueMicros: valeur monétaire de la conversion.
Champs facultatifs
quantityMillis: nombre d'éléments dans cette conversion. (par exemple, le nombre de personnes qui se sont abonnées à une newsletter par e-mail ou la quantité totale d'articles vendus). Si vous ne spécifiez pas ce champ pour les conversions ACTION, Search Ads 360 insère automatiquement la valeur1000.currencyCode: devise des revenus d'une transaction. Par défaut, les revenus sont censés être exprimés dans la devise de l'annonceur. Si vous spécifiez une autre devise, Search Ads 360 convertit les revenus spécifiés dans la devise de l'annonceur. En savoir plus
Utilisez le format alphabétique ISO 4217 (trois caractères) pour spécifier la devise.
Applicable uniquement aux conversions TRANSACTION.customMetricetcustomDimension: importe des données supplémentaires sur une conversion, telles que le pays de livraison d'un article acheté, les identifiants produit ou même la durée d'un appel téléphonique. En savoir plus sur l'importation de données pour les variables Floodlight personnaliséesdeviceType: spécifie le type d'appareil sur lequel la conversion a eu lieu. Consultez la liste des valeurs acceptées pour ce champ.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"kind": "doubleclicksearch#conversionList",
"conversion" : [{
"criterionId": "43700003491981017", // Replace with your ID
"conversionId": "customerTransaction73126",
"conversionTimestamp": "1351196386000",
"segmentationType": "FLOODLIGHT",
"segmentationName": "Offline Purchase",
"type": "TRANSACTION",
"revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
"currencyCode": "USD"
}]
}
Java
/** * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>. * The example in the preceding section contains the uploadConversions method, * which can submit the list as an insert() request. */ private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCriterionId(criterionId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; }
Python
def insert_conversion(service):
"""Create and upload a TRANSACTION conversion that is attributed to a keyword only.
Args:
service: An authorized Doubleclicksearch service. See Set Up Your Application.
"""
request = service.conversion().insert(
body=
{
'conversion': [{
'criterionId': '43700004289911004', // Replace with your ID
'conversionId': 'test_1378710000000',
'conversionTimestamp': '1378710000000',
'segmentationType': 'FLOODLIGHT',
'segmentationName': 'Test',
'type': 'TRANSACTION',
'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue
'currencyCode': 'USD'
}]
}
)
pprint.pprint(request.execute())
Importer des données à partir d'un modèle d'attribution tiers
Un modèle d'attribution répartit le crédit d'une conversion entre toutes les activités d'un chemin de conversion. Par exemple, si un consommateur clique sur une annonce associée à un lien commercial, une annonce display et une autre annonce associée à un lien commercial avant d'effectuer une conversion, un modèle d'attribution linéaire attribue à chaque clic 33% du crédit de la conversion.
Bien que Search Ads 360 propose des modèles d'attribution, si vous utilisez un service tiers ou un service que vous avez développé pour répartir le crédit aux clics, vous pouvez importer les données d'attribution tierces dans Search Ads 360, et les utiliser dans des rapports et des stratégies d'enchères Search Ads 360.
Avant de commencer
Créez un modèle d'attribution personnalisé dans Campaign Manager, puis importez-le dans Search Ads 360. Vous lui attribuerez le nom Modèle d'attribution externe. Les fonctionnalités Search Ads 360 peuvent ainsi détecter qu'un modèle d'attribution a été appliqué aux données de conversion que vous importez. En savoir plus
Champs obligatoires
Pour appliquer un modèle d'attribution tiers à une conversion, spécifiez tous les éléments suivants dans votre requête Conversion.insert():
clickId: ID de clic sensible à la casse de la visite Recherchez l'ID de clic dans les journaux Web de l'annonceur ou répertoriez les conversions, puis utilisez l'ID de clic d'une autre conversion. Search Ads 360 attribue la conversion au mot clé, à l'annonce et aux autres objets Search Ads 360 qui ont généré la visite.
Attendez au moins 30 minutes après que Search Ads 360 a généré un ID de clic avant d'importer une conversion avec cet ID. Sinon, l'API Search Ads 360 risque de ne pas reconnaître la visite.attributionModel: défini sur External Attribution Model. En savoir pluscountMillis: montant du crédit de la conversion à répartir pour ce clic. Applicable uniquement si la requête inclut également le champattributionModel.Ne le confondez pas avec
quantityMillis, un champ facultatif qui spécifie le nombre d'articles dans une conversion (par exemple, le nombre d'articles dans un panier acheté).conversionId: pour les conversions hors connexion, les annonceurs fournissent cet ID. Les annonceurs peuvent spécifier n'importe quel ID qui les intéresse. Chaque conversion d'une demande doit spécifier un identifiant unique, et la combinaison de cet ID et de l'horodatage doit être unique parmi toutes les conversions de l'annonceur. Pour les conversions en ligne, Search Ads 360 copie la propriétédsConversionIdoufloodlightOrderIddans cette propriété, en fonction des instructions Floodlight de l'annonceur.conversionTimestamp: indique la date et l'heure de la conversion. Par exemple, si la conversion a lieu le vendredi 5 août 2016 à 11:53:22, heure d'été de l'Est (GMT -4:00), spécifiez l'horodatage en millisecondes au format epoch:1470412402000.segmentationType: spécifie le type de système de conversion dans lequel vous importez la conversion. Actuellement, seules les conversions Floodlight sont acceptées. Ce champ doit donc toujours spécifier la valeurFLOODLIGHT.segmentationName: nom de l'activité Floodlight que l'annonceur utilise pour enregistrer la conversion.Si votre annonceur contient des activités portant le même nom (cela peut se produire si les activités appartiennent à des groupes Floodlight différents), nous vous recommandons de renommer l'une des activités.
Si vous connaissez l'ID attribué par Search Ads 360 à une activité Floodlight, vous pouvez également l'indiquer dans le champ
segmentationIdau lieu d'indiquer le nom dans le champsegmentationName. Campaign Manager attribue également un ID à l'activité Floodlight, mais cet ID est différent de l'ID Search Ads 360 et ne peut pas être utilisé pour attribuer des conversions. Pour afficher l'ID Search Ads 360 d'une activité Floodlight, téléchargez un rapport sur les conversions (à partir de l'interface utilisateur Search Ads 360 ou de l'API Reporting). Si au moins une conversion a été attribuée à l'activité Floodlight au cours de la période couverte par le rapport, l'ID Search Ads 360 s'affiche dans le rapport.type: type de la conversion, c'est-à-direACTIONouTRANSACTION. Une conversion de type ACTION n'a aucune valeur monétaire, contrairement à une conversion de type TRANSACTION. Il s'agit par exemple des inscriptions à une liste de diffusion (ACTION) et des achats en ligne (TRANSACTION).Si vous spécifiez
TRANSACTION, vous devez également spécifier le champ suivant:revenueMicros: valeur monétaire de la conversion.
Si vous suivez les revenus issus des conversions, assurez-vous que votre modèle répartit les revenus entre chaque point de contact d'un chemin de conversion.Par exemple, si votre modèle utilise une approche linéaire (en répartissant équitablement les revenus entre chaque point de contact), dans un chemin de conversion comprenant trois clics sur une annonce, chaque clic se verra attribuer 33% de la conversion. Si la conversion a généré 100 € de revenus, assurez-vous que votre modèle répartit 33 € de revenus par clic et vérifiez que revenueMicros n'indique que 33 $ de revenus pour chaque clic.
Champs facultatifs
quantityMillis: nombre d'éléments dans cette conversion. (par exemple, le nombre de personnes qui se sont abonnées à une newsletter par e-mail ou la quantité totale d'articles vendus). Si vous ne spécifiez pas ce champ pour les conversions ACTION, Search Ads 360 insère automatiquement la valeur1000.currencyCode: devise des revenus d'une transaction. Par défaut, les revenus sont censés être exprimés dans la devise de l'annonceur. Si vous spécifiez une autre devise, Search Ads 360 convertit les revenus spécifiés dans la devise de l'annonceur. En savoir plus
Utilisez le format alphabétique ISO 4217 (trois caractères) pour spécifier la devise.
Applicable uniquement aux conversions TRANSACTION.customMetricetcustomDimension: importe des données supplémentaires sur une conversion, telles que le pays de livraison d'un article acheté, les identifiants produit ou même la durée d'un appel téléphonique. En savoir plus sur l'importation de données pour les variables Floodlight personnaliséesdeviceType: spécifie le type d'appareil sur lequel la conversion a eu lieu. Consultez la liste des valeurs acceptées pour ce champ.
Exemple
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"kind": "doubleclicksearch#conversionList",
"conversion" : [{
"clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site
"conversionId" : "test_20130906_04",
"conversionTimestamp" : "1378710000000",
"segmentationType" : "FLOODLIGHT",
"segmentationName" : "Test",
"type": "TRANSACTION",
"attributionModel": "External Attribution Model",
"countMillis": "330",
"revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue
"currencyCode": "USD"
}]
}
Gérer les réponses Search Ads 360
La réponse de Search Ads 360 indique une réussite uniquement si toutes les conversions de la demande ont été validées et importées.
Si la requête aboutit
Si la demande aboutit, la réponse inclut la représentation interne Search Ads 360 complète de chaque conversion importée, telle que l'ID de campagne, l'ID du groupe d'annonces et l'ID du mot clé (critère).
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"agencyId": "12300000000000456",
"advertiserId": "45600000000010291",
"engineAccountId": "700000000042441",
"campaignId": "71700000002044839",
"adGroupId": "58700000032026064",
"criterionId": "43700004289911004",
"adId": "0",
"dsConversionId": "48719131694768384",
"conversionId": "test_1383157331951",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "20000000",
"currencyCode": "USD",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001464141",
"segmentationName": "Test",
"conversionTimestamp": "1378710000000",
"conversionModifiedTimestamp": "1383157332368"
},
...
]
}
Si la requête échoue
Si la validation ou l'importation d'une ou plusieurs conversions échoue, la réponse inclut un message pour chaque importation de conversions ayant échoué. La réponse ne contient pas de messages concernant les conversions qui ont bien été importées.
Voici un exemple de réponse à une requête qui n'aboutit pas:
{
"error": {
"errors": [
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
},
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x00000101: Click ID ..."
}
]
}
}
Chaque message d'échec contient deux champs importants: un motif et un message d'erreur détaillé. Le champ de motif peut contenir requestValidation, internalError, transactionFailed ou lateStageRequestError.
Erreurs requestValidation
Les erreurs requestValidation indiquent des problèmes de données dans la demande d'importation des conversions (la conversion a déjà été importée ou l'ID de clic est introuvable, par exemple). Dans ce type d'erreur, le message details contient deux éléments:
- Code hexadécimal qui identifie le type d'erreur. Vous pouvez utiliser le code dans vos propres scripts afin d'identifier les erreurs.
- Description de l'erreur de validation.
Pour en savoir plus, consultez la liste des codes et des descriptions que Search Ads 360 peut renvoyer en cas d'erreurs d'importation de conversions.
Autres types de problèmes
Tous les autres types d'erreurs (internalError, transactionFailed ou lateStageRequestError) indiquent qu'il existe un problème interne dans Search Ads 360.
Répondre à une erreur
Si la requête échoue, essayez de renvoyer la totalité de l'appel de requête ultérieurement. Search Ads 360 signale les erreurs requestValidation pour toutes les conversions déjà importées, mais tente d'importer les conversions restantes.
Si des erreurs s'affichent toujours après le renvoi, consultez la section Dépannage pour savoir comment procéder.