Wersja 17 (5.06.2024)
W wersji 17 dodaliśmy poniższe funkcje i zmiany.
Reklamy
- Usunięto pozycję
AdService.getAd
. Dzięki temuAdService
spójnie z innymi usługami w interfejsie Google Ads API. Zalecany sposób pobierania reklam i innych typów zasobów znajdziesz w artykule Pobieranie obiektów. - Dodaliśmy więcej weryfikacji wymiarów i formatu w polu
ImageAdInfo.image_asset
. W przypadku nieprawidłowego działania obrazu mogą pojawić się te błędy:
Komponenty
- Dodano nową wyliczenie:
ClickType.AD_IMAGE
- Dodaliśmy nowe raporty z nowymi danymi dotyczącymi kampanii Performance Max i kampanii w sieci wyszukiwania:
Odbiorcy,
Zadania wsadowe
- Dodano obiekt
BatchJobError.REQUEST_TOO_LARGE
, który jest wysyłany, gdy przesłana wartośćAddBatchJobOperationsRequest
przekracza 10 484 504 bajty. - Dodano obsługę ustawienia
MutateOperation.asset_group_operation
podczas korzystania zBatchJobService
. Dzięki temu możesz korzystać z przetwarzania zbiorczego do tworzenia całych kampanii Performance Max i zarządzania nimi. Zapoznaj się z naszym nowym specjalnym przewodnikiem.
Kampanie
- Zmieniliśmy nazwę kampanii Discovery na kampanie generujące popyt we wszystkich polach, wyliczeniach i błędach we wszystkich zasobach w interfejsie Google Ads API, takich jak kampanie, reklamy i komponenty. Na przykład
AdvertisingChannelType.DISCOVERY
to terazAdvertisingChannelType.DEMAND_GEN
. - Dodano parametr
Campaign.keyword_match_type
, aby umożliwić ustawianie typu dopasowania wszystkich słów kluczowych w kampanii.
Konwersje
- W przypadku konwersji SKAdNetwork
- Nazwa
segments.sk_ad_network_conversion_value
została zmieniona nasegments.sk_ad_network_fine_conversion_value
. - Dodano:
segments.sk_ad_network_redistributed_fine_conversion_value
.
- Nazwa
- Te dane są teraz zwracane w odpowiedzi nawet wtedy, gdy ich wartość wynosi 0. Dzięki temu są one spójne z innymi danymi.
Kryteria
- Dodano do tych pól w polu
AdGroupCriterion
, aby wskazać, czy kryterium w grupie reklam wyświetla reklamy lub dlaczego tak się nie dzieje:primary_status
primary_status_reasons
- Dodano obsługę
metrics.search_impression_share
dlagender_view
- Dodano obsługę
metrics.phone_calls
dlakeyword_view
Usługi Lokalne
- Dodano obiekt
LocalServicesLeadService.AppendLeadConversation()
służący do dołączania doLocalServicesLead
nowego adresuLocalServicesLeadConversation
, który wysyła wiadomości do użytkowników odpowiednimi kanałami, np. SMS-ami, w zależności od tego, jak utworzono kontakt do potencjalnego klienta.AppendLeadConversationRequest.conversations
może mieć maksymalnie 1000.- W
Conversation.local_services_lead
można określić tylkoLocalServicesLead
z wartościąlead_type
ustawioną naLeadType.MESSAGE
.
- Do tabeli
ConversationType
dodaliśmy nowe wartości wyliczeniowe:WHATSAPP
– reprezentuje rozmowę wprowadzoną na WhatsAppie.ADS_API
– reprezentuje rozmowę wprowadzoną za pomocą nowej metodyLocalServicesLeadService.AppendLeadConversation()
.
- Do
local_services_verification_artifact
dodano te nowe pola:local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
local_services_verification_artifact.license_verification_artifact.expiration_date_time
Zdawanie relacji
- Podczas wykonywania zapytań dotyczących
product_link
możesz teraz wybrać tylko pola powiązane z jedną połączoną usługą. Wybranie wielu pól kilku połączonych usług spowoduje zgłoszenieQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
. Na przykład w tym samym zapytaniu nie można wybrać parametrówproduct_link.advertising_partner.customer
iproduct_link.data_partner.data_partner_id
. - Przekazywanie parametru
page_size
do funkcjiGoogleAdsService.Search
spowoduje błądRequestError.PAGE_SIZE_NOT_SUPPORTED
.
kampania produktowa.
- Dodaliśmy nowy raport
shopping_product
, który odpowiada stronie Produkty w interfejsie Google Ads. Umożliwia ono zwracanie danych związanych z bieżącym stanem produktów z kont Google Merchant Center połączonych z kontem Google Ads.- Możesz filtrować dane z raportu
shopping_product
za pomocą parametrusegments.date
, jeśli korzystasz zGoogleAdsService.Search
lubGoogleAdsService.SearchStream
. Podział na segmenty według daty jest niedozwolony i zwraca błądShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Możesz filtrować dane z raportu
Ujednolicone cele
- Dodano element
UserListCustomerTypeService.MutateUserListCustomerTypes()
do konfigurowania typów klientów na listach odbiorców. - Usunięto pozycję
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
. Aby skonfigurować ustawienia odbiorców na potrzeby celów związanych z cyklem życia klienta, użyj właściwościUserListCustomerTypeService.MutateUserListCustomerTypes()
.- Dołącz lub odłącz listę użytkowników za pomocą ustawienia
UserListCustomerType.customer_type_category
naUserListCustomerTypeCategory.PURCHASERS
, aby uwzględnić ją odpowiednio w definicji obecnego klienta lub z niej wykluczyć na potrzeby celów związanych z cyklem życia klienta. Więcej informacji znajdziesz w artykule Podział odbiorców na segmenty.
- Dołącz lub odłącz listę użytkowników za pomocą ustawienia
Filmy
- Do narzędzia
ContentLabelType
dodaliśmy poniższe wartości. Możesz wykluczyć teContentLabelTypes
na poziomie klienta:BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
BRAND_SUITABILITY_GAMES_FIGHTING
BRAND_SUITABILITY_GAMES_MATURE
BRAND_SUITABILITY_HEALTH_SENSITIVE
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
BRAND_SUITABILITY_NEWS_RECENT
BRAND_SUITABILITY_NEWS_SENSITIVE
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
BRAND_SUITABILITY_POLITICS
BRAND_SUITABILITY_RELIGION
- Dodano
AdVideoAsset.ad_video_asset_info
, aby obsługiwać preferencje zasobów wideo podczas tworzeniaDemandGenVideoResponsiveAdInfo
. - (Tylko konta z listy dozwolonych) Zmienione
Campaign.video_brand_safety_suitability
.
Wersja 16.1.0 (24.04.2024)
W wersji 16.1 dodaliśmy poniższe funkcje i zmiany.
Zarządzanie kontem
CustomerNegativeCriterion.ip_block
, który obsługuje dodawanie adresu IP jako kryterium wykluczającego na poziomie klienta.- Nowa wartość enum:
ProductLinkError.LINK_EXISTS
. - Nowa wartość enum:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
Komponenty
- Obsługa komponentów związanych z kampaniami generującymi popyt w kampaniach
ad_group_ad_asset_view
iasset_field_type_view
. - Nowa wartość enum:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
Odbiorcy,
- Nowa wartość enum:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
, która ogranicza do 1000 podobnych list użytkowników, które może mieć klient.
Kampanie
- Możliwość otrzymywania symulacji stawek w kampanii ze strategią Docelowy ROAS w kampaniach promujących aplikacje za pomocą raportu
campaign_simulation
. - Nowa wartość enum:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
. - Nowa wartość enum:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
. - Nowa wartość enum:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
.
Konwersje
SkAdNetworkConversionValueSchema.postback_mappings
, która obsługuje funkcje SKAdNetwork 4.0.- Dodano obsługę ostrzeżeń dotyczących
CustomerSkAdNetworkConversionValueSchemaService
jakoMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. Jeśli zasada ma wartośćtrue
, wszystkie nieblokujące błędy związane z niepowodzeniami operacji są zwracane jakoMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
. - Nowe wartości enum w
CustomerSkAdNetworkConversionValueSchemaError
:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
Kryteria
- Nowe pola w
BrandInfo
:display_name
primary_url
rejection_reason
status
- Nowa enum:
BrandRequestRejectionReason
. - Nowa wartość enum:
CriterionType.LIFE_EVENT
.
Eksperymenty
- Nowa wartość enum:
ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT
.
Usługi Lokalne
local_services_lead.credit_details.credit_state
ilocal_services_lead.credit_details.credit_state_last_update_date_time
, które zwracają odpowiednio stan kredytu i sygnaturę czasową po zaktualizowaniu stanu kredytu.local_services_lead_conversation.message_details.attachment_urls
, które zwraca adresy URL, których można użyć do pobrania zawartości załącznika.
Filmy
customer.video_brand_safety_suitability
orazBrandSafetySuitability
, które ułatwiają pobieranie treści odpowiednich dla bezpieczeństwa marki filmów na poziomie klienta.- Nowa wartość enum:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
Wersja 16 (21.02.2024)
W wersji 16 dodaliśmy poniższe funkcje i zmiany.
Zarządzanie kontem
- Element
advertising_partner
został przeniesiony zAccountLink
doProductLink
iProductLinkInvitation
. - Usunięto
data_partner
igoogle_ads
zAccountLink
. - Do zarządzania weryfikacją reklamodawcy dodano
IdentityVerificationService
.StartIdentityVerification()
służy do rozpoczęcia sesji weryfikacyjnej przy użyciu podanegoverification_program
. Utworzy nową sesję weryfikacji i zwraca pustą odpowiedź dla pomyślnej weryfikacji.GetIdentityVerification()
może być używany do pobierania informacji weryfikacyjnych, które zwraca kilka obiektówIdentityVerification
. Każdy elementIdentityVerification
obejmuje:verification_program
– typ programu weryfikacji tożsamości.identity_verification_requirement
, która zawiera szczegółowe informacje dotyczące terminu, do którego reklamodawca powinien zakończyć weryfikację.verification_progress
, który zawiera szczegółowe informacje dotyczące sesji weryfikacyjnej, w tym:program_status
reprezentuje bieżący stan sesji weryfikacyjnejaction_url
kieruje klienta do adresu URL umożliwiającego ukończenie weryfikacji.invitation_link_expiration_time
oznacza datę ważności kartyaction_url
- Wyliczenia:
- Błędy:
- Dodano
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
.
Komponenty
- Zmiany w
asset_group
:- Dodano obsługę segmentów związanych z czasem, np.
segments.year
isegments.month
. - Zamiast podziału zasobu na segmenty dodano
campaign
do przypisanego zasobu.
- Dodano obsługę segmentów związanych z czasem, np.
Kampanie
- Zmiany w kampaniach generujących popyt:
- Dodaliśmy obsługę ustawienia
Campaign.shopping_setting
do dotychczasowej kampanii generującej popyt. - Dodano źródło
ShoppingSetting.disable_product_feed
, aby wyłączyć opcjonalny plik danych o produktach w kampaniach generujących popyt. - Dodano pole
Ad.demand_gen_product_ad
i odpowiadające muDemandGenProductAdInfo
, które są dostępne w kampaniach generujących popyt, które nie mają wartościCampaign.shopping_setting
i nie są puste.
- Dodaliśmy obsługę ustawienia
- Dodano do tych pól w polu
AdGroup
, aby wskazać, czy grupa reklam wyświetla reklamy lub dlaczego tak się nie dzieje:primary_status
primary_status_reasons
- Dodano do tych pól w polu
AdGroupAd
, aby wskazać, czy reklama z grupy reklam wyświetla się lub dlaczego tak się nie dzieje:primary_status
primary_status_reasons
- Do
AdGroupError
dodaliśmy te wartości:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Eksperyment
- Dodano pole
Experiment.sync_enabled
, które pozwala określić, czy w eksperymencie ma być włączona synchronizacja. Gdy synchronizacja jest włączona, zmiany wprowadzane w pierwotnej kampanii w trakcie trwania eksperymentu są automatycznie kopiowane do kampanii z eksperymentem. - Dodano
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
. - Dodano
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
.
Hotele i podróże
- Do pola
ListingDimensionInfo
w przypadku reklamy Atrakcji dodaliśmy te pola, aby umożliwić tworzenie grup informacji o produktach według stanu i miasta, w którym dostępna jest aktywność związana z podróżami: - Do
travel_activity_performance_view
dodaliśmy obsługę tych segmentów:
Usługi Lokalne
- Dodaliśmy
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
iBusinessRegistrationCheckArtifact
, aby umożliwić reklamodawcom monitorowanie postępów procesu weryfikacji rejestracji firmy. - Dodaliśmy nowy zasób
local_services_employee
, który umożliwia reklamodawcom pobieranie dodanych przez nich informacji o pracownikach.
Planowanie
- Usunięto
score
zAudienceInsightsAttributeMetadata
.
Rekomendacje
- Dodano tabelę
RecommendationService.GenerateRecommendations()
, która zwraca rekomendacje na podstawie określonych ustawień, takich jak typy rekomendacji i typy kanałów reklamowych. Jest to szczególnie przydatne podczas tworzenia kampanii. - Dodano
RecommendationMetrics.conversions_value
. - Zalecane słowa kluczowe z nieskonfigurowanym typem dopasowania słów kluczowych mają teraz wartość
recommended_match_type
ustawioną naUNSPECIFIED
zamiastUNKNOWN
. - Dodaliśmy te typy rekomendacji:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
, który zaleca włączenie strategii ustalania stawek Maksymalizacja wartości konwersji.IMPROVE_GOOGLE_TAG_COVERAGE
, który zaleca wdrożenie tagu Google na większej liczbie stronPERFORMANCE_MAX_FINAL_URL_OPT_IN
, która zaleca włączenie rozwinięcia końcowego adresu URL w kampaniach Performance Max.REFRESH_CUSTOMER_MATCH_LIST
, która zaleca aktualizowanie listy klientów, która nie była aktualizowana od ostatnich 90 dni.CUSTOM_AUDIENCE_OPT_IN
, która zaleca utworzenie niestandardowej grupy odbiorców,LEAD_FORM_ASSET
, który zaleca dodanie komponentów z formularzem kontaktowym na poziomie kampanii lub klienta.IMPROVE_DEMAND_GEN_AD_STRENGTH
, które zaleca zwiększenie skuteczności reklamy w kampaniach generujących popyt.
kampania produktowa.
- Dodano
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
iCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
, aby wyświetlać bardziej szczegółowe informacje o błędach w kampaniach produktowych połączonych z kontem Comparison Shopping Service Center. - Do
AssetGroupListingGroupFilterError
dodaliśmy te wartości:DIMENSION_TYPE_NOT_ALLOWED
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
FILTER_EXCLUSION_NOT_ALLOWED
LISTING_SOURCE_NOT_ALLOWED
MULTIPLE_LISTING_SOURCES
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
PAGE_FEED_FILTER_HAS_PARENT
Cele cyklu życia
- Dodano
update
do operacjiCustomerLifecycleGoalOperation
iCampaignLifecycleGoalOperation
, aby zapewnić spójność tych typów operacji z innymi typami operacji w interfejsie API.
Wersja 15 (18.10.2023 r.)
W wersji 15 wprowadziliśmy następujące nowe funkcje i aktualizacje.
Zarządzanie kontem
- Jeśli Twoje konto zostało zawieszone z powodu nieupoważnionej aktywności,
customer.status
icustomer_client.status
są teraz zwracane jakoSUSPENDED
. Wcześniej były zwracane jakoENABLED
. - Dodaliśmy obsługę dodawania i usuwania połączenia między kontem Google Ads a kontem Merchant Center:
- Dodaliśmy
ProductLinkInvitationService
iProductLinkInvitation
, aby ułatwić aktualizację zaproszenia do połączenia wysłanego z innych usług, które jest dostępne na kontach Hotel Center i Merchant Center. - Usunięto pozycję
MerchantCenterLinkService
.- Aby połączyć konta Google Ads z kontami Merchant Center, użyj
ProductLinkInvitationService
iProductLinkService
.
- Aby połączyć konta Google Ads z kontami Merchant Center, użyj
- Usunięto
AccountLink.hotel_center
i obsługę aktualizowania zaproszeń o połączenie z kont Hotel Center za pomocąAccountLinkService
.- Aby zaktualizować zaproszenie do połączenia z konta Hotel Center, użyj adresu
ProductLinkInvitationService
.
- Aby zaktualizować zaproszenie do połączenia z konta Hotel Center, użyj adresu
Komponenty
- Zastąpiliśmy
ImageAdInfo.media_file
obiektemImageAdInfo.image_asset
, aby umożliwić dodawanie i usuwanie obrazów za pomocą zasobów. W związku z tym usunęliśmy właściwośćMediaFileService
, która nie jest już potrzebna. - Dodano metodę
ListingGroupFilterDimension.webpage
do tworzenia filtra grup informacji o produktach na podstawie etykiet własnych i podłańcuchów adresów URL.- Zastąpiono też
AssetGroupListingGroupFilter.vertical
znakamiAssetGroupListingGroupFilter.listing_source
iListingGroupFilterListingSource
- Zastąpiono też
- Dodano
asset_group_asset.source
, aby pokazać źródło zasobu grupy plików. - Dodano
ad_group_ad_asset_view.source
, aby pokazać źródło komponentu reklamy z grupy reklam.
Odbiorcy,
- W przypadku kierowania na listę klientów dodano właściwość
CustomerMatchUserListMetadata.consent
, aby ułatwić przekazywanie zgody. Od 6 marca 2024 r. w przypadku braku zgody użytkowników z Europejskiego Obszaru Gospodarczego wartość zgody użytkownika jest uznawana za nieudzieloną. Dane pochodzące od użytkowników z Europejskiego Obszaru Gospodarczego, którzy nie wyrazili zgody, nie będą przetwarzane i nie można ich używać do personalizacji reklam z wykorzystaniem kierowania na listę klientów. Więcej informacji znajdziesz w naszym przewodniku dotyczącym kierowania na listę klientów. - W przypadku sprzedaży w sklepie dodano właściwość
UserData.consent
, aby ułatwić przekazywanie zgody. Więcej informacji znajdziesz w naszym przewodniku po sprzedaży w sklepie. Jeśli używasz kierowania na listę klientów w przypadku sprzedaży w sklepie, więcej informacji znajdziesz w odpowiedziach na najczęstsze pytania. - Dodano segment
UserList.lookalike_user_list
, który umożliwia tworzenie podobnego segmentu, czyli listy odbiorców tworzonej na podstawie dostarczonej wyjściowej listy odbiorców. Podobnych segmentów można używać tylko w kampanii generującej popyt.
Kampanie
Zmiany w kampaniach Performance Max:
- Parametr
AssetGroupSignal
obsługuje teraz 2 typy sygnałów, które można dołączyć do grupy plików, aby ulepszyć kierowanie:AssetGroupSignal.audience
- Dodano
Audience.scope
iAudience.asset_group
, aby ograniczyć wykorzystanie list odbiorców do określonej grupy plików. WartośćAudience.asset_group
musi być ustawiona tylko wtedy, gdyAudience.scope
ma wartośćASSET_GROUP
.
- Dodano
AssetGroupSignal.search_theme
- Dodano typ kryterium
CriterionType.SEARCH_THEME
do obsługi tego nowego typu kryterium. Tego nowego typu kryterium można użyć tylko w kampaniach Performance Max do utworzenia elementuAssetGroupSignal
, podając w parametrzeAssetGroupSignal.search_theme
kryteriumSearchThemeInfo
.
- Dodano typ kryterium
- Dodaliśmy
AssetGroupSignalOperation.exempt_policy_violation_keys
, aby umożliwić zgłaszanie próśb o wyjątek podczas dodawania sygnałów grupy plików. - Dodaliśmy nowy obiekt
asset_group_top_combination_view
do raportowania najskuteczniejszych komponentów na poziomie grupy plików. - Do
asset_group
można teraz wysyłać zapytania z polami danych, aby ułatwić pobieranie danych o skuteczności kampanii Performance Max. - W zadaniu
PerformanceMaxUpgradeStatus
zmieniono nazwę zUPGRADE_ELIGIBLE
naUPGRADE_ELIGIBLE
.
- Parametr
W kampaniach generujących popyt i kampaniach Discovery ze strategią Docelowy CPA symulacje docelowych stawek CPA na poziomie kampanii (
campaign_simulation.target_cpa_point_list.points
) zwracają teraz wartośćTargetCpaSimulationPoint.interactions
zamiastTargetCpaSimulationPoint.clicks
.Dodano element
BrandSuggestionService
, który może sugerować marki na podstawie podanego prefiksu marki i listy wykluczonych marek. Tych marek można użyć do utworzenia kryteriumBRAND
, dodania do wspólnego zestawuBRANDS
, a następnie dołączenia do kampanii przez utworzenieCampaignCriterion
z wartościąbrand_list
ustawioną na wspólny zestaw. Kryteria kampanii można kierować w kampaniach w sieci wyszukiwania i wykluczać odpowiednio w kampaniach Performance Max.Dodano
Campaign.asset_automation_settings[]
, aby wyświetlać stan automatyzacji każdego typu zasobu.Do wyliczenia
CampaignPrimaryStatusReason
dodaliśmy te wartości:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Konwersje
- Dodano
CallConversion.consent
iClickConversion.consent
, aby ułatwić uzyskiwanie zgody. Więcej informacji znajdziesz w przewodniku po konwersjach telefonicznych i w przewodniku po konwersjach po kliknięciu. - Dodaliśmy te pola związane z konwersjami SKAdNetwork, które są dostępne podczas wysyłania zapytań dotyczących tych konwersji za pomocą
customer
lubcampaign
: - Element
metrics.sk_ad_network_conversions
zastąpiono wartościąmetrics.sk_ad_network_installs
. - Dodaliśmy obsługę diagnozowania przesyłanych konwersji offline.
- Przeniesiono
offline_conversion_upload_client_summary
z pola w zasobiecustomer
do raportu najwyższego poziomu. W tym raporcie możesz uzyskać przydatne informacje o stanie przesyłania konwersji, np. liczbę udanych zdarzeń, wskaźnik sukcesu i odsetek błędów.- Zastrzeżenie: przesłana konwersja, która powoduje błąd
ConversionUploadError.CLICK_NOT_FOUND
, jest nadal liczona jako udana, ale jest też oznaczona jakoOfflineConversionAlert
.
- Zastrzeżenie: przesłana konwersja, która powoduje błąd
- Dodaliśmy
job_id
jako parametr opcjonalny dla tych typów żądań, aby umożliwić logiczne zgrupowanie wielu żądań przesyłania w jedne zadanie koncepcyjne: - Dodano
INVALID_JOB_ID
do tych błędów: - Zastąpiono
INVALID_CONVERSION_ACTION
wartościamiNO_CONVERSION_ACTION_FOUND
iINVALID_CONVERSION_ACTION_TYPE
w przypadku tych błędów:
- Przeniesiono
- Dodaliśmy 3 raporty, aby obsługiwać atrybucję międzysieciową Piaskownicy prywatności na Androida bez przekierowań:
android_privacy_shared_key_google_campaign
, który zawiera poleshared_campaign_key
i kilka pól, które pomagają zakodować klucz.android_privacy_shared_key_google_ad_group
, który zawiera poleshared_ad_group_key
i kilka pól, które pomagają zakodować klucz.android_privacy_shared_key_google_network_type
, który zawiera poleshared_network_type_key
i kilka pól, które pomagają zakodować klucz.
- Dodano
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
.ConversionActionOperation
, który próbuje użyć jednego z wycofanych modeli atrybucji opartych na regułach, kończy się tym błędem. Wcześniej operacja kończyła się niepowodzeniem z powodu błęduUNKNOWN
.
Hotele i podróże
- Dodano obsługę tych pól w
travel_activity_group_view
itravel_activity_performance_view
:- Segmenty:
- Dane:
metrics.search_absolute_top_impression_share
metrics.search_budget_lost_absolute_top_impression_share
metrics.search_budget_lost_impression_share
metrics.search_budget_lost_top_impression_share
metrics.search_impression_share
metrics.search_rank_lost_absolute_top_impression_share
metrics.search_rank_lost_impression_share
metrics.search_rank_lost_top_impression_share
metrics.search_top_impression_share
Reklamy Usług Lokalnych
- Do raportu
customer
dodaliśmy poleLocalServicesSettings
i jego pola w celu zwrócenia szczegółowych informacji o stanie licencji i ubezpieczenia reklamodawcy korzystającego z Usług Lokalnych. - Dodaliśmy nowe raporty dotyczące Usług lokalnych:
local_services_lead
zawiera wszystkie informacje dotyczące potencjalnych klientów z Reklam Usług Lokalnych, np.lead_charged
,lead_type
,lead_status
.- Wyliczenia:
local_services_lead_conversation
zawiera szczegóły wiadomości i rozmów telefonicznych, np.conversation_channel
,call_duration_millis
,call_recording_url
.- Adres URL nagrywania rozmów telefonicznych jest uwierzytelniany na koncie klienta docelowego i jego kontach menedżera.
local_services_verification_artifact
zwraca artefakty reklamodawcy korzystającego z Usług Lokalnych, takie jak sprawdzenie przeszłości pracownika, licencje biznesowe i dane ubezpieczenia dla firm. Wszystkie dokumenty związane z licencją i ubezpieczeniem można otworzyć za pomocą adresu URL.
Planowanie
- Dodaliśmy obsługę zwracania wartości
Forecast.views
iPlannedProductForecast.views
w przypadkuReachPlanService.ListPlannableProducts
w odpowiednich typach produktów. - Dodaliśmy obsługę zwracania wartości
PlannableTargeting.surface_targeting
dlaReachPlanService.ListPlannableProducts
, która opisuje dostępne platformy dla produktu. - Dodano nowe wyliczenie
ReachPlanSurface
. - Dodano obsługę kierowania Docelowa częstotliwość za pomocą funkcji
AdvancedProductTargeting.target_frequency_settings
, która zwracaPlannedProductForecast.average_frequency
. - Dodano parametr
AudienceInsightsService.GenerateSuggestedTargetingInsights
, aby zwracać sugerowane listy odbiorców, na które można kierować reklamy. - Do
ReachPlanError
dodaliśmy te wartości:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Rekomendacje
- Dodano instancję
RecommendationSubscriptionService
, która zarządza subskrypcjami rekomendacji: - Dodaliśmy te typy rekomendacji:
FORECASTING_SET_TARGET_CPA
, który zaleca ustawienie docelowego CPA dla kampanii, które nie mają określonego docelowego CPA, z wyprzedzeniem przed wydarzeniem sezonowym, które ma zwiększyć ruch.SET_TARGET_CPA
, co zaleca ustawienie docelowego CPA w kampaniach, które nie mają określonego docelowego CPA.SET_TARGET_ROAS
, który zaleca ustawienie docelowego ROAS w przypadku kampanii, które nie mają określonego docelowego ROAS.
Zdawanie relacji
- Dodaliśmy nowe dane, do których można wysyłać zapytania za pomocą
campaign
(dostępne w przypadku kampanii w sieci reklamowej, kampanii wideo, Discovery i kampanii promujących aplikacje) orazsegments.device
:
kampania produktowa.
- Usunięto
ShoppingSetting.sales_country
, którego wartości są teraz zwracane jakoShoppingSetting.feed_label
.- Możesz nadal używać w kampanii określonego pliku danych Merchant Center, korzystając z pola
ShoppingSetting.feed_label
. Należy ustawić wartość etykiety pliku danych lub dwuliterowy kod kraju używany wcześniej w przypadku atrybutuShoppingSetting.sales_country
. Więcej informacji znajdziesz w artykule pomocy na temat etykiet plików danych.
- Możesz nadal używać w kampanii określonego pliku danych Merchant Center, korzystając z pola
- W raportach usunięto zależność kategorii produktów od kodu kraju.
Zestaw obsługiwanych identyfikatorów kategorii nie uległ zmianie.
- Zastąpiono te pola używane w zadaniu
shopping_performance_view
:segments.product_bidding_category_level1
z:segments.product_category_level1
segments.product_bidding_category_level2
z:segments.product_category_level2
segments.product_bidding_category_level3
z:segments.product_category_level3
segments.product_bidding_category_level4
z:segments.product_category_level4
segments.product_bidding_category_level5
z:segments.product_category_level5
- Zastąpiono
product_bidding_category_constant
wartościąproduct_category_constant
, co zwraca wszystkie dostępne lokalizacje kategorii w polu powtarzanym. - Element
ListingDimensionInfo.product_bidding_category
zastąpiono wartościąListingDimensionInfo.product_category
. - Element
ListingGroupFilterDimension.product_bidding_category
zastąpiono wartościąListingGroupFilterDimension.product_category
.
- Zastąpiono te pola używane w zadaniu
- Usunęliśmy możliwość dodawania
Campaign.shopping_setting
do kampanii w sieci wyszukiwania. Próba utworzenia kampanii w sieci wyszukiwania za pomocą narzędziaCampaign.shopping_setting
lub dodania parametruCampaign.shopping_setting
do istniejącej kampanii w sieci wyszukiwania daje teraz wynikOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Usunęliśmy możliwość dodawania
CampaignCriterion.listing_scope
do kampanii w sieci wyszukiwania. Jeśli spróbujesz dodać wartośćCampaignCriterion.listing_scope
do dotychczasowej kampanii w sieci wyszukiwania, otrzymasz terazOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Dodaliśmy te dane Konwersje z danymi koszyka:
metrics.orders
metrics.average_order_value_micros
metrics.average_cart_size
metrics.cost_of_goods_sold_micros
metrics.gross_profit_micros
metrics.gross_profit_margin
metrics.revenue_micros
metrics.units_sold
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
- Wszystkie te dane można wybrać w tych raportach:
Ujednolicone cele
- Dodano metodę
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
do konfigurowania celów „Pozyskiwanie klientów” na poziomie klienta.- Raport:
customer_lifecycle_goal
- Raport:
- Dodano metodę
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
do konfigurowania celów „Pozyskiwanie klientów” na poziomie kampanii.- Raport:
campaign_lifecycle_goal
- Raport:
- Dodano
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
. - Do
ConversionGoalCampaignConfigError
dodaliśmy te wartości:EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
Filmy
- Dodaliśmy obsługę kierowania na Google TV na poziomie kampanii:
- Dodano
NetworkSettings.target_google_tv_network
- Dodano
AdNetworkType.GOOGLE_TV
.
- Dodano
- Dodaliśmy obsługę kierowania w YouTube na poziomie kampanii:
- Dodano
NetworkSettings.target_youtube
- W
AdNetworkType
scalonoYOUTUBE_WATCH
iYOUTUBE_SEARCH
wYOUTUBE
. - Dodano
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
.
- Dodano
Informacje o zarchiwizowanych wersjach
Zarchiwizowane informacje o wersjach znajdziesz w sekcji Wersje wyłączone.