Bu kılavuzda, üçüncü taraf uygulama geliştiricilerinin satıcıları için bir uygulama içi teşhis sayfası oluşturmak üzere MerchantSupport hizmetini nasıl kullanabileceği açıklanmaktadır.
Bu hizmeti, Merchant Center hesap teşhisi ve ürün sorunları sayfalarına benzer kullanıcı arayüzleri oluşturmak için kullanabilirsiniz.
MerchantSupport hizmeti yalnızca üçüncü taraf kullanıcı arayüzleri için kullanılabilir. Bir satıcı, uygulamanızın kullanıcı arayüzüyle etkileşime geçtiğinde istekler tetiklenmelidir. Kendi satıcı hesabınız için teşhis işlemini otomatikleştirmek isterseniz hesap durumu, ürün durumu ve ürün filtreleme kılavuzlarına göz atın.
Satıcılarınızın sorunları gidermesine yardımcı olmak için uygulamanızda aşağıdaki sayfaları sağlamanızı öneririz:
- Hesap teşhisi
- Ürün teşhisleri
Teşhis sayfasını uygulamak için farklı seçenekler
Teşhis sayfasını farklı şekillerde uygulayabilirsiniz. İhtiyaçlarınıza göre, karmaşık teşhis işlemlerinin nasıl ele alınacağını belirleyen seçeneği belirleyin. İstekte user_input_action_option öğesini aşağıdaki seçeneklerden birine ayarlayabilirsiniz:
REDIRECT_TO_MERCHANT_CENTER: Bu, varsayılan seçenektir. Ek içerik göstermeyi veya satıcıdan ek bilgi almayı gerektiren işlemler, uygulamanızda tam olarak uygulanmamış. API, bu işlemler için Merchant Center'da satıcının işlemi gerçekleştirebileceği ilgili sayfaya yönlendirme yapacak bir bağlantı sağlar.BUILT_IN_USER_INPUT_ACTIONS: Uygulama içi çözüm olarak kullanıcı girişi gerektiren karmaşık işlemleri uygulamanızda kullanabilirsiniz.
Teşhis sayfası uygulayın
Bu bölümde, teşhis sayfasının nasıl uygulanacağı açıklanmaktadır. Karmaşık işlemleri Merchant Center'a yönlendirme olarak işlemek için varsayılan (basit) seçeneğini kullanır.
Uygulama içi işlemlerle daha gelişmiş bir uygulama için aşağıdaki bölümleri inceleyin ve Kullanıcı girişiyle yerleşik işlemi uygulama bölümüne bakın.
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,
MerchantSupporthizmetini ç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 işlenmesini tetiklemek istediğiniz hesabın benzersiz tanımlayıcısıyla değiştirin.
Uygulamanızda, satıcıya gönderilen yanıttaki teşhis bilgileri ve önerilen işlemler gösterilir. 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ı,
titleveimpact.messageile beraber döndürüldükleri sırayla görüntülemenizi öneririz. Satıcı, fareyle sorun başlığının veya açıklamasının üzerine geldiğinde sorununimpact.breakdownsözelliğini göstermenizi de öneririz.Satıcı, listedeki bir sorunu tıklar.
Uygulamanızda, her sorunun ayrıntılı
impactbilgilericountry,destination,prerendered_contentve satıcının sorunu çözmek için yapabileceğiactionsdüğmelerine göre gösteriliyor. Farklı eylem türleri vardır:- Harici işlemler: Satıcının sorunu çözebileceği harici sayfaya (ör. Merchant Center'da) gidin.
- Yerleşik basit işlemler: Uygulamanızda satıcının sorunu çözebileceği sayfaya gidin.
- Yerleşik kullanıcı girişi işlemleri: Satıcının gerekli bilgileri sağlayıp işlem isteğinde bulunabileceği bir iletişim kutusu açın. Bu tür bir işlem yalnızca
BUILT_IN_USER_INPUT_ACTIONSistendiyse gerçekleştirilebilir.
Satıcı, sorunu çözmek için talimatları uygular.
Satıcı, uygulamanızdaki teşhis sayfasını yeniden yükler.
Uygulamanız,
MerchantSupporthizmetine başka bir istek gönderir ve sorunların güncellenmiş bir listesini gösterir.
Tamamlanmış uygulamanız tarafından görüntülenen bilgileri, Merchant Center'daki teşhis sayfaları ile karşılaştırarak uygulamanızı doğrulayabilirsiniz.
Kullanıcı arayüzü taklitleri
Aşağıda, hesap teşhisleri sayfanızda renderaccountissues yanıtındaki bilgileri nasıl görüntüleyebileceğinize dair bir örnek verilmiştir. Kullanıcı arayüzündeki nesneler, modeldeki karşılık gelen API alanlarıyla eşlenir. Ürün sorunları için de
benzer bir sayfa oluşturabilirsiniz.
Doldurulan hesap teşhis sayfası aşağıdaki gibi görünür:
Stil önceden oluşturulmuş HTML
MerchantSupport hizmetinin çağrılmasının yanıtı, HTML'deki her bir sorunun ayrıntılarını içeren prerendered_content alanını içerir. Sorunu okunabilir bir biçimde görüntülemek için bu HTML içeriğini doğrudan kullanıcı arayüzünüze yerleştirebilirsiniz.
new-element sınıfına sahip HTML öğeleri görebilirsiniz. new-element sınıfı, MerchantSupport hizmetiyle entegrasyondan sonra HTML'ye eklenen öğelere uygulanır. Öğeleri uygulamanızda kullanıcılara gösterilmeden önce biçimlendirebilmek için new-element sınıfıyla öğeleri gizlemenizi öneririz.
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 prerendered_content kodunu herhangi bir stil olmadan uygulamanıza yerleştirdiyseniz aşağıdaki gibi görünür:
İç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, uygulamanızda uygulama içi çözüm olarak karmaşık bir teşhis özelliği sağlamanıza olanak tanır. Bu sayfayı satıcının görüşlerini bildirebileceği, ek bilgileri okuyabileceği ve isteği onaylayabileceği bir iletişim kutusu olarak uygulamanızı öneririz.
Her işlem bir veya daha fazla işlem akışı içerir. Bazı eylemler için birden fazla akış olabilir. Örneğin, satıcı karara katılmadığı için ek inceleme istediğinde farklı bir akış, sorunu zaten çözmüş olan farklı bir akış da olabilir.
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 ayarlamanız gerekir.
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 işlenmesini tetiklemek istediğiniz hesabın benzersiz tanımlayıcısıyla değiştirin.
Uygulama
Kullanıcı girişi isteyen teşhis sayfanızın akışını aşağıdaki gibi öneririz:
Satıcı, işlem düğmesini tıklar.
- Uygulamanız birden fazla akış seçeneği sunuyorsa satıcının amaçlarına göre birisini seçebilmesi için uygulamanız bu adımların tümünü sunar.
- Akışı satıcı seçer.
Uygulamanızda, seçilen işlem akışı için başlık, mesaj, açıklama metni ve kullanıcı giriş formu gösteriliyor. Bu ayrıntıları bir iletişim kutusunda görüntülemenizi öneririz.
- Açıklama metni (varsa), satıcının işlemin nasıl işlediğini ve başarılı olmak için ne yapılması gerektiğini daha iyi anlamasına yardımcı olmayı amaçlayan önemli bilgiler içerir. Bu mesajı vurgulamanızı ve açıklama metninin önem derecesine göre şekillendirmenizi öneririz.
- Akışta giriş alanları varsa satıcının değer sağlayabilmesi için bunların gösterilmesi gerekir. Giriş alanı zorunlu olarak işaretlenmişse uygulamanız, değeri sağlamadan satıcının isteği göndermesine izin vermemelidir.
Satıcı bilgileri okur ve istenen değerleri sağlar.
Satıcı, isteğini düğmeyi tıklayarak onaylar.
Uygulamanız,
MerchantSupporthizmetini çağırarak işlemin işlenmesini tetikler. 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 işlenmesini tetiklemek istediğiniz hesabın benzersiz tanımlayıcısıyla değiştirin.
BuiltInUserInputActioniçintriggeractionyöntemine erişmek için bu formu kullanarak bir istek gönderin.Uygulamanızda,
MerchantSupporthizmetinden döndürülen onay mesajı gösteriliyor.- Hizmet,
INVALID_ARGUMENTdurumuyla ilgili bir doğrulama hatası döndürüyorsa satıcıya gösterilmesi gereken ayrıntılı bilgileri ve yerelleştirilmiş hata mesajını içerir. Böyle bir hatayı, etkilenen giriş alanına yakın bir yerde göstermenizi öneririz. Aşağıda örnek bir yanıt örneği verilmiştir:
{ "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_PRECONDITIONveINTERNALdurumlarıyla belirtilen geçersiz durum veya dahili hata döndürürse uygulama, satıcıya sayfayı yeniden yüklemesi veya daha sonra denemesi talimatı vermelidir.
- Hizmet,