L'API Search Ads 360 Reporting precedente è stata ritirata. Ora puoi creare i report utilizzando la nuova API Search Ads 360 Reporting.
Tieni presente che i metodi get e getByCustomerId nell'API Search Ads 360 Conversion verranno ritirati nel terzo trimestre del 2025. Per continuare ad accedere ai dati sulle conversioni, devi creare un report utilizzando la risorsa conversion con la nuova API Search Ads 360 Reporting. Scopri di più qui.
Le restanti funzioni dell'API Search Ads 360 Conversion continueranno a essere supportate.
Nuova esperienza
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Il nuovo Search Ads 360 assegna nuovi ID ad account utente, campagne, gruppi di annunci,
parole chiave (criteri) e annunci. Esistono altre due modifiche al comportamento per questi ID:
-
Il nuovo Search Ads 360 assegna un ID cliente univoco a livello globale agli account amministratore, amministratore secondario e cliente, noti rispettivamente come account agenzia, inserzionista e motore.
-
Il nuovo Search Ads 360 non assegna più ID univoci a parole chiave e annunci.
L'API Conversion ora accetta i nuovi ID cliente Search Ads 360 ovunque siano accettati ID agenzia, ID inserzionista e ID account motore. Se specifichi un'API cliente, l'API
si aspetta che l'ID campagna, l'ID gruppo di annunci, l'ID parola chiave e l'ID annuncio siano nuovi ID Search Ads 360.
Quando utilizzi gli ID parola chiave o annuncio del nuovo 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 i nuovi ID Search Ads 360.
Inserisci/aggiorna conversione
Supportiamo la seguente richiesta utilizzando l'ID del nuovo Search Ads 360:
- Attribuire una conversione solo a una parola chiave
- Aggiorna la conversione specificando il valore
criterionId
(ID parola chiave) della conversione
Gli endpoint rimangono invariati. Devi fornire il nuovo ID 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, adId, se necessario.
Di seguito è riportato un 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"
}
]
}
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-05-26 UTC.
[null,null,["Ultimo aggiornamento 2025-05-26 UTC."],[[["\u003cp\u003eSearch Ads 360 is updated to assign globally unique customer IDs to manager, sub-manager, and client accounts and no longer assigns unique IDs to keywords and ads.\u003c/p\u003e\n"],["\u003cp\u003eThe Conversion API now accepts new Search Ads 360 customer IDs and expects new Search Ads 360 IDs for campaign, ad group, keyword, and ad IDs when specified.\u003c/p\u003e\n"],["\u003cp\u003eWhen using new Search Ads 360 keyword or ad IDs, the associated campaign and ad group IDs must be provided.\u003c/p\u003e\n"],["\u003cp\u003eThere's a new endpoint for listing conversions using the new Search Ads 360 IDs, requiring a client account customer ID.\u003c/p\u003e\n"],["\u003cp\u003eInserting or updating conversions supports attributing to keywords or updating existing conversions with new Search Ads 360 IDs by providing \u003ccode\u003ecustomerId\u003c/code\u003e and relevant IDs.\u003c/p\u003e\n"]]],["New Search Ads 360 assigns unique customer IDs to accounts and updates ID behavior for campaigns, ad groups, keywords, and ads. The Conversion API now accepts these new customer IDs. When a customer ID is provided, new Search Ads 360 IDs are expected for other IDs. Keyword and ad IDs require associated campaign and ad group IDs in requests. Responses will use the new IDs. There's a new endpoint for listing conversions, using the customer ID with the same parameters. Attributing or updating a conversion to a keyword is done with the customer ID.\n"],null,["# New Search Ads 360\n\nThe new Search Ads 360 assigns new IDs to user accounts, campaigns, ad groups,\nkeywords (criteria), and ads. There are two additional behavior changes for these IDs:\n\n-\n The new Search Ads 360 assigns a globally unique customer ID to manager, sub-manager,\n and client accounts, formally known as agencies, advertisers and engine accounts,\n respectively.\n\n-\n The new Search Ads 360 no longer assigns unique IDs to keywords and ads.\n\n\nThe conversion API now accepts new Search Ads 360 customer IDs wherever agency ID,\nadvertiser ID, and engine account IDs are accepted. If you specify a customer API, the API\nexpects campaign ID, ad group ID, keyword ID, and ad ID to be new Search Ads 360 IDs.\nWhen using new Search Ads 360 keyword or ad IDs, you must specify the associated\ncampaign and ad group IDs whenever your request uses a keyword or ad ID.\n\n\nWhen you use a new Search Ads 360 ID in your request, the response will also use\nthe new Search Ads 360 IDs.\n\nInsert/update conversion\n------------------------\n\nWe support the following request using the new Search Ads 360 ID:\n\n- Attribute a conversion to a keyword only\n- Update conversion with the conversion's `criterionId` (keyword ID) specified\n\n\nThe endpoints are still the same. You should provide the new Search Ads 360\nID in each conversion resource: Instead of setting `agencyId`,\n`advertiserId` and `engineAccountId`, you should provide\n`customerId`, and use the new Search Ads 360 ID in\n`campaignId`, `adGroupId`, `criterionId`,\n`adId` when necessary.\n\n\nHere is the example request of how to use the new Search Ads 360 ID to\nattribute a conversion to a keyword. \n\n```carbon\nPOST https://www.googleapis.com/doubleclicksearch/v2/conversion\n{\n \"conversion\" : [\n {\n \"customerId\": \"123-123-1234\"\n \"campaignId\": \"10000001\",\n \"adGroupId\": \"20000001\",\n \"criterionId\": \"30000001\",\n \"conversionId\": \"floodlight conversion ID 1\",\n \"conversionTimestamp\": \"1660799917714\",\n \"type\": \"ACTION\",\n \"quantityMillis\": \"1000\",\n \"segmentationType\": \"FLOODLIGHT\",\n \"segmentationName\": \"Test\"\n }\n ]\n}\n \n```"]]
