Die neue Search Ads 360-Version weist Nutzerkonten, Kampagnen, Anzeigengruppen, Keywords (Kriterien) und Anzeigen neue IDs zu. Es gibt zwei zusätzliche Verhaltensänderungen für diese IDs:
-
Die neue Search Ads 360-Version weist Verwaltungskonten, untergeordneten Verwaltungs- und Kundenkonten, die formell als Agenturen, Werbetreibende bzw. Engine-Konten bezeichnet werden, eine weltweit eindeutige Kundennummer zu.
-
In der neuen Search Ads 360-Version werden Keywords und Anzeigen keine eindeutigen IDs mehr zugewiesen.
Die Conversion API akzeptiert jetzt neue Search Ads 360-Kundennummern überall dort, wo Agentur-IDs, Werbetreibenden-IDs und Engine-Konto-IDs akzeptiert werden. Wenn Sie eine Kunden-API angeben, erwartet die API, dass die Kampagnen-ID, die Anzeigengruppen-ID, die Keyword-ID und die Anzeigen-ID die IDs der neuen Search Ads 360-Version sind. Wenn Sie neue Search Ads 360-Keywords oder -Anzeigen-IDs verwenden, müssen Sie die zugehörigen Kampagnen- und Anzeigengruppen-IDs angeben, wenn in Ihrer Anfrage ein Keyword oder eine Anzeigen-ID verwendet wird.
Wenn Sie in Ihrer Anfrage eine neue Search Ads 360-ID verwenden, werden auch in der Antwort die IDs der neuen Search Ads 360-Version verwendet.
Conversions auflisten
Es gibt einen neuen Endpunkt für die Listenanfrage mit der neuen Search Ads 360-ID. Geben Sie eine Kundennummer für das Kundenkonto an. Sie können auch weiterhin die Kampagnen-ID und die Anzeigengruppen-ID angeben, die in Suchparametern aufgelistet werden sollen. endDate, rowCount, startDate und startRow sind weiterhin erforderlich.
HTTP-Anfrage
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
Konvertierung einfügen/aktualisieren
Wir unterstützen die folgende Anfrage mit der neuen Search Ads 360-ID:
- Conversion einem Keyword und einer Anzeige zuordnen
- Conversion nur einem Keyword zuordnen
- Die Conversion mit der angegebenen
criterionId(Keyword-ID) der Conversion aktualisieren
Die Endpunkte sind immer noch identisch. Geben Sie die neue Search Ads 360-ID in jeder Conversion-Ressource an: Statt agencyId, advertiserId und engineAccountId festzulegen, sollten Sie customerId angeben und die neue Search Ads 360-ID bei Bedarf in campaignId, adGroupId, criterionId und adId verwenden.
Hier sehen Sie eine Beispielanfrage, wie die neue Search Ads 360-ID verwendet wird, um eine Conversion einem Keyword zuzuordnen.
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"
}
]
}
Verfügbarkeit angeben
Sie können die neue Search Ads 360-ID auch in der Methode
Conversion.updateAvailability()
verwenden. Sie müssen die Kundennummer eines untergeordneten Verwaltungskontos verwenden. Hier ein Beispiel:
POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
"availabilities": [
{
"customerId": "123-123-1234"
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test",
"availabilityTimestamp": "1389348800000"
}
]
}