Nowa wersja Search Ads 360 przypisuje nowe identyfikatory do kont użytkowników, kampanii, grup reklam, słów kluczowych (kryteriów) i reklam. W przypadku tych identyfikatorów wprowadziliśmy 2 dodatkowe zmiany w działaniu:
-
Nowa wersja Search Ads 360 przypisuje unikalny globalnie identyfikator klienta do kont menedżera, podrzędnych kont menedżera i kont klientów, zwanych wcześniej agencjami, reklamodawcami i kontami wyszukiwarek.
-
Nowa wersja Search Ads 360 nie przypisuje już unikalnych identyfikatorów do słów kluczowych i reklam.
Interfejs API konwersji akceptuje teraz nowe identyfikatory klienta Search Ads 360 wszędzie tam, gdzie akceptowane są identyfikatory agencji, reklamodawcy i konta wyszukiwarki. Jeśli określisz interfejs API klienta, będzie on wymagał, by identyfikatory kampanii, grupy reklam, słowa kluczowego i reklamy były nowymi identyfikatorami Search Ads 360. Jeśli w nowej wersji Search Ads 360 korzystasz z identyfikatorów słów kluczowych lub reklam, za każdym razem, gdy w Twojej prośbie występuje słowo kluczowe lub identyfikator reklamy, musisz podać powiązane identyfikatory kampanii i grup reklam.
Jeśli w żądaniu użyjesz nowego identyfikatora Search Ads 360, w odpowiedzi zostaną użyte też nowe identyfikatory Search Ads 360.
Wyświetlenie listy konwersji
Istnieje nowy punkt końcowy dla żądania listy o nowym identyfikatorze w Search Ads 360. Musisz podać identyfikator klienta konta klienta. W parametrach zapytania możesz też podać identyfikatory kampanii i grupy reklam. Wymagane są też endDate, rowCount, startDate i startRow.
Żądanie HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
Wstaw/zaktualizuj konwersję
Obsługujemy te prośby z użyciem nowego identyfikatora Search Ads 360:
- Przypisywanie konwersji do słowa kluczowego i reklamy
- Przypisywanie konwersji tylko do słowa kluczowego
- Zaktualizuj konwersję z określonym identyfikatorem słowa kluczowego
criterionId
Punkty końcowe są nadal takie same. Identyfikator nowej wersji Search Ads 360 musisz podać w każdym zasobie konwersji. Zamiast ustawiać wartości agencyId, advertiserId i engineAccountId, podaj wartość customerId i w razie potrzeby użyj nowego identyfikatora Search Ads 360 w tych identyfikatorach: campaignId, adGroupId, criterionId, adId.
Oto przykładowe żądanie wykorzystania nowego identyfikatora Search Ads 360 do przypisania konwersji do słowa kluczowego.
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"
}
]
}
Określ dostępność
Możesz też użyć nowego identyfikatora Search Ads 360 w metodzie
Conversion.updateAvailability()
. Musisz użyć identyfikatora klienta podrzędnego konta menedżera. Oto przykład:
POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
"availabilities": [
{
"customerId": "123-123-1234"
"segmentationType": "FLOODLIGHT",
"segmentationName": "Test",
"availabilityTimestamp": "1389348800000"
}
]
}