Este guia do desenvolvedor descreve como avaliar as interações em redes sociais com o SDK v4 do Google Analytics para Android.
Visão geral
A avaliação de interações em redes sociais permite que você avalie as interações de um usuário com vários widgets de compartilhamento e recomendação de redes sociais incorporados ao seu conteúdo.
As interações em redes sociais têm estes campos:
Nome do campo |
Tipo |
Obrigatório |
Descrição |
Social Network |
String |
Sim |
A rede social com a qual o usuário está interagindo (por exemplo, Facebook, Google+, Twitter etc.). |
Social Action |
String |
Sim |
A atividade em redes sociais feita (por exemplo, curtir, compartilhar, clicar no botão +1 etc.). |
Social Target |
String |
Não |
O conteúdo em que a atividade em redes sociais está sendo realizada (por exemplo, um artigo ou vídeo específico). |
Os dados de interações em redes sociais coletados pelo SDK do Google Analytics para Android v4 estão disponíveis por meio de relatórios personalizados e da API de relatórios principais.
Implementação
Para enviar uma interação em redes sociais ao Google Analytics, use SocialBuilder
como neste exemplo:
// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
TrackerName.APP_TRACKER);
// Build and send social interaction.
t.send(new HitBuilders.SocialBuilder()
.setNetwork(getSocialNetwork())
.setAction(getSocialAction())
.setTarget(getSocialTarget())
.build());
Consulte Configuração avançada para ver detalhes sobre o método getTracker
.
Veja um snippet de código do aplicativo de exemplo
O snippet a seguir é um Fragment
de exemplo que envia uma interação social:
package com.google.android.apps.mobileplayground;
import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.View.OnClickListener;
import android.view.ViewGroup;
import android.widget.Button;
import android.widget.EditText;
import com.google.android.apps.mobileplayground.AnalyticsSampleApp.TrackerName;
import com.google.android.apps.mobileplayground.MobilePlayground.UserInputException;
import com.google.android.gms.analytics.GoogleAnalytics;
import com.google.android.gms.analytics.HitBuilders;
import com.google.android.gms.analytics.Tracker;
/**
* Class to exercise Social hits.
*/
public class SocialFragment extends Fragment {
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
View view = inflater.inflate(R.layout.social, container, false);
final Button sendButton = (Button) view.findViewById(R.id.socialSend);
sendButton.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
try {
// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
TrackerName.APP_TRACKER);
// Build and send social interaction.
t.send(new HitBuilders.SocialBuilder()
.setNetwork(getSocialNetwork())
.setAction(getSocialAction())
.setTarget(getSocialTarget())
.build());
} catch (UserInputException e) {
e.printStackTrace();
}
}
});
final Button dispatchButton = (Button) view.findViewById(R.id.socialDispatch);
dispatchButton.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
// Manually start a dispatch (Unnecessary if the tracker has a dispatch interval)
GoogleAnalytics.getInstance(getActivity().getBaseContext()).dispatchLocalHits();
}
});
return view;
}
private String getSocialNetwork() throws UserInputException {
String result =
((EditText) getView().findViewById(R.id.editSocialNetwork)).getText().toString().trim();
if (result.length() == 0) {
throw new UserInputException(getString(R.string.socialNetworkWarning));
}
return result;
}
private String getSocialAction() throws UserInputException {
String result =
((EditText) getView().findViewById(R.id.editSocialAction)).getText().toString().trim();
if (result.length() == 0) {
throw new UserInputException(getString(R.string.socialActionWarning));
}
return result;
}
private String getSocialTarget() {
return ((EditText) getView().findViewById(R.id.editSocialTarget)).getText().toString().trim();
}
}