Bu kılavuzda, üçüncü taraf uygulama geliştiricilerinin
MerchantSupport
hizmetini kullanarak satıcılar için bir uygulama içi teşhis sayfası oluşturabilir.
Tekliflerinizi otomatikleştirmek ve optimize etmek için Merchant Center hesabına benzer kullanıcı arayüzleri oluşturmak için bu hizmeti teşhisler ve ürün sorunları sayfalarında bulabilirsiniz.
MerchantSupport
hizmeti yalnızca üçüncü taraf kullanıcı arayüzleri için kullanılabilir. İstekler aşağıdaki gibi olmalıdır:
Bir satıcı, uygulamanızın kullanıcı arayüzüyle etkileşime geçtiğinde tetiklenir. Otomatikleştirmek için
daha fazla bilgi edinmek için hesap
durum, ürün
durum ve ürün
filtreleme kılavuzlarına göz atın.
Uygulamanızda aşağıdaki sayfaları sağlamanızı öneririz: Satıcılar için sorun giderme:
- Hesap teşhisi
- Ürün teşhisleri
Teşhis sayfasını uygulamak için farklı seçenekler
Teşhis sayfasını farklı şekillerde uygulayabilirsiniz. İhtiyacınıza bağlı olarak,
karmaşık teşhis işlemlerinin nasıl işleneceğini belirleyen seçeneği belirleyin. İçinde
user_input_action_option
değerini şunlardan birine ayarlayabilirsiniz:
seçenekler:
REDIRECT_TO_MERCHANT_CENTER
: Bu, varsayılan seçenektir. Eylemler ek içerik görüntülemenizi gerektirir veya satıcının uygulamanızda tam olarak uygulanmaması. API, bu işletmeler için bağlantısını tıklayarak Merchant Center'da ilgili sayfaya satıcı tarafından gerçekleştirilebilir.BUILT_IN_USER_INPUT_ACTIONS
: Kapsamlı işlemler yapılmasını gerektiren karmaşık işlemleri uygulama içi çözüm olarak uygulamanızda kullanabilirsiniz.
Teşhis sayfası uygulayın
Bu bölümde, teşhis sayfasının nasıl uygulanacağı açıklanmaktadır. Varsayılan değeri kullanır (basit) seçeneği ile karmaşık işlemleri Merchant Center'a yönlendirme yapabilirsiniz.
Uygulama içi işlemlerle daha gelişmiş bir uygulama için aşağıdakileri inceleyin: bölümlerine göz atın ve Kullanıcı girişiyle yerleşik işlemi uygulama başlıklı makaleyi inceleyin.
Uygulama
Teşhis sayfanızın akışının aşağıdaki gibi görünmesi önerilir:
- Bir satıcı, uygulamanızda bir teşhis sayfası açar.
Uygulamanız,
MerchantSupport
hizmetini çağırarak teşhis isteğinde bulunuyor.Aşağıda örnek bir istek verilmiştir:
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/merchantsupport/renderaccountissues?timeZone=America/Los_Angeles&languageCode=en-GB {}
{merchantId} değerini işlemin uygulanmasını tetiklemek istediğiniz hesabı seçin.
Uygulamanızda, yanıttaki teşhis bilgileri ve önerilen işlemler gösteriliyor satıcıya gönderilir. Aşağıda örnek bir yanıt verilmiştir:
{ "issues": [ { "title": "Misrepresentation", "impact": { "message": "Prevents all products from showing in all countries", "severity": "ERROR", "breakdowns": [ { "regions": [ { "code": "001", "name": "All countries" } ], "details": [ "Products not showing organically" ] } ] }, "prerenderedContent": "\u003cdiv class=\"issue-detail\"\u003e\u003cdiv class=\"issue-content\"\u003e\u003cp class=\"content-element\"\u003e\u003cspan class=\"segment\"\u003eBased on the information available about your business, there is reason to believe that customers are being misled on Google. Review the Misrepresentation policy and make changes to your Merchant Center and/or online store.u003c/span\u003e\u003c/p\u003e\u003cp class=\"content-element root-causes-intro\"\u003e\u003cspan class=\"segment\"\u003eMake sure your Merchant Center and online store follow the following best practices / guidelines\u003c/span\u003e\u003c/p\u003e\u003cul class=\"content-element root-causes\"\u003e\u003cli\u003e\u003cp\u003e\u003cspan class=\"segment\"\u003eProvide transparency about your business identity, business model, policies and how your customers can interact with you\u003c/span\u003e\u003c/p\u003e\u003c/li\u003e\u003cli\u003e\u003cp\u003e\u003cspan class=\"segment\"\u003ePromote your online reputation by showing reviews or highlighting any badges or seals of approval\u003c/span\u003e\u003c/p\u003e\u003c/li\u003e\u003cli\u003e\u003cp class=\"tooltip tooltip-style-info\"\u003e\u003cspan class=\"segment\"\u003eUse a professional design for your online store that includes an SSL certificate\u003c/span\u003e\u003cspan class=\"tooltip-icon\"\u003e\u003cbr\u003e\u003c/span\u003e\u003cspan class=\"tooltip-text\"\u003e\u003cspan class=\"segment\"\u003eMake sure it's accessible for all users without any redirects and doesn't have any placeholders for text and images.u003c/span\u003e\u003c/span\u003e\u003c/p\u003e\u003c/li\u003e\u003cli\u003e\u003cp class=\"tooltip tooltip-style-info\"\u003e\u003cspan class=\"segment\"\u003eProvide information in the business information settings in your Merchant Center\u003c/span\u003e\u003cspan class=\"tooltip-icon\"\u003e\u003cbr\u003e\u003c/span\u003e\u003cspan class=\"tooltip-text\"\u003e\u003cspan class=\"segment\"\u003eLink any relevant third-party platforms to your Merchant Center and create a Google Business Profile.u003c/span\u003e\u003c/span\u003e\u003c/p\u003e\u003c/li\u003e\u003cli\u003e\u003cp\u003e\u003cspan class=\"segment\"\u003eFollow SEO guidelines, improve your eligibility for seller ratings and match your product data in your Merchant Center with your online store\u003c/span\u003e\u003c/p\u003e\u003c/li\u003e\u003c/ul\u003e\u003ca href=\"https://support.google.com/merchants/answer/6150127?hl=en-US\" class=\"content-element\"\u003eLearn more about the Misrepresentation policy\u003c/a\u003e\u003c/div\u003e\u003c/div\u003e", "actions": [ { "externalAction": { "type": "REVIEW_ACCOUNT_ISSUE_IN_MERCHANT_CENTER", "uri": "https://merchants.google.com/mc/products/diagnostics/accountissues?a=672911686&hl=en-US" }, "buttonLabel": "Request review", "isAvailable": true } ] }, { "title": "Adult-oriented content", "impact": { "message": "Prevents all products from showing in all countries", "severity": "ERROR", "breakdowns": [ { "regions": [ { "code": "001", "name": "All countries" } ], "details": [ "Products not showing organically" ] } ] }, "prerenderedContent": "\u003cdiv class=\"issue-detail\"\u003e\u003cdiv class=\"callout-banners\"\u003e\u003cdiv class=\"callout-banner callout-banner-info\"\u003e\u003cp\u003e\u003cspan class=\"segment\"\u003eReview requested on Aug 9, 2023. It can take a few days to complete.u003c/span\u003e\u003c/p\u003e\u003c/div\u003e\u003c/div\u003e\u003cdiv class=\"issue-content\"\u003e\u003cp class=\"content-element\"\u003e\u003cspan class=\"segment\"\u003eThere was a problem identified with the sale of prohibited adult products on your online store. In the case that you are intentionally selling adult items, enable Adult content in Settings in your Merchant Center. In your product file, use the \u003c/span\u003e\u003cspan class=\"segment segment-attribute\"\u003eadult\u003c/span\u003e\u003cspan class=\"segment\"\u003e attribute for specific products.u003c/span\u003e\u003c/p\u003e\u003cp class=\"content-element root-causes-intro\"\u003e\u003cspan class=\"segment\"\u003eMake sure the products meet the policy requirements\u003c/span\u003e\u003c/p\u003e\u003cul class=\"content-element root-causes\"\u003e\u003cli\u003e\u003cp class=\"tooltip tooltip-style-info\"\u003e\u003cspan class=\"segment\"\u003eAdult oriented content may be prohibited or restricted depending on the product sold and the country it is sold\u003c/span\u003e\u003cspan class=\"tooltip-icon\"\u003e\u003cbr\u003e\u003c/span\u003e\u003cspan class=\"tooltip-text\"\u003e\u003cspan class=\"segment\"\u003eSee a full list of countries in the HelpCenter\u003c/span\u003e\u003c/span\u003e\u003c/p\u003e\u003c/li\u003e\u003cli\u003e\u003cp class=\"tooltip tooltip-style-info\"\u003e\u003cspan class=\"segment\"\u003eDon't list sexually explicit content that is intended to arouse or includes content such as text, image, audio, or video of graphic sexual acts intended to arouse\u003c/span\u003e\u003cspan class=\"tooltip-icon\"\u003e\u003cbr\u003e\u003c/span\u003e\u003cspan class=\"tooltip-text\"\u003e\u003cspan class=\"segment\"\u003eExamples: Graphic depictions of sexual acts in progress, including hardcore pornography, any type of genital, anal, or oral sexual activity; graphic depictions of masturbation or genital arousal and language explicitly referencing arousal, masturbation, cartoon porn, or hentai\u003c/span\u003e\u003c/span\u003e\u003c/p\u003e\u003c/li\u003e\u003c/ul\u003e\u003ca href=\"https://support.google.com/merchants/answer/6150138?hl=en-US#wycd-restricted-adult-content\" class=\"content-element\"\u003eLearn more about the Adult-oriented content policy\u003c/a\u003e\u003c/div\u003e\u003c/div\u003e" }, { "title": "Missing return and refund policy", "impact": { "message": "Limits visibility of all products in all countries", "severity": "ERROR", "breakdowns": [ { "regions": [ { "code": "001", "name": "All countries" } ], "details": [ "Limited visibility for products showing organically" ] } ] }, "prerenderedContent": "\u003cdiv class=\"issue-detail\"\u003e\u003cdiv class=\"issue-content\"\u003e\u003cp class=\"content-element\"\u003e\u003cspan class=\"segment\"\u003eThere was a problem identified with the return and/or refund policy of your online store. Update your return or refund policy to provide customers a transparent shopping experience.u003c/span\u003e\u003c/p\u003e\u003cp class=\"content-element root-causes-intro\"\u003e\u003cspan class=\"segment\"\u003eMake sure your products meet the Shopping policy requirements\u003c/span\u003e\u003c/p\u003e\u003cul class=\"content-element root-causes\"\u003e\u003cli\u003e\u003cp class=\"tooltip tooltip-style-info\"\u003e\u003cspan class=\"segment\"\u003eIt's available on your online store\u003c/span\u003e\u003cspan class=\"tooltip-icon\"\u003e\u003cbr\u003e\u003c/span\u003e\u003cspan class=\"tooltip-text\"\u003e\u003cspan class=\"segment\"\u003eWe recommend that you have a separate landing page for your policy and link to it from the other pages on your online store, so that it's easy to find.u003c/span\u003e\u003c/span\u003e\u003c/p\u003e\u003c/li\u003e\u003cli\u003e\u003cp class=\"tooltip tooltip-style-info\"\u003e\u003cspan class=\"segment\"\u003eIt's available in the language of the country you're selling in or in English\u003c/span\u003e\u003cspan class=\"tooltip-icon\"\u003e\u003cbr\u003e\u003c/span\u003e\u003cspan class=\"tooltip-text\"\u003e\u003cspan class=\"segment\"\u003eMake sure that the return and/or refund policy is available in the target language or in English. Ideally, users should be given the option to select the return and/or refund policy in their own language.u003c/span\u003e\u003c/span\u003e\u003c/p\u003e\u003c/li\u003e\u003cli\u003e\u003cp\u003e\u003cspan class=\"segment\"\u003eIt's accessible to everyone visiting your online store, without having to log in, sign up or enter any personal information\u003c/span\u003e\u003c/p\u003e\u003c/li\u003e\u003c/ul\u003e\u003ca href=\"https://support.google.com/merchants/answer/9158778?hl=en-US\" class=\"content-element\"\u003eLearn more about Missing return and refund policy\u003c/a\u003e\u003c/div\u003e\u003c/div\u003e", "actions": [ { "externalAction": { "type": "REVIEW_ACCOUNT_ISSUE_IN_MERCHANT_CENTER", "uri": "https://merchants.google.com/mc/products/diagnostics/accountissues?a=672911686&hl=en-US" }, "buttonLabel": "Request review", "isAvailable": true } ] } ], "alternateDisputeResolution": { "uri": "https://support.google.com/european-union-digital-services-act-redress-options?hl=en-US", "label": "Additional options available to you" } }
Sorunları döndürüldükleri sırayla görüntülemenizi öneririz.
title
veimpact.message
. Ayrıca, Satıcı sorunun üzerine geldiğinde sorununimpact.breakdowns
kadarı başlık veya açıklama.Satıcı, listedeki bir sorunu tıklar.
Uygulamanızda her bir sorunun ayrıntılı
impact
bilgileri gösteriliyor.country
destination
,prerendered_content
ve düğmeler (satıcının sorunu çözmek için alabileceğiactions
) süre. Her biri 100'den az gösterim alan farklı eylem türleri:- Harici işlemler: Harici sayfanın üzerine gelin (örneğin, Satıcının sorunu çözebileceği Merchant Center.
- Yerleşik basit işlemler: Uygulamanızda, sitenizin Satıcı sorunu çözebilir.
- Yerleşik kullanıcı girişi işlemleri: Satıcının şunları yapabileceği bir iletişim kutusu açın:
gerekli bilgileri sağlayıp işlem yapılmasını isteyebilir. Bu tür
İşlem yalnızca
BUILT_IN_USER_INPUT_ACTIONS
istendi.
Satıcı, sorunu çözmek için talimatları uygular.
Satıcı, uygulamanızdaki teşhis sayfasını yeniden yükler.
Uygulamanız,
MerchantSupport
hizmetine başka bir istek gönderir ve sorunların güncellenmiş bir listesini gösterir.
Tamamlanmış uygulamanızın gösterdiği bilgileri Satıcı'daki teşhis sayfaları Center'ı kullanarak hakkında bilgi edindiniz.
Kullanıcı arayüzü taklitleri
Aşağıda,
Hesap teşhisleri sayfanızda renderaccountissues
yanıt. Nesneler
Kullanıcı arayüzü, modelde karşılık gelen API alanlarıyla eşlenir. Web sitemiz g.co/newsinitiative/labs
üzerinden
sayfasına bakın.
Doldurulan hesap teşhis sayfası aşağıdaki gibi görünür:
Stil önceden oluşturulmuş HTML
MerchantSupport
hizmetinin çağrılmasından gelen yanıtta şu bilgiler yer alır:
prerendered_content
alanında, HTML'deki her bir sorunun ayrıntılarını görebilirsiniz. Şunları yerleştirebilirsiniz:
bunu okunabilir bir
biçimindedir.
new-element
sınıfına sahip HTML öğeleri görebilirsiniz. new-element
sınıfı,
MerchantSupport
hizmetiyle. Öğeleri sınıfla birlikte gizlemenizi öneririz
new-element
, böylece bu öğeleri görüntülenmeden önce biçimlendirebilirsiniz
daha fazla bilgi edineceksiniz.
prerendered_content
alanının değerine ilişkin bir örneği aşağıda bulabilirsiniz:
<div class="issue-detail">
<div class="callout-banners">
<div class="callout-banner callout-banner-info"><p><span class="segment">Review requested on Aug 9, 2023. It can take a few days to complete.</span>
</p></div>
</div>
<div class="issue-content"><p class="content-element"><span class="segment">There was a problem identified with the sale of prohibited adult products on your online store. In the case that you are intentionally selling adult items, enable Adult content in Settings in your Merchant Center. In your product file, use the </span><span
class="segment segment-attribute">adult</span><span class="segment"> attribute for specific products.</span>
</p>
<p class="content-element root-causes-intro"><span class="segment">Make sure the products meet the policy requirements</span>
</p>
<ul class="content-element root-causes">
<li><p class="tooltip tooltip-style-info"><span class="segment">Adult oriented content may be prohibited or restricted depending on the product sold and the country it is sold</span><span
class="tooltip-icon"><br></span><span class="tooltip-text"><span class="segment">See a full list of countries in the HelpCenter</span></span>
</p></li>
<li><p class="tooltip tooltip-style-info"><span class="segment">Don't list sexually explicit content that is intended to arouse or includes content such as text, image, audio, or video of graphic sexual acts intended to arouse</span><span
class="tooltip-icon"><br></span><span class="tooltip-text"><span class="segment">Examples: Graphic depictions of sexual acts in progress, including hardcore pornography, any type of genital, anal, or oral sexual activity; graphic depictions of masturbation or genital arousal and language explicitly referencing arousal, masturbation, cartoon porn, or hentai</span></span>
</p></li>
</ul>
<a href="https://support.google.com/merchants/answer/6150138?hl=en-US#wycd-restricted-adult-content"
class="content-element">Learn more about the Adult-oriented content policy</a></div>
</div>
Önceki HTML kodunu yerleştirdiyseniz aşağıdaki gibi görünür
prerendered_content
:
İçeriğin kullanıcı arayüzünüzde nasıl görüneceğini ayarlamak için birden fazla CSS sınıfı kullanabilirsiniz. Aşağıda, kullanabileceğiniz bir CSS örneği verilmiştir:
issue-detail {
text-align: left;
width: 700px;
border-radius: 8px;
background: white;
margin: 16px;
padding: 16px;
}
.content-element {
margin: 8px 0 8px 0;
display: block;
}
/* callout banners */
.callout-banners {
margin: 0 0 16px 0;
}
.callout-banner {
display: block;
padding: 16px 16px 6px 16px;
margin: 0 0 8px 0;
border-radius: 8px;
}
.callout-banner-info {
background: #e8f0fe;
}
.callout-banner-warning {
background: #fef7e0;
}
.callout-banner-error {
background: #fce8e6;
}
/* add an icon to the callout banner */
.callout-banner p {
background-repeat: no-repeat;
padding-left: 32px;
}
.callout-banner-error p {
background-image: url("https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/error/default/20px.svg");
}
.callout-banner-warning p {
background-image: url("https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/warning/default/20px.svg");
}
.callout-banner-info p {
background-image: url("https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/search/default/20px.svg");
}
/* segments with style */
.segment-attribute {
color: #198639;
font-family: monospace, monospace;
}
.segment-bold {
font-weight: bold;
}
.segment-italic {
font-style: italic;
}
/* tooltip */
.tooltip {
position: relative;
}
.tooltip-style-info .tooltip-icon:before {
content: '(i)';
font-style: normal;
font-weight: normal;
text-decoration: inherit;
margin-left: 5px;
}
.tooltip-style-question .tooltip-icon:before {
content: '(?)';
font-style: normal;
font-weight: normal;
text-decoration: inherit;
margin-left: 5px;
}
.tooltip .tooltip-text {
visibility: hidden;
text-align: left;
background: white;
border-radius: 8px;
padding: 5px 0;
border: 1px solid;
padding: 10px;
box-shadow: 3px 7px 12px #c1c1c1;
position: absolute;
z-index: 1;
}
.tooltip:hover .tooltip-text {
visibility: visible;
}
/* table */
table.content-element {
margin: 16px 0 16px 0;
border: 1px solid #ccc;
border-collapse: collapse;
margin: 1em 0;
}
table.content-element th {
background-color: #eee;
}
table.content-element th, table td {
border: 1px solid #ddd;
font-size: 0.9em;
padding: 0.3em 1em;
}
/* hidde elements added in future, until they are supported in your application */
.new-element {
visibility: hidden;
}
Önceki CSS'yi kullandığınızda oluşturulan içerik aşağıdaki gibi görünür:
Araç ipuçlarını CSS ile de yapılandırabilir ve gösterebilirsiniz:
Kullanıcı girişiyle yerleşik işlemi uygulama
Kullanıcı girişi içeren yerleşik bir işlem, karmaşık bir teşhis işlemi yapmanızı sağlar. özelliğini uygulamanızda uygulama içi çözüm olarak kullanabilirsiniz. Önerilerimiz satıcının görüşlerini bildirebileceği bir iletişim kutusu olarak. bilgileri girin ve isteği onaylayın.
Her işlem bir veya daha fazla işlem akışı içerir. Bazı işlemler için birden fazla akış olabilir. Örneğin, satıcı, karara katılmadığı için ek inceleme istiyor sorunu çözmüş olsalar bile farklı bir akışla karşılaşabilirler.
Kullanıcı girişiyle karmaşık işlemler uygulamak üzere veri isteğinde bulunmak için
user_input_action_option
alanını BUILT_IN_USER_INPUT_ACTIONS
değerine ayarlayın.
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/merchantsupport/renderaccountissues
{
"user_input_action_option": "BUILT_IN_USER_INPUT_ACTIONS"
}
{merchantId} değerini işlemin uygulanmasını tetiklemek istediğiniz hesabı seçin.
Uygulama
Kullanıcı isteğinde bulunan teşhis sayfanızın akışını nasıl öneriyoruz? giriş şöyle görünmelidir:
Satıcı, işlem düğmesini tıklar.
- Birden fazla akış varsa uygulamanız tüm akış seçeneklerini sunar. niyetine bağlı olarak birini seçebilir.
- Akışı satıcı seçer.
Uygulamanızda, seçilen işlem akışı. Bu ayrıntıları iletişim kutusu.
- Açıklama metni (varsa), kullanıcıya yardımcı olmayı amaçlayan önemli bilgiler içeriyor daha iyi anlamasını sağlamak için satıcının bu işleme yardımcı olur. Bu mesajı vurgulamanızı ve biçimlendirmenizi öneririz. şiddetine göre değişir.
- Akışta herhangi bir giriş alanı varsa bunların, değer sunabiliyor. Giriş alanı zorunlu olarak işaretlendiyse Sonra, uygulamanız, satıcının isteği değer katın.
Satıcı bilgileri okur ve istenen değerleri sağlar.
Satıcı, isteğini düğmeyi tıklayarak onaylar.
Uygulamanız, şunu çağırarak işlemin işlenmesini tetikler:
MerchantSupport
hizmeti. Aşağıda örnek bir istek verilmiştir:POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/merchantsupport/triggeraction { actionContext: "ActionContextValue=", actionInput: { actionFlowId: "flow1", inputValues: [ { input_field_id: "input1", checkbox_input_value: { value: true } } ] }
{merchantId} değerini işlemin uygulanmasını tetiklemek istediğiniz hesabı seçin.
BuiltInUserInputAction
içintriggeraction
yöntemine erişmek üzere bunu kullanarak istek gönder formunu doldurun.Uygulamanızda,
MerchantSupport
tarafından döndürülen onay mesajı gösteriliyor geliştirmenizi sağlar.- Hizmet,
INVALID_ARGUMENT
ile doğrulama hatası döndürürse durumu üzerinde çalışıyorsa e-posta, satıcıya gösterilmesi gereken yerelleştirilmiş hata mesajı. Önerilerimiz: bu hatayı etkilenen giriş alanına yakın bir yerde gösterir. Bir örnekle açıklayalım şöyle bir örnek verelim:
{ "error": { "code": 400, "message": "[actionInput.inputValues] Invalid user input", "status": "INVALID_ARGUMENT", "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "reason": "invalid", "domain": "global" }, { "@type": "type.googleapis.com/google.rpc.BadRequest", "fieldViolations": [ { "field": "actionInput.inputValues.input", "description": "The field is required" } ] } ] } }
- Hizmet,
FAILED_PRECONDITION
veINTERNAL
durumları varsa uygulama, satıcıdan sayfayı yeniden yükleyin veya daha sonra deneyin.
- Hizmet,