Il nuovo Search Ads 360 assegna nuovi ID ad account utente, campagne, gruppi di annunci, parole chiave (criteri) e annunci. Sono state apportate ulteriori due modifiche al comportamento di questi ID:
-
Il nuovo Search Ads 360 assegna un ID cliente univoco a livello globale agli account amministratore, amministratore secondario e cliente, precedentemente noti rispettivamente come agenzie, inserzionisti e account motore.
-
Il nuovo Search Ads 360 non assegna più ID univoci a parole chiave e annunci.
L'API Conversion ora accetta gli ID cliente dei nuovi Search Ads 360 ovunque siano accettati l'ID agenzia, l'ID inserzionista e gli ID account motore. Se specifichi l'API di un cliente, l'API si aspetta che gli ID campagna, l'ID gruppo di annunci, l'ID parola chiave e l'ID annuncio siano nuovi ID Search Ads 360. Quando utilizzi ID annuncio o parole chiave nuovi di Search Ads 360, devi specificare gli ID campagna e gruppo di annunci associati ogni volta che la richiesta utilizza una parola chiave o un ID annuncio.
Quando utilizzi un nuovo ID Search Ads 360 nella richiesta, la risposta utilizzerà anche gli ID del nuovo Search Ads 360.
Elenca conversioni
È disponibile un nuovo endpoint per la richiesta di elenco con l'ID del nuovo Search Ads 360. Devi fornire un ID cliente dell'account cliente. Inoltre, puoi comunque specificare l'ID campagna e l'ID gruppo di annunci da inserire nei parametri di ricerca. Inoltre, endDate, rowCount, startDate e startRow sono ancora obbligatori.
Richiesta HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
Inserisci/aggiorna conversione
Supportiamo la seguente richiesta con l'ID del nuovo Search Ads 360:
- Attribuire una conversione a una parola chiave e a un annuncio
- Attribuire una conversione solo a una parola chiave
- Aggiorna la conversione con l'
criterionId(ID parola chiave) della conversione specificato
Gli endpoint sono sempre gli stessi. Devi fornire l'ID del nuovo Search Ads 360 in ogni risorsa di conversione. Anziché impostare agencyId, advertiserId e engineAccountId, devi fornire customerId e utilizzare il nuovo ID Search Ads 360 in campaignId, adGroupId, criterionId e adId quando necessario.
Ecco l'esempio di richiesta su come utilizzare l'ID del nuovo Search Ads 360 per attribuire una conversione a una parola chiave.
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"
}
]
}
Specifica la disponibilità
Puoi anche utilizzare l'ID del nuovo Search Ads 360 nel metodo
Conversion.updateAvailability()
. Devi utilizzare un ID cliente amministratore secondario. Ecco un esempio:
POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
"availabilities": [
{
"customerId": "123-123-1234"
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test",
"availabilityTimestamp": "1389348800000"
}
]
}