Informacje o wersjach

Planowanie

• (Tylko dla kont na liście dozwolonych) Dodano nową usługę z metodą ContentCreatorInsightsService.GenerateCreatorInsights, która umożliwia użytkownikom poznawanie statystyk dotyczących najlepszych twórców YouTube. Umożliwia to klientom wyszukiwanie twórców po wybraniu kombinacji kierowania na odbiorców i kierowania na treści lub statystyk twórcy na podstawie listy identyfikatorów kanałów w YouTube.
• Zmiany w AudienceInsightsService.GenerateSuggestedTargetingInsights:
  • Elementy audience, baseline_audience i data_month zostały przeniesione do audience_definition.
  • Dodano audience_description, aby generować sugestie kierowania na podstawie dowolnego tekstu reklamy przy użyciu generatywnej AI.
• Dodano tabelę AudienceInsightsService.GenerateTargetingSuggestionMetrics, która zwraca dane o potencjalnym zasięgu dla określonych kombinacji kierowania na odbiorców.

Rekomendacje

• RecommendationService.GenerateRecommendations może teraz służyć do generowania rekomendacji dotyczących zoptymalizowanych budżetów podczas tworzenia kampanii, w tym do uwzględniania typu rekomendacji CAMPAIGN_BUDGET w GenerateRecommendationsRequest.recommendation_types[]. Ta funkcja działa w przypadku kampanii Performance Max i kampanii w sieci wyszukiwania.

Raportowanie

• Zastąpiono pola summary_row_setting i return_total_results_count elementu SearchGoogleAdsRequest polem search_settings, którego typ to SearchSettings, następującymi polami:
  • omit_results
  • return_summary_row
  • return_total_results_count
• Dodaliśmy te nowe dane dotyczące ogólnych nieprawidłowych kliknięć, np. kliknięć generowanych przez boty lub roboty indeksujące, kliknięć o nieregularnych wzorach. Można je wyszukiwać za pomocą raportu campaign.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• Do QuotaError dodano te wartości:
  • EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

17.1.0 (7.08.2024)

W wersji 17_1 dodaliśmy poniższe nowe funkcje i aktualizacje.

Zasoby

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() umożliwia usunięcie określonych komponentów tworzonych automatycznie połączonych z elastycznymi reklamami w wyszukiwarce.

Odbiorcy

• Nowe wartości typu wyliczeniowego w polu UserListCustomerTypeCategory:
  • LOYALTY_TIER_1_MEMBERS
  • LOYALTY_TIER_2_MEMBERS
  • LOYALTY_TIER_3_MEMBERS
  • LOYALTY_TIER_4_MEMBERS
  • LOYALTY_TIER_5_MEMBERS
  • LOYALTY_TIER_6_MEMBERS
  • LOYALTY_TIER_7_MEMBERS

Kampanie

• ShareablePreviewService.GenerateShareablePreviews() generuje adresy URL (shareable_preview_url w odpowiedzi) podglądów reklam, które można udostępnić, w przypadku włączonych i wstrzymanych grup komponentów.
  • Pole expiration_date_time wskazuje datę wygaśnięcia adresów URL w odpowiedzi.
  • Jeśli wystąpi błąd, metoda zwróci partial_failure_error zamiast adresów URL.

Historia zmian

• Nowy typ zasobu zmiany stanu: ASSET_GROUP.

Konwersje

• Nowe pole segmentu dla wersji SKAdNetwork: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary, która zawiera diagnostykę przesyłania konwersji na poziomie działania powodującego konwersję.
• Do raportów diagnostyki offline dodawane są te dane, które informują o liczbie przesłanych konwersji, które są nadal przetwarzane:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

Planowanie

• AudienceInsights.GenerateAudienceOverlapInsights(), który akceptuje wejściowy atrybut główny i zbiór atrybutów dotyczących odbiorców, a następnie zwraca szacunkowe dane o pokrywaniu się potencjalnego zasięgu w YouTube między atrybutem podstawowym i odbiorcami.

Raportowanie

• Obsługa podziału na segmenty per_store_view na podstawie segments.date

Filmy

• Obsługa pobierania informacji związanych z tymi standardowymi strategiami ustalania stawek w przypadku kampanii wideo za pomocą raportów, takich jak ad_group i campaign:
  • Campaign.fixed_cpm (stały CPM (koszt tysiąca wyświetleń))
  • Campaign.target_cpv (Docelowy CPV (koszt obejrzenia))
• Campaign.video_campaign_settings, który pozwala określić zasoby reklamowe, w których mogą się wyświetlać reklamy wideo, za pomocą tych pól raportu:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type, która umożliwia podział na segmenty w tych raportach na podstawie typu formatu reklamy wideo:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

Wersja 17 (5.06.2024)

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

Reklamy

• Użytkownik AdService.getAd został usunięty. Dzięki temu interfejs AdService będzie zgodny z innymi usługami w interfejsie Google Ads API. Więcej informacji o zalecanym sposobie pobierania reklam i innych typów zasobów znajdziesz w artykule Pobieranie obiektów.
• Dodano więcej weryfikacji ImageAdInfo.image_asset dotyczących wymiarów i formatu. Jeśli obraz jest nieprawidłowy, mogą wystąpić te błędy:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Zasoby

• Dodano nowy typ wyliczeniowy: ClickType.AD_IMAGE
• Dodaliśmy te nowe raporty z nowymi rodzajami danych dla kampanii Performance Max i kampanii w sieci wyszukiwania:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Odbiorcy

• Dodano stronę OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Zadania wsadowe

• Dodano parametr BatchJobError.REQUEST_TOO_LARGE, który zostanie wywołany, gdy przesłany parametr AddBatchJobOperationsRequest będzie większy niż 10484504 bajtów.
• Dodano obsługę ustawienia MutateOperation.asset_group_operation podczas korzystania z BatchJobService. Dzięki temu możesz: korzystać z przetwarzania zbiorczego do tworzenia zarządzać całymi kampaniami Performance Max. Zapoznaj się z naszym nowym specjalnym przewodnikiem.

Kampanie

• Zmieniliśmy nazwę „Discovery” na „Demand Gen” we wszystkich polach, typach danych i błędach wszystkich zasobów interfejsu Google Ads API, takich jak kampanie, reklamy i komponenty. Na przykład: AdvertisingChannelType.DISCOVERY to teraz AdvertisingChannelType.DEMAND_GEN.
• Dodano Campaign.keyword_match_type, aby umożliwić Ci ustawianie typu dopasowania słów kluczowych we wszystkich słowach 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 mają wartość 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 następujących pól do tabeli AdGroupCriterion wskazuje, czy kryterium w grupie reklam wyświetla się lub dlaczego nie porcja:
  • primary_status
  • primary_status_reasons
• Dodano obsługę metrics.search_impression_share przez gender_view
• Dodano obsługę metrics.phone_calls przez keyword_view

Usługi Lokalne

• Dodano: LocalServicesLeadService.AppendLeadConversation() służy do dołączania nowych LocalServicesLeadConversation do LocalServicesLead, które wysyła za pomocą odpowiednich kanałów, takich jak SMS-y. utworzono potencjalną sprzedaż.
  • Rozmiar AppendLeadConversationRequest.conversations jest ograniczony do 1000.
  • Tylko LocalServicesLead z Ustawiono lead_type na LeadType.MESSAGE można określić w Conversation.local_services_lead.
• Dodano nowe wartości typu wyliczeniowego do kolumny ConversationType:
  • WHATSAPP – reprezentuje rozmowę wprowadzoną na WhatsAppie.
  • ADS_API, aby reprezentować rozmowę wprowadzoną za pomocą nowej metody LocalServicesLeadService.AppendLeadConversation().
• Dodaliśmy do pola local_services_verification_artifact te nowe pola:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

Raportowanie

• Teraz możesz wybrać tylko pola powiązane z jedną połączoną usługą w przypadku zapytania product_link. Wybranie wielu pól wielu połączonych produktów spowoduje błąd QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Przykład: product_link.advertising_partner.customer oraz product_link.data_partner.data_partner_id nie można wybrać w tym samym zapytaniu.
• Przekazanie wartości 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 zwrot związane z bieżącym stanem produktów z Google Merchant Center kont połączonych z kontem Google Ads.
  • Możesz filtrować dane z: shopping_product zastosuj, segments.date, gdy używasz GoogleAdsService.Search lub GoogleAdsService.SearchStream. Segmentacja według daty jest niedozwolona i spowoduje błąd ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

Cele ujednolicone

• Dodano UserListCustomerTypeService.MutateUserListCustomerTypes(), aby skonfigurować typy klientów odbiorców.
• Użytkownik CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings został usunięty. Aby skonfigurować ustawienia list odbiorców w celach dotyczących cyklu życia klienta, użyj zamiast tego UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Załącz lub odłącz listę użytkowników, ustawiając parametr UserListCustomerType.customer_type_category na UserListCustomerTypeCategory.PURCHASERS, aby odpowiednio uwzględnić lub wykluczyć ją z dotychczasowej definicji klienta na potrzeby celów związanych z cyklem życia klienta. Odwiedź stronę Posegmentuj odbiorcy .

Filmy

• Dodano następujące wartości do ContentLabelType Na poziomie klienta możesz wykluczyć te ContentLabelTypes:
  • 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 dotyczące zasobów wideo podczas tworzenia DemandGenVideoResponsiveAdInfo
• Utworzono (tylko konta z listy dozwolonych) Campaign.video_brand_safety_suitability zmienny.

Wersja 16.1.0 (24.04.2024)

W wersji 16.1 dodano te 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ść wyliczenia: ProductLinkError.LINK_EXISTS
• Nowa wartość typu wyliczeniowego: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION.

Zasoby

• Obsługa komponentów związanych z generowaniem popytu: ad_group_ad_asset_view i asset_field_type_view.
• Nowa wartość typu wyliczeniowego: AssetFieldType.DISCOVERY_CAROUSEL_CARD.

Odbiorcy

• Nowa wartość enum: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER który ogranicza do 1000 podobnych list użytkowników.

Kampanie

• Obsługa zwracania symulacji stawek kampanii 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ść typu wyliczeniowego: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY.
• Nowa wartość wyliczenia: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS

Konwersje

• SkAdNetworkConversionValueSchema.postback_mappings która obsługuje SKAdNetwork 4,0 funkcje zabezpieczeń.
• Dodaliśmy obsługę ostrzeżeń dla: CustomerSkAdNetworkConversionValueSchemaService jako MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings Jeśli zasada jest ustawiona na true, wszystkie nieblokujące błędy związane z błędami operacji zostanie zwrócony jako MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
• Nowe wartości typu wyliczeniowego w polu CustomerSkAdNetworkConversionValueSchemaError:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

Kryteria

• Nowe pola w BrandInfo:
  • display_name
  • primary_url
  • rejection_reason
  • status
• Nowa wyliczenie: BrandRequestRejectionReason
• Nowa wartość typu wyliczeniowego: 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 zwracają stan środków oraz sygnaturę czasową, kiedy stan środków został zaktualizowany.
• local_services_lead_conversation.message_details.attachment_urls, który zwraca adresy URL, których można użyć do pobrania treści załącznika.

Filmy

• customer.video_brand_safety_suitability oraz BrandSafetySuitability wspierające pobieranie treści wideo dla klienta pod kątem bezpieczeństwa marki na poziomie 300%.
• Nowa wartość typu wyliczeniowego: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

Wersja 16 (21.02.2024)

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

Zarządzanie kontem

• Przeniesiono advertising_partner z AccountLink na ProductLink oraz ProductLinkInvitation.
• Użytkownik data_partner i google_ads został usunięty z: AccountLink.
• Dodano IdentityVerificationService do zarządzania weryfikacją reklamodawcy.
  • StartIdentityVerification() jest używana do rozpoczęcia sesji weryfikacyjnej przy użyciu podanego verification_program Tworzy nową sesję weryfikacji i zwraca pustą odpowiedź dla udało się utworzyć weryfikację.
    • Dodane IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
  • GetIdentityVerification() może służyć do pobierania informacji weryfikacyjnych, które zwracają kilka obiektów IdentityVerification. Każda IdentityVerification obejmuje:
    • verification_program czyli typ programu weryfikacji tożsamości.
    • identity_verification_requirement który zawiera szczegółowe informacje na temat terminu, do którego reklamodawca powinien dokończyć proces weryfikacji
    • verification_progress z informacjami dotyczącymi sesji weryfikacji, w tym:
      • program_status to bieżący stan sesja weryfikacyjna
      • action_url przekierowuje klienta do adresu URL, aby dokończyć weryfikację.
      • invitation_link_expiration_time oznacza datę ważności w okresie: action_url
  • Wyliczenia:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Błędy:
    • IdentityVerificationError
• Dodane AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT

Zasoby

• Zmiany w asset_group:
  • Dodano obsługę segmentów związanych z czasem, takich jak segments.year i segments.month
  • Zasób campaign jest teraz zasobem przypisanym, a nie segmentującym.

Kampanie

• Zmiany w kampaniach generujących popyt:
  • Dodano obsługę ustawienia Campaign.shopping_setting do do istniejącej kampanii generującej popyt.
  • Dodano opcjęShoppingSetting.disable_product_feeddo wyłączania opcjonalnego pliku danych o produktach w kampaniach generujących popyt.
  • Dodano: Ad.demand_gen_product_ad i odpowiednik DemandGenProductAdInfo, dostępny dla Kampanie generujące popyt z wartością inną niż null Campaign.shopping_setting.
• Dodano do następujących pól w tabeli AdGroup, aby pokazać, czy grupa reklam wyświetla reklamy lub przyczyny, dla których reklama się nie wyświetla:
  • primary_status
  • primary_status_reasons
• Dodano do tych pól w sekcji AdGroupAd, aby wyświetlać informacje o tym, czy reklama grupy reklam jest wyświetlana, czy nie, oraz o przyczynach, dla których nie jest wyświetlana:
  • primary_status
  • primary_status_reasons
• Dodano następujące wartości do AdGroupError:
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

Eksperyment

• Dodano opcję Experiment.sync_enabled, która pozwala określić, czy synchronizacja ma być włączona w eksperymencie. Gdy synchronizacja jest włączona, zmiany wprowadzone w pierwotnej kampanii w trakcie trwania eksperymentu są automatycznie kopiowane do kampanii z eksperymentem.
• Dodano stronę ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE.
• Dodano stronę CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL.

Hotele i Podróże

• Do pól ListingDimensionInfo w reklamie Atrakcji dodaliśmy następujące pola, aby umożliwić tworzenie grup informacji na podstawie stanu i miasta, w których dostępna jest aktywność turystyczna:
  • activity_state
  • activity_city
• Dodaliśmy obsługę tych segmentów w travel_activity_performance_view:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Usługi Lokalne

• Dodano LocalServicesVerificationArtifact.business_registration_check_verification_artifacti BusinessRegistrationCheckArtifact, aby umożliwić reklamodawcom monitorowanie postępów w procesie weryfikacji rejestracji firmy.
• Dodaliśmy nowe źródło danych local_services_employee, aby umożliwić reklamodawcom pobieranie dodanych przez nich informacji o pracownikach.

Planowanie

• Użytkownik score został usunięty z AudienceInsightsAttributeMetadata.

Rekomendacje

• Dodane RecommendationService.GenerateRecommendations() która zwraca rekomendacje na podstawie określonych ustawień, takich jak typów rekomendacji i kanałów reklamowych. To szczególnie przydatne podczas tworzenia kampanii.
• Dodano stronę RecommendationMetrics.conversions_value.
• Zalecane słowa kluczowe z nieskonfigurowanym typem dopasowania słów kluczowych mają teraz recommended_match_type ustawiono na UNSPECIFIED zamiast UNKNOWN.
• Dodaliśmy te typy rekomendacji:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN, która zaleca włączenie strategii ustalania stawek Maksymalizacja wartości konwersji.
  • IMPROVE_GOOGLE_TAG_COVERAGE, który zaleca wdrożenie tagu Google na więcej 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 aktualizację listy klientów, która nie była aktualizowana w ostatnie 90 dni
  • CUSTOM_AUDIENCE_OPT_IN W tej sytuacji zaleca się utworzenie niestandardowej grupy odbiorców,
  • LEAD_FORM_ASSET który zaleca dodanie komponentów z formularzem kontaktowym na poziomie kampanii lub klienta poziom
  • IMPROVE_DEMAND_GEN_AD_STRENGTH W ramach tej strategii zaleca się zwiększenie skuteczności reklamy w kampaniach generujących popyt.

kampania produktowa.

• Dodane CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT oraz CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS Aby wyświetlać bardziej szczegółowe błędy w kampaniach produktowych powiązanych z Comparison Shopping Service Center konta.
• Dodano następujące wartości do AssetGroupListingGroupFilterError:
  • 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

• Użytkownik update został dodany do listy CustomerLifecycleGoalOperation. oraz CampaignLifecycleGoalOperation aby ujednolicić te typy operacji z innymi typami operacji w interfejsie API. ## Informacje o zarchiwizowanej wersji

Aby wyświetlić zarchiwizowane informacje o wersji, kliknij Wycofane wersje.