Informacje o wersjach

Wersja 17 (5.06.2024)

W wersji 17 dodaliśmy poniższe funkcje i zmiany.

Reklamy

• Usunięto pozycję AdService.getAd. Dzięki temu AdService 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:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Komponenty

• Dodano nową wyliczenie: ClickType.AD_IMAGE
• Dodaliśmy nowe raporty z nowymi danymi dotyczącymi kampanii Performance Max i kampanii w sieci wyszukiwania:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Odbiorcy,

• Dodano: OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

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 z BatchJobService. 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 teraz AdvertisingChannelType.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 na segments.sk_ad_network_fine_conversion_value.
  • Dodano: segments.sk_ad_network_redistributed_fine_conversion_value.
• Te dane są teraz zwracane w odpowiedzi nawet wtedy, gdy ich wartość wynosi 0. Dzięki temu są one spójne z innymi danymi.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

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 dla gender_view
• Dodano obsługę metrics.phone_calls dla keyword_view

Usługi Lokalne

• Dodano obiekt LocalServicesLeadService.AppendLeadConversation() służący do dołączania do LocalServicesLead nowego adresu LocalServicesLeadConversation, 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ć tylko LocalServicesLead z wartością lead_type ustawioną na LeadType.MESSAGE.
• Do tabeli ConversationType dodaliśmy nowe wartości wyliczeniowe:
  • WHATSAPP – reprezentuje rozmowę wprowadzoną na WhatsAppie.
  • ADS_API – reprezentuje rozmowę wprowadzoną za pomocą nowej metody LocalServicesLeadService.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łoszenie QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Na przykład w tym samym zapytaniu nie można wybrać parametrów product_link.advertising_partner.customer i product_link.data_partner.data_partner_id.
• Przekazywanie parametru page_size do funkcji GoogleAdsService.Search spowoduje błąd RequestError.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ą parametru segments.date, jeśli korzystasz z GoogleAdsService.Search lub GoogleAdsService.SearchStream. Podział na segmenty według daty jest niedozwolony i zwraca błąd ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

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ści UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Dołącz lub odłącz listę użytkowników za pomocą ustawienia UserListCustomerType.customer_type_category na UserListCustomerTypeCategory.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.

Filmy

• Do narzędzia ContentLabelType dodaliśmy poniższe wartości. Możesz wykluczyć te ContentLabelTypes 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 tworzenia DemandGenVideoResponsiveAdInfo.
• (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 i asset_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 jako MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. Jeśli zasada ma wartość true, wszystkie nieblokujące błędy związane z niepowodzeniami operacji są zwracane jako MutateCustomerSkAdNetworkConversionValueSchemaResponse.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 i local_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 oraz BrandSafetySuitability, 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 z AccountLink do ProductLink i ProductLinkInvitation.
• Usunięto data_partner i google_ads z AccountLink.
• Do zarządzania weryfikacją reklamodawcy dodano IdentityVerificationService.
  • StartIdentityVerification() służy do rozpoczęcia sesji weryfikacyjnej przy użyciu podanego verification_program. Utworzy nową sesję weryfikacji i zwraca pustą odpowiedź dla pomyślnej weryfikacji.
    • Dodano IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION.
  • GetIdentityVerification() może być używany do pobierania informacji weryfikacyjnych, które zwraca kilka obiektów IdentityVerification. Każdy element IdentityVerification 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 weryfikacyjnej
      • action_url kieruje klienta do adresu URL umożliwiającego ukończenie weryfikacji.
      • invitation_link_expiration_time oznacza datę ważności karty action_url
  • Wyliczenia:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Błędy:
    • IdentityVerificationError
• 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 i segments.month.
  • Zamiast podziału zasobu na segmenty dodano campaign do przypisanego zasobu.

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 mu DemandGenProductAdInfo, które są dostępne w kampaniach generujących popyt, które nie mają wartości Campaign.shopping_setting i nie są puste.
• 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:
  • activity_state
  • activity_city
• Do travel_activity_performance_view dodaliśmy obsługę tych segmentów:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Usługi Lokalne

• Dodaliśmy LocalServicesVerificationArtifact.business_registration_check_verification_artifact i BusinessRegistrationCheckArtifact, 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 z AudienceInsightsAttributeMetadata.

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ą na UNSPECIFIED zamiast UNKNOWN.
• 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 stron
  • PERFORMANCE_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 i CampaignError.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 operacji CustomerLifecycleGoalOperation i CampaignLifecycleGoalOperation, 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 i customer_client.status są teraz zwracane jako SUSPENDED. Wcześniej były zwracane jako ENABLED.
• Dodaliśmy obsługę dodawania i usuwania połączenia między kontem Google Ads a kontem Merchant Center:
  • Dodano ProductLink.merchant_center i MerchantCenterIdentifier.
  • Dodano LinkedProductType.MERCHANT_CENTER.
• Dodaliśmy ProductLinkInvitationService i ProductLinkInvitation, 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 i ProductLinkService.
• 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.

Komponenty

• Zastąpiliśmy ImageAdInfo.media_file obiektem ImageAdInfo.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 znakami AssetGroupListingGroupFilter.listing_source i ListingGroupFilterListingSource
• 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 i Audience.asset_group, aby ograniczyć wykorzystanie list odbiorców do określonej grupy plików. Wartość Audience.asset_group musi być ustawiona tylko wtedy, gdy Audience.scope ma wartość ASSET_GROUP.
    • 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 elementu AssetGroupSignal, podając w parametrze AssetGroupSignal.search_theme kryterium SearchThemeInfo.
  • 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ę z UPGRADE_ELIGIBLE na UPGRADE_ELIGIBLE.

• 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 zamiast TargetCpaSimulationPoint.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 kryterium BRAND, dodania do wspólnego zestawu BRANDS, a następnie dołączenia do kampanii przez utworzenie CampaignCriterion 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.

  • Pola:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Wyliczenia:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• 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 i ClickConversion.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 lub campaign:
  • Segmenty:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • Dane:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• 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 zasobie customer 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 jako OfflineConversionAlert.
  • 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:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • Dodano INVALID_JOB_ID do tych błędów:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • Zastąpiono INVALID_CONVERSION_ACTION wartościami NO_CONVERSION_ACTION_FOUND i INVALID_CONVERSION_ACTION_TYPE w przypadku tych błędów:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• 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 pole shared_campaign_key i kilka pól, które pomagają zakodować klucz.
  • android_privacy_shared_key_google_ad_group, który zawiera pole shared_ad_group_key i kilka pól, które pomagają zakodować klucz.
  • android_privacy_shared_key_google_network_type, który zawiera pole shared_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łędu UNKNOWN.

Hotele i podróże

• Dodano obsługę tych pól w travel_activity_group_view i travel_activity_performance_view:
  • Segmenty:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • 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 pole LocalServicesSettings 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:
      • LeadStatus
      • LeadType
  • 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.
    • Wyliczenia:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Planowanie

• Dodaliśmy obsługę zwracania wartości Forecast.views i PlannedProductForecast.views w przypadku ReachPlanService.ListPlannableProducts w odpowiednich typach produktów.
• Dodaliśmy obsługę zwracania wartości PlannableTargeting.surface_targeting dla ReachPlanService.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 zwraca PlannedProductForecast.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:
  • Zasób: RecommendationSubscription
  • Pole: MutateOperation.recommendation_subscription_operation
  • Wyliczenie: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • Błędy:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• 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) oraz segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

kampania produktowa.

• Usunięto ShoppingSetting.sales_country, którego wartości są teraz zwracane jako ShoppingSetting.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 atrybutu ShoppingSetting.sales_country. Więcej informacji znajdziesz w artykule pomocy na temat etykiet plików danych.
• 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.
• Usunęliśmy możliwość dodawania Campaign.shopping_setting do kampanii w sieci wyszukiwania. Próba utworzenia kampanii w sieci wyszukiwania za pomocą narzędzia Campaign.shopping_setting lub dodania parametru Campaign.shopping_setting do istniejącej kampanii w sieci wyszukiwania daje teraz wynik OPERATION_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 teraz OPERATION_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:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Ujednolicone cele

• Dodano metodę CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals do konfigurowania celów „Pozyskiwanie klientów” na poziomie klienta.
  • Raport: customer_lifecycle_goal
• Dodano metodę CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals do konfigurowania celów „Pozyskiwanie klientów” na poziomie kampanii.
  • Raport: campaign_lifecycle_goal
• 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.
• Dodaliśmy obsługę kierowania w YouTube na poziomie kampanii:
  • Dodano NetworkSettings.target_youtube
  • W AdNetworkType scalono YOUTUBE_WATCH i YOUTUBE_SEARCH w YOUTUBE.
  • Dodano CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE.

Informacje o zarchiwizowanych wersjach

Zarchiwizowane informacje o wersjach znajdziesz w sekcji Wersje wyłączone.