La nouvelle interface Search Ads 360 attribue de nouveaux ID aux comptes utilisateur, aux campagnes, aux groupes d'annonces, aux mots clés (critères) et aux annonces. Deux modifications supplémentaires ont été apportées au comportement de ces ID:
-
La nouvelle interface Search Ads 360 attribue un numéro client unique au niveau mondial aux comptes administrateur, administrateur secondaire et client. Ces derniers sont respectivement connus sous le nom d'agences, d'annonceurs et de comptes de moteur.
-
La nouvelle interface Search Ads 360 n'attribue plus d'ID uniques aux mots clés et aux annonces.
L'API de conversion accepte désormais les nouveaux numéros client Search Ads 360 partout où l'ID d'agence, la référence annonceur et les ID de compte de moteur sont acceptés. Si vous spécifiez une API client, l'API s'attend à ce que l'ID de campagne, l'ID de groupe d'annonces, l'ID de mot clé et l'ID d'annonce soient de nouveaux ID Search Ads 360. Lorsque vous utilisez des identifiants de mots clés ou d'annonces dans la nouvelle interface Search Ads 360, vous devez spécifier les ID de campagnes et de groupes d'annonces associés chaque fois que votre demande utilise un mot clé ou un identifiant d'annonce.
Si vous utilisez un nouvel ID Search Ads 360 dans votre demande, la réponse utilisera également les ID du nouvel ID Search Ads 360.
Répertorier les conversions
Il existe un nouveau point de terminaison pour la demande de liste avec un nouvel ID Search Ads 360. Vous devez indiquer un numéro client pour le compte client. Vous pouvez également spécifier l'ID de la campagne
et l'ID du groupe d'annonces à répertorier dans les paramètres de requête. Par ailleurs, les éléments endDate, rowCount, startDate et startRow sont toujours obligatoires.
Requête HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
Insérer/Mettre à jour la conversion
Nous acceptons la demande suivante qui utilise l'ID de la nouvelle interface Search Ads 360:
- Attribuer une conversion à un mot clé et à une annonce
- Attribuer une conversion à un mot clé uniquement
- Mettre à jour la conversion en spécifiant l'identifiant
criterionId(identifiant du mot clé) de la conversion
Les points de terminaison restent identiques. Vous devez fournir le nouvel ID Search Ads 360 dans chaque ressource de conversion: au lieu de définir agencyId, advertiserId et engineAccountId, vous devez indiquer customerId et utiliser le nouvel ID Search Ads 360 dans campaignId, adGroupId, criterionId et adId si nécessaire.
Voici l'exemple de requête expliquant comment utiliser l'ID de la nouvelle interface Search Ads 360 pour attribuer une conversion à un mot clé.
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
{
"conversion" : [
{
"customerId": "123-123-1234"
"campaignId": "10000001",
"adGroupId": "20000001",
"criterionId": "30000001",
"conversionId": "floodlight conversion ID 1",
"conversionTimestamp": "1660799917714",
"type": "ACTION",
"quantityMillis": "1000",
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test"
}
]
}
Spécifier la disponibilité
Vous pouvez également utiliser l'ID de la nouvelle interface Search Ads 360 dans la méthode
Conversion.updateAvailability()
. Vous devez utiliser un numéro client d'administrateur secondaire. Voici un exemple :
POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
"availabilities": [
{
"customerId": "123-123-1234"
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test",
"availabilityTimestamp": "1389348800000"
}
]
}